> For the complete documentation index, see [llms.txt](https://docs.globo.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.globo.io/globo-combined-listings/help/troubleshooting.md).

# Troubleshooting

## Widgets don't appear on the storefront

Work through this checklist in order:

{% stepper %}
{% step %}

### Is the app embed on?

Check the **Home** app status card. If it says inactive, [enable the app embed](/globo-combined-listings/getting-started/enable-the-app.md) on your **published** theme. This is the #1 cause.
{% endstep %}

{% step %}

### Is the master switch on?

**Settings → General → Enable Combined Listings on your storefront** must be on.
{% endstep %}

{% step %}

### Is the group Active?

Draft and archived groups never render. Check the group's status on the [Groups index](/globo-combined-listings/product-groups/manage-groups.md).
{% endstep %}

{% step %}

### Is the option shown on this surface?

An option's appearance can be **Hidden** per surface (product page vs. card). Open the group and check the [Appearance](/globo-combined-listings/product-groups/create-a-group/create-a-single-option-group.md#appearance) settings.
{% endstep %}

{% step %}

### Did you wait a minute or two?

Storefront data syncs in the background and is CDN-cached. Hard-refresh the page after a couple of minutes.
{% endstep %}

{% step %}

### Still nothing?

Your theme may need a tuned integration — see [Theme compatibility](/globo-combined-listings/storefront/theme-compatibility.md) and [contact support](/globo-combined-listings/help/contact-support.md) with your product page URL.
{% endstep %}
{% endstepper %}

## Changes don't show up

Saves publish asynchronously and Shopify's CDN caches the data file. Expect up to a few minutes of delay; a hard refresh (Cmd/Ctrl+Shift+R) usually reveals the update.

## An option value is greyed out / not clickable

A value is disabled when its linked product is unavailable — deleted, archived, set to draft, unpublished from the Online Store channel, or unlinked from the group. Fix the product's status or relink it in the group editor. The disabled *look* is controlled by your style's [sold-out effect](/globo-combined-listings/styles/customize-a-style.md#sold-out-effect).

## The widget shows in the wrong position

* Product page: pin it with the [product page block](/globo-combined-listings/storefront/product-page-block.md).
* Small offsets: adjust with [Custom CSS](/globo-combined-listings/settings/settings.md#custom-css).

## Group won't save

The editor shows a banner plus inline errors. Common causes: a product already belongs to another group, duplicate value names within an option, or a missing option name. See [validation errors](/globo-combined-listings/product-groups/create-a-group/create-a-single-option-group.md#validation-errors).

## CSV import fails

Check the [format and limits](/globo-combined-listings/product-groups/import-export-csv.md): header must include `Group` and `Product ID`; max 2 MB / 1,000 rows / 3 options; single-choice groups (`sub_groups`) aren't importable. Remember the **export** file is not an import template.