> For the complete documentation index, see [llms.txt](https://xgro.gitbook.io/xgro-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xgro.gitbook.io/xgro-docs/how-xgro-cart-progress-bar-works.md).

# How XGro Cart Progress Bar Works

#### **Overview**

XGro Cart Progress Bar is a Shopify app that enables merchants to add a customizable cart progress bar to their store. With XGro Cart Progress Bar, merchants can set up goals and corresponding rewards — such as free shipping — and style the progress bar widget to match their store's theme and brand. Once published, the widget appears in the cart whenever a customer adds items, showing real-time progress toward the configured goals. This encourages customers to add more items and complete checkout, helping merchants increase AOV, add-to-cart rate, and overall order revenue.

After installing XGro Cart Progress Bar, follow the steps below to configure and publish your progress bar widget.

***

#### **Step 1: Enable the progress bar widget**

The XGro Cart Progress Bar widget is embedded directly into your store theme via the theme editor. Before publishing, you'll need to enable the app embed first.

To enable the app embed, go to your Shopify admin → **Online Store > Themes > Customize**, then toggle on the app embed for XGro Cart Progress Bar.

For detailed setup steps, refer to:

{% content-ref url="/pages/9F1bcxg45pxrDHkI7UhF" %}
[How to Enable App Embed](/xgro-docs/how-to-enable-app-embed.md)
{% endcontent-ref %}

***

#### **Step 2: Configure goals and widget appearance**

XGro Cart Progress Bar gives you full control over how your progress bar looks — including bar style, colors, copy, icons, and position.

Most importantly, you can define your progress goals: the cart value thresholds customers need to reach in order to unlock a reward. Currently, free shipping is currently the only supported reward type. Support for discounts, gift cards, and physical gifts is on the roadmap and will be rolled out in future updates.

Once you've finished configuring your goals and widget appearance, you're ready to publish the widget to your store.

For detailed setup steps, refer to:

{% content-ref url="/pages/R6qXMz8xRPUFuxr3i82s" %}
[How to Set Up Free Shipping Goal](/xgro-docs/how-to-set-up-free-shipping-goal.md)
{% endcontent-ref %}

{% content-ref url="/pages/ehFeUXm05f2eGhZ9nS1v" %}
[How to Set Up Progress Bar Widget on The Cart Page and Cart Drawer](/xgro-docs/how-to-set-up-progress-bar-widget-on-the-cart-page-and-cart-drawer.md)
{% endcontent-ref %}

***

#### **Step 3: Customers add items to their cart**

After the widget is published, it will appear in both the cart page and cart drawer whenever a customer adds an item to their cart. The widget displays real-time progress and lets customers know exactly how much more they need to spend to unlock their reward — nudging them toward higher-value orders.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://xgro.gitbook.io/xgro-docs/how-xgro-cart-progress-bar-works.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.