This documentation explains how to create a promotion rule that automatically adds a free product to the cart when certain conditions are met. This type of rule is commonly used for gift-based promotions.
Prerequisites #
Before creating the rule, make sure to:
- Set the gift product as “Not Visible Individually” so it cannot be purchased directly by customers.
- Fill in all required product fields and ensure the product has available stock.


Step-by-Step Guide #
Accessing the Promotion Rule Section #
In the side menu, go to Promotions > Cart Price Rules.

Click the Create Rule button located at the top right to begin configuration

Defining the Rule #
Complete the following fields in the Rule Information section:
- Rule Name: Enter a clear and descriptive name for internal reference.
- Websites / Store Views: Select all applicable options.
- Status: Set to Active.
- Customer Groups: Select all groups.
- Coupon: Choose No Coupon.
- Uses per Customer: Enter 0 (for unlimited usage per customer).
- Validity Period: Set the start and end dates for the rule.
- Priority: Leave as 0.
- System Rule: Set to No.

Defining Conditions #
In the Conditions section, set the criteria under which the promotion will apply.
Some examples of conditions include:
- Specific SKUs, categories, or product attributes
- Shipping method used
- Cart total value or quantity of items in the cart
These conditions help determine when the free gift should be added.

Action Settings #
In the Actions section, configure the rule as follows:
- Apply: Select Add Promotional Items Automatically with Products.
- Number of Items for Gifts: Enter 1.
- Type: Choose All SKUs.
- Promotional Items: Enter the SKU of the product to be given as a gift.
- Maximum Discount per Applied Quantity: Enter 1 (limits the gift to one per cart, regardless of how many qualifying items are added).
- Automatically Add Simple Product Without Confirmation: Set to Yes.
- Promotional Item Pricing: Set the minimum price to $0.01 and leave shipping settings as default.

If you have any questions or need more specific configurations, please open a ticket on the support panel. We are always available to help.