# Get Started with UpBar {#doc-title}

By [B2B Gold](/about/#how-we-write) Updated 27 October 2026 [UpBar page](/shopify/upbar/) [UpBar on the Shopify App Store](https://apps.shopify.com/upbar-free-shipping-upsell?utm_source=b2bgold.app&utm_medium=referral&utm_campaign=docs&utm_content=docs/upbar/getting-started&utm_term=docs-header)

## How do I set up UpBar? {#how-do-i-set-up-upbar}

Install UpBar from the Shopify App Store and its Home page opens on a three-step **Setup guide**: turn on the **UpBar** app embed in your theme, set the free shipping goal, flat rate and delivery time shoppers see, and switch on your first placement. UpBar’s other pages open once you complete or dismiss the guide.

1. Under **Enable the app embed in your theme**, click **Activate**. Your theme editor opens on **App embeds** with **UpBar** switched on. Click **Save** in the theme editor, then go back to UpBar.
2. Under **Set your default shipping display**, fill in **Currency**, **Free shipping goal**, **Flat rate shown** and **Delivery time**, then click **Save**. These are what shoppers see from every country you haven’t listed separately, the **Rest of world** row in **Settings** → **Countries**.
3. Under **Turn on your first placement**, click **Enable Sticky Bar** or **Add Product Highlights**.
4. Click **Complete setup**. The guide closes, and every placement appears on Home, ready to switch on.

**Skip setup** and **Dismiss guide** close the guide too, and **Mark as done** ticks a step by hand. Until the guide is closed, Home shows **Your placements unlock after setup** and every other page in UpBar opens Home instead.

> **Important:** The goals, rates and delivery times you type in UpBar are display amounts. UpBar never creates or changes your Shopify shipping rates, discounts or markets, so set those up in Shopify and keep the two in step.

UpBar doesn’t run on development stores: installing it on one shows **Development Store Not Supported**. Every feature is free, with no view limits ([UpBar’s pricing](/shopify/upbar/#pricing)).

## Why does UpBar need its app embed? {#why-does-upbar-need-its-app-embed}

The **UpBar** app embed is what loads four of UpBar’s placements on your storefront: the **Sticky Bar**, the **Cart Goal Bar**, **Sticky add to cart** and the **Promo popup** show only while it is on in your published theme. The four theme blocks load UpBar themselves, and with it the other placements on that page, which is how the **UpBar Countdown Timer** works on your password page, where no app embed loads.

Once the setup guide is closed, Home shows **App embed is off.**, with an **Activate app embed** button, whenever the embed is off in your published theme.

To turn it on yourself, go to **Online Store** in Shopify and click **Edit theme** on your published theme. Click the **App embeds** icon in the sidebar, switch on **UpBar** and click **Save**.

## Which placements need a theme block? {#which-placements-need-a-theme-block}

UpBar has eight placements, and four of them are theme blocks that you place yourself in the theme editor. The other four load from the app embed alone and appear wherever they belong.

| Placement | Where it comes from | Where it shows |
| --- | --- | --- |
| **Sticky Bar** | App embed | The top or bottom of every page |
| **Cart Goal Bar** | App embed | Above the checkout button, on the cart page and in cart drawers |
| **Sticky add to cart** | App embed | Product pages |
| **Promo popup** | App embed | The pages you target |
| **Product Highlights** | **UpBar Product Highlights** block | Product pages |
| **Estimated delivery date** | **UpBar Estimated Delivery** block | Product pages |
| **Trust badges** | **UpBar Trust Badges** block | Product and cart pages |
| **Countdown Timer** | **UpBar Countdown Timer** block | Any page, including the password page |

To add a block, open its placement in UpBar and click **Add to theme**. The theme editor opens with the block already inserted: drag it where you want it, then click **Save**. Blocks need an Online Store 2.0 theme, as all Shopify app blocks do ([Shopify’s theme app extensions](https://shopify.dev/docs/apps/build/online-store/theme-app-extensions/ux)). On an older theme, UpBar says “App blocks need an Online Store 2.0 theme; vintage themes can’t show this block.”

Every placement except Product Highlights starts switched off, and a block shows shoppers nothing until its placement is switched on in UpBar.

## How do I know UpBar is live? {#how-do-i-know-upbar-is-live}

Home gives every placement a badge: **Active** when it’s showing, **Off**, **Block not added** when its block isn’t in your theme, **Scheduled** or **Schedule ended** outside its dates, and **Needs review** when a setting it needs is missing. The Cart Goal Bar shows **New** instead of **Off** while it’s switched off.

Each placement’s page in UpBar also has a preview of what shoppers see. The Sticky Bar, Cart Goal Bar, Sticky add to cart and Promo popup usually don’t appear inside Shopify’s theme editor, which skips app embeds, so check them on your storefront or in that preview.

## Can Sidekick set up UpBar for me? {#can-sidekick-set-up-upbar-for-me}

Yes, if Sidekick is available in your Shopify admin. Ask it something like “Add a free shipping bar” or “Add a Black Friday countdown” and it opens UpBar’s **Setup plan** page with the changes staged and previewed. Nothing changes on your storefront until you review them and click **Save**.

Sidekick can also tell you which UpBar placements are live, why one isn’t showing to a particular shopper, and what goal, rate and delivery time UpBar shows for each country. UpBar’s setup plan can’t turn on the app embed, add a theme block or create a discount code: Sidekick lists those for you to do.

## What happens when I change my theme? {#what-happens-when-i-change-my-theme}

Apps aren’t active in a newly published theme by default, so turn on **UpBar** in the new theme’s **App embeds** and add UpBar’s blocks again ([Shopify’s help on app embeds](https://help.shopify.com/en/manual/online-store/themes/theme-structure/extend/apps)). Your UpBar settings don’t change: they’re stored in UpBar, not in the theme.

## How do I remove UpBar? {#how-do-i-remove-upbar}

To remove UpBar, uninstall it from your Shopify admin. Shopify removes the UpBar blocks and app embed from your themes when you do, so there’s no theme code to clean up ([Shopify’s theme app extensions](https://shopify.dev/docs/apps/build/online-store/theme-app-extensions/ux)). UpBar’s settings are removed with the app. Background and badge images you uploaded stay in your store’s **Files**. If you install UpBar again, it starts from its defaults and the setup guide.

## Related {#related}

- [UpBar not showing](/docs/upbar/not-showing/)
- [Free shipping bar with UpBar](/docs/upbar/free-shipping-bar/)
- [Countdown timers with UpBar](/docs/upbar/countdown-timer/)
- [Estimated delivery dates with UpBar](/docs/upbar/estimated-delivery/)

[UpBar: Free Shipping Bar Goal](/shopify/upbar/)

UpBar is a Shopify app that adds a free-shipping goal bar, rotating announcements, countdown timers, delivery-date estimates, trust badges, a sticky add-to-cart bar and a promo popup to your theme. Every feature is free. It displays the goals, rates and dates you enter, while Shopify's checkout decides what shoppers pay, and its blocks need an Online Store 2.0 theme.

[Install free on the Shopify App Store](https://apps.shopify.com/upbar-free-shipping-upsell?utm_source=b2bgold.app&utm_medium=referral&utm_campaign=docs&utm_content=docs/upbar/getting-started&utm_term=card) [Plans and pricing](/shopify/upbar/#pricing)

Need help with UpBar? Email [support@b2bgold.app](mailto:support@b2bgold.app).
