Promotion Codes
Promotion Codes are a form of applying a promotion on the Basket or during Checkout. Code-based promotions require customers to enter a specific code - similar to a voucher or coupon - allowing for greater control and exclusivity. Currently only Automatic Discount types of promotions can be applied with a Code
Promotions codes can be applied in the Storefront in 2 ways:
- Entering the promotion code in the basket ➜ requires custom implementation
- Entering the promotion code in the checkout ➜ talk to your SCAYLE Account Manager to activate this feature.
Setting Promotion Codes up via SCAYLE Panel
In the SCAYLE Panel navigate to Shops and select the shop you want to create a Promotion code for. On the left hand side menu select Promotion ➜ Promotion code.
Here you will be able to see a list of existing Promotion codes, manage them and create new Promotion codes.
Create a new Promotion code
- Select the Shop where you want to create your promotion and go to Promotions ➜ Promotion Code
- Click the + New Promotion Code button.
General Information:
- In the Name field, type a name for the promotion.
- In the Display Name field, type the name of the promotion that will be shown to the customer during the Checkout Process as this information can also be used on E-mail templates and Invoices.
- Start date: enter the date and time when the promotion starts running.
- End date: enter the date and time when the promotion becomes inactive.
- Usage Limitation: Set the limitation for the promotion to unlimited or limited.
- Allow promotions to be combined with other promotions on the basket or basket items. For details see Multiple Promotions on Item Level
Reduction & Order Amount:
- Set what Reduction Type and Amount the customer should get:
- Percentage: a percentage discount will be applied to all items where the code applies to
- Amount: a discount amount will be applied to all items where the code applies to
- Select the possibility to apply the discount proportionally to all items that are involved in the promotion. Example: in case there is a promotion of buy 2 T-shirts and get the 3rd one for free, the discount amount can be distributed proportionally amongst the 3 items
- Set the Minimum Order Amount a customer must meet for the promotion to apply.
- Set the Maximum Order Amount a customer can meet for the promotion to apply.

Code Setting
- Choose how the promotion code is created:
- Generated: The system automatically generates a unique code. Enter the Code prefix and set the number of codes you want to generate.
- Custom: Manually enter your own promotion code customer needs to use.
Set the code name and define a usage limitation per customer if desired
- Individual Code Usage Limitation: define how often the promotion code can be used
- Unlimited : The code can be used any number of times.
- Limited: Restrict how many times this code may be redeemed.

Code Setting
Criteria Settings
- Click + Add criterion to include additional conditions (e.g., attribute group, item condition, product filters) that define when the promotion should apply.

Add criterion
Promotion Design
- Enable optional customization for how the promotion is displayed in the storefront:
- Toggle the switch to activate design customization.
- Once enabled, you can adjust promotional design specific to your storefront.

Save or Cancel
- Save: Apply all configuration changes.
- Cancel: Exit without saving your changes.
To add a list of promotion codes in bulk, we recommend using the designated Admin API endpoint.
Export Promotion Code
The Promotion Code Export feature allows users to extract and download promotion codes from the system for reporting, analysis, or distribution purposes.
Prerequisites
Before exporting promotion codes, ensure the following:
- You have an active user account with export permission.
- The promotion codes to be exported exist in the system.
Exporting Promotion Codes
- Go to Promotions ➜ Promotion Code.
- Open the Promotion Code where you want to export the codes from
- Click on the 3 vertical dots besides Edit ➜ Export
- The export request will be initiated and might take some time to be generated.
- Once Export is finished, you can refresh the page to download the codes.
Edit a Promotion code
- Select the Shop where you want to edit your promotion and go to Promotions ➜ Promotion Code.
- Click the Edit button.
- Note from here you can update the same template you used to create it OR
- Deactivate the promotion, for this click on the 3 vertical dots besides Edit and select Deactivate
Hint: On the right side you can see a nifty summary of all your promotion is doing!
- Hit save
Delete a Promotion code
- Select the Shop where you want to edit your promotion and go to Promotions ➜ Promotion Code
- Click on the 3 vertical dots besides Edit ➜ Delete
- Confirm on pop up