Kai Progress bar & Free Gift · Help guide

How to set up Kai

Kai shows shoppers a progress bar like “You're $12 away from free shipping”. When their cart reaches a goal, the reward is applied at checkout on its own. Setting it up takes about ten minutes.

You're $12.00 away from free shipping

Free shipping · $50Free gift · $8015% off · $120

1. Turn Kai on in your theme

Kai needs its app embed switched on before anything shows in your store. You only do this once.

  1. In your Shopify admin, go to Online Store → Themes and click Customize.
  2. Click the App embeds icon in the left sidebar.
  3. Switch on Kai, then click Save.

Kai's home page has a button that opens this screen for you. If you change your theme later, switch the embed on in the new theme too.

2. Create a campaign

A campaign is one offer with one or more goals, called tiers. For example: free shipping at $50, a free gift at $80 and 15% off at $120.

  1. Open Kai and click Create Campaign. Give it a name only you will see.
  2. Under Discount Tiers based on, pick how progress is counted:
    • Value: the cart total, like “spend $50”.
    • Quantity: the number of items, like “buy 3”.
  3. For each tier, enter the goal and choose a reward. Click Add New Tier for the next goal.
  4. Choose which products count: all products, or only some products and collections. You can also exclude products.

Rewards you can give

RewardWhat the shopper gets
PercentageA percentage off the order, such as 10% off.
AmountA fixed amount off, such as $5 off.
Free ShippingFree shipping on the order.
Free GiftA product you choose, added to the cart for free.
BOGO, BXGY offerBuy some, get some free or discounted. Only with Quantity goals.

You can mix rewards in one campaign, like free shipping first and a gift at the next tier.

3. Choose where the bar shows

Open the Design tab and switch on the places you want. You can use several at once.

SettingWhere it appears
Page HeaderA bar across the top of every page.
Announcement BarA text-only message bar at the top of the page.
Product PageUnder the Add to cart button on product pages.
Cart Drawer and Cart PageInside your cart, where shoppers decide whether to add more.
Sticky Progress BarFixed to the bottom of the screen while shoppers scroll.
Sticky Announcement BarA text bar that stays visible while shoppers scroll.
Custom Progress Bar / Custom Text BarAnywhere you like: in the theme editor, add the Progress bar App section where you want it.

For each place, pick a template and set the colours and fonts to match your store. The preview on the right updates as you go.

4. Write the bar text

Each tier has two messages: one while the shopper is still working towards it, and one when they reach it. Kai fills in the numbers for you with these tags:

TagBecomes
{Trigger - Current}How much more they need to spend or add, like “$12.00” or “2”.
{Value}The reward, like “10% off” or “Free Shipping”.

You write: Spend {Trigger - Current} more to get {Value}
Shoppers see: Spend $12.00 more to get Free Shipping

5. Preview and publish

  1. Open the Preview tab to see the bar at different cart amounts.
  2. Click Publish Campaign to make it live. To keep working on it later, click Save Draft instead.
  3. Visit your store and add a product to the cart to see it in action.

You can pause or edit a campaign at any time from the campaign list. Changes show in your store within a few seconds.

How free gifts work

  • When the cart reaches a gift tier, Kai adds the gift to the cart for free.
  • If you offer more than one gift, shoppers pick theirs in a pop-up.
  • If the cart drops below the goal again, the gift is taken out.
  • Gifts that are out of stock aren't offered. Keep some stock on gift products.

Advanced options

Everything here is optional. You'll find it in the Advanced Options tab.

Schedule
Set a start and end date, for a weekend sale for example. Kai turns the campaign on and off for you.
Markets
Use different goals for each market, such as €45 in Europe and $50 in the US.
Customers
Show the campaign only to certain customers, for example by tag. Needs the Pro plan.
Shipping methods
Make only some shipping methods free, like Standard free and Express full price. Needs the Pro plan.
Combine with other discounts
Choose whether Kai's rewards can be used together with your other discount codes and offers.

Other languages

If your store sells in more than one language, open the Translations tab and add the bar text for each language. Shoppers see the bar in the language they're browsing in.

Something not working?

The bar doesn't show in my store

Check that the Kai app embed is on and saved in your live theme (step 1), that the campaign is published and not paused, and that at least one place is switched on in the Design tab. If you picked certain products, the bar only shows for those.

The discount isn't applied at checkout

Make sure the cart really reaches the goal with the products you included. If the shopper also uses another discount code, check Combine with other discounts in Advanced Options.

The free gift isn't added

Check that the gift product is in stock and available on your online store. If you offer several gifts, the shopper chooses one in the pop-up first.

The bar shows the wrong amount

Kai counts the products you included in the campaign. Excluded products and free gifts don't count towards the goal.

Get help

Stuck, or want us to set it up for you? Write to us and a real person will reply, usually the same day.

ecomscalix@gmail.com

Last updated November 5, 2026