This article outlines the key fields and configuration options available when setting up a promotion, including promotion details, actions, and filters in the Operator portal.
To create a promotion, you can either click New Promotion from the Promotions dashboard or go to Marketing > Promotions > Create New Promotion from the sidebar.
Promotion Details
This table lists the fields the operator must complete to define the basic details of the promotion.
| FIELD | DESCRIPTION |
| Name | Used in the discount line item at checkout. Keep it short and clear. |
| Start / End Dates |
(Optional) Defines when the promotion starts and ends. Leave blank to activate immediately. Example: Use 29/12/2025 to end at 11:59:59 PM on that day. |
| Teaser | Optional. Displays as a banner on product pages. If multiple promotions apply, teaser texts are separated by a `. |
| Description | (Optional) For internal use only. Shown in the “All Promotions” list (max ~70 characters). |
| URL | (Optional) The teaser banner can link to a relative or absolute URL (e.g. /s/sports-cars or https://example.com). |
| Suspend Promotion | Temporarily disables the promotion without deleting it. |
| Cost Borne by Marketplace | Allows the operator to fund part or all of the discount. Determines seller payout through the remittance process. |
Actions
At least one action must be defined.
Note: If no action is set, filters will not apply and the promotion will not work.
| ACTION TYPE | OPTIONS/DESCRIPTION |
| Discount |
|
| Fixed Price | Sets a specific price per unit for eligible products. |
| Free Shipping |
|
| Bonus Item | Enter a single Ad ID with no variants.Example: a bag (allowed)Not allowed: items with sizes or colors (e.g. shirts) |
| Buy One, Get One Free | Buyer receives a free item after buying a defined quantity. The free item matches the same variant (e.g. same size or color). |
Filters
Filters define which products the promotion applies to. If a filter is enabled, it must include at least one value.
| FILTER TYPE | DESCRIPTION |
| Amount Spent | Applies the promotion when the cart total reaches the specified threshold. |
| Limit to Brands / Exclude Brands | Include or exclude specific brands. |
| Limit to Categories / Exclude Categories | Include or exclude product categories. |
| Limit to Ads / Exclude Ads | Target or exclude specific product adverts. |
| Limit to Variants / Exclude Variants | Target or exclude individual product variants. |
| Restrict to Loyalty Program Members | Make the promotion available only to loyalty members. |
| Linked Promotion | Trigger a promotion based on another promotion present in the same cart. |
| Exclude Sale Items | Prevent the promotion from applying to products already on sale. |
Notes:
- A promotion must have at least one action to be valid.
- If a filter is enabled, at least one value must be set. Empty filters will block saving the promotion.
Related articles