Troubleshooting: Widget Not Showing

If the 1ClickImpact widget is not appearing on your storefront, work through the following common causes and fixes.

1. Widget not enabled in theme editor

The widget block may not be added to the page template where you expect it.

How to fix:

1. Go to Online Store then Customize in your Shopify admin
2. Navigate to the page where you want the widget (e.g., product page, cart page)
3. Look for the 1ClickImpact widget block in the page sections
4. If it is not there, click Add block or Add section and search for 1ClickImpact
5. Save the theme

2. App embed not turned on (cart widget)

The cart widget is an app embed that must be activated separately from page blocks.

How to fix:

1. In the theme editor, open the App embeds panel (toggle icon in the left sidebar)
2. Find 1ClickImpact Cart Widget
3. Toggle it on
4. Save the theme

3. No impact categories enabled

If no impact categories are enabled in your setup, the widget has nothing to display and will not render.

How to fix:

1. Open the 1ClickImpact app in your Shopify admin
2. Go to Setup
3. Make sure at least one impact category (Trees, Ocean, Carbon, or Donate) is enabled
4. Save your changes

4. Metafield not set

In some cases, the shop metafields that the widget reads from may not be initialized. This can happen if the app was reinstalled or if setup was not fully completed.

How to fix:

1. Open the 1ClickImpact app
2. Go to Setup and re-save your configuration
3. Wait a few seconds, then reload your storefront

If the issue persists, try uninstalling and reinstalling the app. This will reinitialize the metafields.

Cart widget: manual placeholder

If your theme's cart page uses a non-standard structure, the cart widget may not auto-detect where to render. In that case, add a placeholder element to your cart template:

<div id="oci-cart-widget-placeholder"></div>

Place this div wherever you want the widget to appear in your cart template file (typically cart.liquid, cart-template.liquid, or a cart section file).