Getting started
Create and fully configure a rule in EG.
In the side panel, find the Test mode section (marked Merchant only).
Tick Enable test mode.
Save the rule. Saving a rule with test mode enabled automatically sets it to paused — the two states are mutually exclusive.
Click Generate test link and copy the URL.
Open your storefront via that link. Test mode stays active for the rest of that browser session, or until the link expires.
Run through whatever you want to verify, for example:
the rule fires at the correct threshold,
its reverse behaviour (if configured),
popups, notifications, banners and reminder banners look and behave as intended.
Going live
When you're happy:
Untick Enable test mode.
Save the rule.
Activate the rule. You can't activate a rule while test mode is still enabled. EG will reject the change with a message asking you to uncheck test mode, save, and then activate.
About the test link
It expires after 24 hours.
It's encrypted and intended for admin use only. Don't share it with customers. Anyone who opens it within the 24-hour window will see the rule run in their own browser session.
Generating a new link invalidates the previous one. Only the most recently generated link for a given rule is valid at any time.
The link points to your
myshopify.comdomain. If you normally browse your store on a custom domain, use the link as-is rather than swapping the domain — theegtesttoken must reach the storefront on the URL EG generated.
Caveats
Shopify discounts aren't supported. Test mode is unavailable for rules whose action uses a Shopify automatic discount or a Shopify discount code, because Shopify applies those discounts to every qualifying item in the cart regardless of whether EG added the gift or the customer did — so a "test only" preview isn't possible.
Magic-link targeting isn't supported. Rules targeted via a magic link already have their own per-visitor access model; the test-mode checkbox is disabled for these rules, and switching targeting to magic link will turn test mode off automatically.
Scheduled rules must be tested inside their schedule window. When a rule is on a schedule, EG pins the underlying Shopify discount's start and end dates to
schedule.starts/schedule.ends. The storefront UI (popups, notifications, banners, gifts being added to the cart) will still appear via the test link outside that window — but the discount itself is inactive at Shopify, so the gift won't actually be discounted at checkout. Either move the schedule to cover the time you're testing in, or disable the schedule for the duration of the test.
