Restrictions let you prevent unintended gift distributions, such as gifts being distributed when conditions are not met, or gifts being distributed in excess.
Each of the two rules can be toggled on/off independently. Each rule allows you to set an error message (default or custom) to display to customers.
Rule | When It Triggers |
|---|---|
Limit distribution of gifts that do not meet conditions | Checkout page only |
Limit gift quantity to allowed quantity | When cart quantity changes / Checkout page |
If a gift product is in the cart when the distribution conditions are not met, an error is shown at checkout to block the purchase.
An error is shown in any of the following cases:
The gift campaign's eligibility conditions are not met
The current time is outside the campaign's active dates
The gift product was added directly to the cart outside of the app (missing the
_ItemType: giftattribute)
Default error message:
"Your cart contains gift items that do not meet the campaign conditions. Please check the campaign details."
This rule only activates on the checkout page. Gifts in the cart that don't meet conditions will not be blocked on the cart page.
An error is shown when the gift quantity in the cart exceeds the allowed quantity.
Allowed quantity by type:
Type | Allowed Quantity |
|---|---|
Simple gift | Up to 1 |
Choice gift | Up to the number of selectable variants |
Repeatable gift | Up to the quantity calculated from the repeat criteria and cart contents (or the maximum gift quantity if set) |
Default error message:
"The gift quantity in your cart exceeds the allowed quantity. Please reduce the quantity."
When eligible products are removed from the cart page, the gift quantity may temporarily exceed the limit. In this case, only the maximum gift quantity is checked on the cart page, and the exact quantity check is performed on the checkout page.
This rule activates on both cart quantity changes and the checkout page.
Setting | Description |
|---|---|
Default message | The standard message provided by the app is displayed. |
Custom message | Enter any custom message. Useful for adapting the wording to your store's language. |
Checkout rule limit: Shopify allows a maximum of 25 checkout rules to be active at a time. If this limit is reached, the campaign cannot be activated.
Rules are independent: The two rules can each be toggled on/off independently.
Protection against unauthorized cart additions: If a gift product is added directly to the cart outside of the app (missing the
_ItemType: giftattribute), the "Limit distribution of gifts that do not meet conditions" rule will block the purchase at checkout.