# Progress Bar type

## 1. **General Section**

* **Name:** Name of the rule. It will be visible to customers when they are eligible for free gifts, displayed as discount name associated with the gifts.
* **Status:** Set the rule to *active* or *inactive* whether you want to make the rule work on your frontend.

<figure><img src="https://2782088585-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyTxhG4dtLtoZ8LGb73m7%2Fuploads%2FE9juP61JBLvoAaOQ76pG%2Fimage.png?alt=media&#x26;token=cb1b1192-3e12-40b5-976d-8c9f58da4fae" alt=""><figcaption><p>Click the "Deactivate" button to set the offer status to inactive</p></figcaption></figure>

## **2. Reward claim Section**

* **Give rewards for:** Choose to either give the latest reward or give all rewards through all milestones to the eligible customers.
  * **All milestones:** Customers will receive all rewards for each milestone they achieve.

    > *For example:* If your customers reach three milestones you set, they will be able to claim all three rewards set for each goal.
  * **Only the latest milestone:** Customers are able to receive only the last milestone's rewards if they cross multiple milestones in the end.

    > *For example:* If your customers cross 2 out of 3 milestones you set, they will only be able to collect the rewards from the second milestone.&#x20;
* **Automatically add rewards:** The reward will be added to cart automatically when the milestone conditions are met.
* **Automatically remove free gift:** The reward is auto removed from cart if the milestone is not reached.

<figure><img src="https://2782088585-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyTxhG4dtLtoZ8LGb73m7%2Fuploads%2FPCSvOselGZfq9OZG71yf%2Fimage.png?alt=media&#x26;token=df58c599-1fc6-432e-91c5-782e6a134604" alt=""><figcaption></figcaption></figure>

## **3. Tiers settings Section**

Set up the conditions for each milestone so customers can receive a free gift when they reach a specific milestone (You can add up to 6 millstones in each rule).

* **Spend goal:** The total value of products that customers need to purchase (add to their cart) to qualify for the corresponding reward.
* **Reward type:** Choose one of the three reward types to offer your customers when they reach a milestone.
  * **Free gift:** Customers receive free gifts whenever they reach a milestone.

    * In cases where there are multiple free gift products, you can enter the quantity you want customers to receive for each gift in the blank field next to it. If you leave the field empty, the default value will be set to 1.
    * **Number of gifts customers can select:** The total number of gifts a customer can receive upon reaching a spending milestone.

    <figure><img src="https://2782088585-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyTxhG4dtLtoZ8LGb73m7%2Fuploads%2FnSXr3U0D4FFS4wSlcfo1%2Fimage.png?alt=media&#x26;token=02cf66d1-9feb-4d65-942f-519c25a7da97" alt=""><figcaption></figcaption></figure>
  * **Cart discount:** Customers will receive a partial (or full) discount on their cart value when they reach a specific spending threshold.

    * **Discount type:** Set up the discount based on percentage or fixed amount.
    * **Discount value:** Calculated based on the percentage or an amount in your store currency. You can enter a decimal value, up to the second decimal place.

    <figure><img src="https://2782088585-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyTxhG4dtLtoZ8LGb73m7%2Fuploads%2F9oViSUOJ6H6Oyb2sVd5u%2Fimage.png?alt=media&#x26;token=3fa07e9a-d56c-42c4-9714-dab277d34c55" alt=""><figcaption></figcaption></figure>
  * **Shipping discount:** Customers will receive a partial (or full) discount on their shipping fee when they reach a specific spending threshold.

    * **Discount type:** Set up the discount based on percentage or fixed amount.
    * **Discount value:** Calculated based on the percentage or an amount in your store currency. You can enter a decimal value, up to the second decimal place.
    * **Set maximum discount value:** Tick this box to set up a maximum value to limit the total discount your customers can get.
    * **Select applied locations:** Limit those countries/regions (include or exclude provinces) eligible for the shipping discount. If this box is not checked, the reward will apply to all countries.
    * **Restrict to specific shipping methods:** Include/Exclude those shipping methods that can be applied to the shipping discount or blocked from it. <br>

    <figure><img src="https://2782088585-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyTxhG4dtLtoZ8LGb73m7%2Fuploads%2F1KOhVEUTvYV0t9KV33O0%2Fimage.png?alt=media&#x26;token=8f87b700-fc7a-44be-829d-75c20f091e1e" alt=""><figcaption></figcaption></figure>

## **4. Rule trigger Section**

Choose those products you want to apply the campaign to, among these options:

* **All Products:** Customers must spend at least a specific amount on products in the store to receive the reward.
* **Specific Products:** Customers must spend at least a specific amount on selected products to receive the rewards.
* **Specific Collections:** Customers must spend at least a specific amount on products in selected collections to receive the reward.

<figure><img src="https://2782088585-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyTxhG4dtLtoZ8LGb73m7%2Fuploads%2F6eipIsSnAEdgY9StRnGg%2Fimage.png?alt=media&#x26;token=1a1a1b8f-7ede-497f-b61c-ee8973bbe7ab" alt=""><figcaption></figcaption></figure>

## **5. Active dates Section**

Set the start and end (optional) dates for the promotion.

<figure><img src="https://2782088585-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyTxhG4dtLtoZ8LGb73m7%2Fuploads%2F9zF1DRCRbzdB6qii5OGU%2Fimage.png?alt=media&#x26;token=1aef9f8f-6c11-4bff-a24c-6e0d04e701c1" alt=""><figcaption></figcaption></figure>

## **6. Discount** name preview Section

This setting allows you to customize the suffix of the discount code applied on the cart/checkout page once customers meet the required conditions.

The discount generated by the progress bar consists of two parts:

1. **Offer Name** – Represents the promotion type.
2. **Reward Name** – Defines the benefit customers receive.

By default, the reward name appears as **Free Gift, Order Discount, or Free Shipping.** However, you can modify this section to better match your branding, store language, or promotional strategy.

<figure><img src="https://2782088585-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyTxhG4dtLtoZ8LGb73m7%2Fuploads%2FvSn1GyTJ2eVfJ0xBMn31%2Fimage.png?alt=media&#x26;token=b6fc9b61-0c3a-4cb5-9140-fd5ae3430ff7" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Please note that the **suffix is determined by the reward type**, not the milestone you set.&#x20;

You cannot display the Free Gift suffix at the first milestone if your first level offers a Cart Discount or Shipping Discount.

**Example above:** If your first milestone provides a Shipping Discount and the second milestone offers a Free Gift:

* The first discount name will be **Black Friday - Free Delivery**
* The second discount name will be **Black Friday - Mystery Box**
  {% endhint %}

## **7. Preview Section**

Check how the progress bar appears on the storefront.

{% hint style="success" %}
If you want to **customize the layout** of the progress bar block, click the **Edit widget style** to go the Styling section.&#x20;

Similarly, to **change the text** displayed on the block, choose **Edit default text** to redirect to the Translations section.
{% endhint %}

<figure><img src="https://2782088585-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyTxhG4dtLtoZ8LGb73m7%2Fuploads%2FFcbHbRP3VeVnitkQg5Uk%2Fimage.png?alt=media&#x26;token=de5dd1c8-fb0a-450f-8130-e10c2bd0fc5b" alt=""><figcaption></figcaption></figure>

If you're unsure whether your setup is correctly configured to make the offer work on your storefront, you can use the **Analyze** button to verify it\~

<figure><img src="https://2782088585-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyTxhG4dtLtoZ8LGb73m7%2Fuploads%2FJV8xQWTSoGgThzp65L0q%2Fimage.png?alt=media&#x26;token=ff3b0ed9-ccb2-4251-994a-67432c1a55d4" alt=""><figcaption><p>Analyze button</p></figcaption></figure>
