Skip to main content

Understanding the “Change Progress Messages” Option in Triggers

Learn how the “Change progress messages” option works in Trigger-based promotions, what Initial and In Progress messages mean, and how dynamic fields like {goal} and {missing} behave in Automatic Discounts & Upsells.

Updated over 2 weeks ago

What is the “Change progress messages” option?

When creating a Trigger-based promotion (for example, Gift With Purchase based on cart amount), you’ll see the option:

Change the progress messages

This setting allows you to customize the messages customers see while they are working toward unlocking the promotion.

These messages appear inside the promotion widget before checkout.


When Do Progress Messages Appear?

Progress messages only appear when your promotion uses a trigger condition, such as, but not limited to:

  • Total cart amount (money)

  • Product quantity

  • Specific product requirements

If your promotion uses a trigger or cart requirement (from a custom deal), the widget will automatically show a progress state.

If you’re using an Open Discount (no trigger), progress messages will not appear.


Understanding the Two Message States

When “Change progress messages” is enabled, you’ll see two editable fields:

1️⃣ Initial Message

This is shown when the customer has not yet met the trigger condition.

Example default:

Add {goal} to your cart

This represents the starting state of the promotion.


2️⃣ In Progress Message

This is shown when the customer has started progressing toward the goal, but hasn’t unlocked it yet.

Example default:

Add {missing} to your cart

This updates dynamically as the cart value changes.


Available Dynamic Fields

You can use the following variables in your messages:

  • {percent} — percentage completed

  • {goal} — required order value

  • {current} — current cart value

  • {missing} — remaining amount needed to unlock the promotion

Example:

You are {missing} away from unlocking your free gift.


How the Progress Indicator Works

For trigger-based promotions, the widget includes a built-in progress tracker.

Depending on your setup, customers may see states such as:

  • Initial state (before condition is met)

  • In-progress state (actively moving toward the condition)

  • Unlocked state (condition satisfied)

This progress behavior is automatic and reflects the trigger logic.


Important Notes

  • Progress messages only run before checkout.

  • Customers cannot remove or modify an applied benefit at checkout. However, if multiple benefits are unlocked, they may choose a different available benefit before proceeding.

  • The progress tracker, including the numeric indicator (e.g., 1/2, 2/2), is part of the built-in trigger design and cannot be removed at the moment.

  • A feature request has been submitted to explore adding an option to hide the numeric indicator in the future. While we can’t guarantee implementation or provide a timeline, the feedback has been shared with our Product team.

  • If you prefer not to display a progress tracker, consider using an Open Discount instead of a trigger-based setup.

Did this answer your question?