Scripts maken en inschakelen

Je schrijft scripts met de API voor Shopify-scripts. Deze API is een versie van de programmeertaal Ruby, dus ervaring met programmeren in Ruby is een vereiste. Gebruik de Script Editor voor het aanmaken, bewerken, testen en publiceren van scripts.

Shopify Plus

Shopify-scripts en de Script Editor-app zijn alleen beschikbaar voor merchants met een Shopify Plus-abonnement. De Script Editor-app kan niet langer worden gedownload in de Shopify App Store.

Op 28 augustus 2025 worden Shopify-scripts verwijderd en zullen ze niet meer werken. Migreer je bestaande scripts vóór deze datum naar Shopify Functions.

Voordat je een script gaat schrijven, is het belangrijk om de verschillende typen scripts (Line item, Shipping rates en Payment gateways) te bekijken, zodat je weet welke methoden elk type script ondersteunt. Zo kan een script van het type Line item bijvoorbeeld geen methoden van het scripttype Shipping rates gebruiken.

Er kan maar één script per scripttype tegelijk worden gepubliceerd. Je kunt bijvoorbeeld een script voor orderregels en een script voor verzendtarieven publiceren, maar je kunt niet tegelijkertijd twee scripts voor orderregels publiceren.

Ondersteunde kanalen

Bepaal bij het aanmaken (of bewerken) van een script of het alleen zal runnen in je webshop of in je webshop en de volgende apps:

• Gepersonaliseerde apps die zijn gebouwd met de API voor webwinkels, JavaScript Buy SDK's, Mobile Buy SDK (Android en iOS);
• Gepersonaliseerde apps die checkouts genereren;
• Tapcart, Plobal-apps en Vajro-mobiele app-bouwers

Opmerking

Publiceer het script opnieuw voor app-installaties die plaatsvinden na de laatste update van een script, zodat het naar verwachting draait in de context van de nieuwe geïnstalleerde app.

Je kunt voorbeelden van veelgebruikte scripts vinden in de script-templates die zijn opgenomen in de Script Editor. Als je deze templates wilt bekijken, moet je een script maken.

Een script maken

Je kunt als volgt een script maken:

Neem de documentatie over de API voor Shopify-scripts door voor informatie over het schrijven van code voor scripts.

1. Open de Script Editor. De overzichtspagina Scripts bevat een lijst met scripts voor je winkel.
2. Klik op Create script om een nieuw script te maken.

3. Ga als volgt te werk in het dialoogvenster Select script template:

   1. Kies het type script dat je wilt maken.
   2. Kies een voorbeeldtemplate als uitgangspunt of kies Blank template om helemaal zelf een script te schrijven.
   3. Klik op Create script om een script te maken met het type dat je hebt gekozen.

      Tip

      Het type script dat je hier kiest (Line item, Shipping rates of Payment gateways) bepaalt het type van het script en daardoor de methoden die het script kan gebruiken.

4. Voer in het vak Title een naam in voor het script. Gebruik een beschrijvende naam zodat je meteen kunt zien wat het script doet.

5. Klik op Code om de console Ruby source code te openen.

6. Voer de code voor het script in. Gebruik de documentatie van de API voor Shopify-scripts als naslag.

7. Klik op Run script om het script uit te voeren.

8. Als je klaar bent:

   • klik op Save draft om een niet-gepubliceerd concept van het script op te slaan
   • klik op Save and publish om het script te maken en te publiceren

Volgende stappen

Nadat je een script hebt geschreven, moet je het testen en debuggen voordat je het publiceert. Je kunt ook je Liquid-templatebestanden bijwerken, zodat je webwinkel reageert op de wijzigingen die met de scripts worden aangebracht.