---
title: Troubleshooting
url: https://support.troopthemes.com/guide/troubleshooting/
---

# Troubleshooting

This page applies to all Troop themes: Blockshop, Maker, Emerge, and Beyond, including their styles (Radiance, Stone, and Valla are Blockshop; Bloom is Maker; Cafe and Elements are Emerge; Fleur is Beyond).

If something used to work and no longer does, identify the owner of the problem before you edit theme code. Most reported theme bugs are caused by an app embed, leftover app code, a setting on a single section, or Shopify admin data. Start here and follow the matching how-to. Do not start in the theme code editor.

> **Theme, Shopify, or an app?**
>
> **Theme**: storefront appearance. Theme settings, sections, and default theme text. See [When the issue is isolated to one topic](#when-the-issue-is-isolated-to-one-topic).
>
> **Shopify admin**: catalog and content, such as products, collections, pages, menus, and blog posts. The theme only displays this data. See [Catalog and content](#catalog-and-content-shopify-admin).
>
> **Outside the theme**: checkout, payments, shipping, and inventory live in Shopify **Settings** or **Products**, not Theme settings. See [Checkout, payments, shipping, and inventory](#checkout-payments-shipping-and-inventory). Collection filters use the **Search & Discovery** app. Email, reviews, and subscriptions come from apps.

## Outside the theme

Troop docs cover **Edit theme** settings and sections. The categories below never live in Theme settings, or only partly do. Use Shopify’s help centre first; use a Troop link when we explain how the theme connects.

### Checkout, payments, shipping, and inventory

- **Checkout look and fields**: Shopify [checkout customization](https://help.shopify.com/en/manual/checkout-settings)
- **Payment methods**: Shopify [payments](https://help.shopify.com/en/manual/payments)
- **Shipping rates and delivery profiles**: Shopify [shipping and delivery](https://help.shopify.com/en/manual/shipping)
- **Stock levels and “continue selling when out of stock”**: Shopify [inventory](https://help.shopify.com/en/manual/products/inventory) and [selling when out of stock](https://help.shopify.com/en/manual/products/inventory/setup/selling-when-out-of-stock)

### Catalog and content (Shopify admin)

The theme displays what you assign; it does not create the data.

- **Products**: Shopify [products](https://help.shopify.com/en/manual/products)
- **Collections**: Shopify [collections](https://help.shopify.com/en/manual/products/collections)
- **Pages**: Shopify [pages](https://help.shopify.com/en/manual/online-store/themes/theme-structure/pages)
- **Menus**: Shopify [menus and links](https://help.shopify.com/en/manual/online-store/menus-and-links). Then assign the menu in the theme. Setting up navigation: [Blockshop](https://support.troopthemes.com/guide/blockshop/creating-navigation/) · [Maker](https://support.troopthemes.com/guide/maker/creating-navigation/) · [Emerge](https://support.troopthemes.com/guide/emerge/creating-navigation/) · [Beyond](https://support.troopthemes.com/guide/beyond/creating-navigation/)
- **Blog posts**: Shopify [blog posts](https://help.shopify.com/en/manual/online-store/blogs/writing-blogs/working-with-blog-posts). The theme controls the blog layout. Customizing blogs: [Blockshop](https://support.troopthemes.com/guide/blockshop/customizing-blog/) · [Maker](https://support.troopthemes.com/guide/maker/customizing-blog/) · [Emerge](https://support.troopthemes.com/guide/emerge/customizing-blog/) · [Beyond](https://support.troopthemes.com/guide/beyond/customizing-blog/)

### Search, filters, and discovery

- **Collection filters and storefront search**: **Apps** → **Search & Discovery** → **Filters**. Shopify: [storefront filters](https://help.shopify.com/en/manual/online-store/themes/customizing-themes/common-customizations/storefront-filters). Troop: [Blockshop](https://support.troopthemes.com/guide/blockshop/setting-up-product-filters/) · [Maker](https://support.troopthemes.com/guide/maker/setting-up-product-filters/) · [Emerge](https://support.troopthemes.com/guide/emerge/setting-up-product-filters/) · [Beyond](https://support.troopthemes.com/guide/beyond/setting-up-product-filters/) (what the theme shows on collection pages).

### Markets, currency, and languages

- **Countries, currencies, Markets, and languages**: Shopify [Markets](https://help.shopify.com/en/manual/markets), [local currencies](https://help.shopify.com/en/manual/markets/customizations/local-currencies), and [localization and translation](https://help.shopify.com/en/manual/international/localization-and-translation). Troop: country, currency, and language selectors in your theme guide (see [Store](#store) below).

### Email, reviews, subscriptions, and other apps

Campaigns, reviews, subscriptions, and many popups come from **Apps**, not Theme settings.

- **Choosing, embedding, and removing apps**: [Using apps with your theme](https://support.troopthemes.com/guide/using-apps-with-themes/)
- **Shopify overview**: [Extending your theme with apps](https://help.shopify.com/en/manual/online-store/themes/customizing-themes/apps)
- **Newsletter forms → Customers list**: Troop signup forms add customers to **Customers** in admin; email campaigns need Klaviyo, Shopify Email, or similar. See **Mailing list & newsletters** under [Content](#content) below (pick your theme).

## Inside the theme

If the issue is on your storefront, in **Theme settings**, in a section, in custom code, or in an app embed, work through these steps in order. Stop when the store behaves correctly. The step where the issue disappears identifies the owner.

1. **Duplicate the theme** (Online Store → Themes → Duplicate) so you can test without touching the live store.
2. **Turn off app embeds**: **Edit theme** → **App embeds**, switch each one off, then preview. If the issue disappears, the app owns it. Contact that developer. See [Using apps with your theme](https://support.troopthemes.com/guide/using-apps-with-themes/).
3. **Install a fresh copy and preview it unpublished.** Open your theme's Theme Store listing and add the theme to your store, as described in [How to update your theme](https://support.troopthemes.com/guide/update-theme/#how-to-update). Do not publish it. If the issue is gone on the fresh copy, a customization or leftover app code in the live theme is the cause.
4. **Contact support if the fresh copy has the issue.** [Submit a support ticket](https://support.troopthemes.com/submit-a-support-ticket/) with the theme name, version, and a preview link. If you need an older theme version, ask for it in the same ticket.

> **Deleting apps**
>
> Many apps inject code into theme files. Deleting the app from **Apps** does not always remove that code. Ask the app developer how to uninstall completely. We can answer compatibility questions if you CC support.

## Rollback changes

If a developer (or you) edited theme files around the time the issue started, contact them before submitting a ticket. In the Shopify code editor, a circle appears beside templates that have been modified. You can [roll back a file](https://help.shopify.com/en/manual/online-store/themes/customizing-themes/edit-code).

## When the issue is isolated to one topic

If the problem is limited to a single feature, such as colors on one section, a newsletter form, or collection filters, you can skip the general steps above. Each guide ends with a **Troubleshooting** section for that topic alone. Links below jump straight there; where content differs by theme, pick yours.

### General

- [How to update your theme](https://support.troopthemes.com/guide/update-theme/#troubleshooting)
- [Using apps with your theme](https://support.troopthemes.com/guide/using-apps-with-themes/#troubleshooting)

### Appearance

- **Colors**: [Blockshop](https://support.troopthemes.com/guide/blockshop/colors/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/colors/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/colors/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/colors/#troubleshooting)
- **Typography**: [Blockshop](https://support.troopthemes.com/guide/blockshop/typography/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/typography/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/typography/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/typography/#troubleshooting)
- **Changing default theme text**: [Blockshop](https://support.troopthemes.com/guide/blockshop/change-default-text/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/change-default-text/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/change-default-text/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/change-default-text/#troubleshooting)
- **Spacing and layout**: [Blockshop](https://support.troopthemes.com/guide/blockshop/spacing-and-layout/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/spacing-and-layout/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/spacing-and-layout/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/spacing-and-layout/#troubleshooting)
- **Alignment and width**: [Blockshop](https://support.troopthemes.com/guide/blockshop/alignment-and-width/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/alignment-and-width/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/alignment-and-width/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/alignment-and-width/#troubleshooting)
- **Buttons & Inputs**: [Blockshop](https://support.troopthemes.com/guide/blockshop/buttons-inputs-and-links/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/buttons-and-inputs/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/buttons-and-inputs/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/buttons-and-inputs/#troubleshooting)
- **Images**: [Blockshop](https://support.troopthemes.com/guide/blockshop/images/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/images/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/images/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/images/#troubleshooting)
- **Social media**: [Blockshop](https://support.troopthemes.com/guide/blockshop/social-media/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/social-media/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/social-media/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/social-media/#troubleshooting)
- **Animations**: [Blockshop](https://support.troopthemes.com/guide/blockshop/animations/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/animations/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/animations/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/animations/#troubleshooting)

### Sections and templates

- **Section shapes** (Emerge only): [Troubleshooting](https://support.troopthemes.com/guide/emerge/section-shapes/#troubleshooting)
- **Brand and story sections** (Beyond only): [Troubleshooting](https://support.troopthemes.com/guide/beyond/brand-and-story-sections/#troubleshooting)
- **Designing with image sections**: [Blockshop](https://support.troopthemes.com/guide/blockshop/image-sections/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/image-sections/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/image-sections/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/image-sections/#troubleshooting)
- **Collection page promotions**: [Blockshop](https://support.troopthemes.com/guide/blockshop/collection-page-promotions/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/collection-page-promotions/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/collection-page-promotions/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/collection-page-promotions/#troubleshooting)
- **Setting up navigation**: [Blockshop](https://support.troopthemes.com/guide/blockshop/creating-navigation/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/creating-navigation/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/creating-navigation/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/creating-navigation/#troubleshooting)
- **Working with templates**: [Blockshop](https://support.troopthemes.com/guide/blockshop/working-with-templates/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/working-with-templates/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/working-with-templates/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/working-with-templates/#troubleshooting)

### Products

- **Product grid**: [Blockshop](https://support.troopthemes.com/guide/blockshop/product-grid/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/product-grid/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/product-grid/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/product-grid/#troubleshooting)
- **Quick add**: [Blockshop](https://support.troopthemes.com/guide/blockshop/quick-add/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/quick-add/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/quick-add/#troubleshooting) (Maker has no Quick add settings group)
- **Setting up product filters**: [Blockshop](https://support.troopthemes.com/guide/blockshop/setting-up-product-filters/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/setting-up-product-filters/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/setting-up-product-filters/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/setting-up-product-filters/#troubleshooting)
- **Search**: [Blockshop](https://support.troopthemes.com/guide/blockshop/search/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/search/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/search/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/search/#troubleshooting)
- **Color swatches**: [Blockshop](https://support.troopthemes.com/guide/blockshop/color-swatch-guide/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/color-swatch-guide/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/color-swatch-guide/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/color-swatch-guide/#troubleshooting)
- **Product size chart**: [Blockshop](https://support.troopthemes.com/guide/blockshop/product-size-chart/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/product-size-chart/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/product-size-chart/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/product-size-chart/#troubleshooting)
- **Out of stock notifications**: [Blockshop](https://support.troopthemes.com/guide/blockshop/out-of-stock-notifications/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/out-of-stock-notifications/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/out-of-stock-notifications/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/out-of-stock-notifications/#troubleshooting)

### Content

- **FAQ or Collapsible rows**: [Blockshop](https://support.troopthemes.com/guide/blockshop/setting-up-faq-or-collapsible-rows/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/setting-up-faq-or-collapsible-rows/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/setting-up-faq-or-collapsible-rows/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/setting-up-faq-or-collapsible-rows/#troubleshooting)
- **Customizing blogs**: [Blockshop](https://support.troopthemes.com/guide/blockshop/customizing-blog/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/customizing-blog/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/customizing-blog/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/customizing-blog/#troubleshooting)
- **Configuring the popup**: [Blockshop](https://support.troopthemes.com/guide/blockshop/configuring-the-popup/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/configuring-the-popup/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/configuring-the-popup/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/configuring-the-popup/#troubleshooting)
- **Mailing list & newsletters**: [Blockshop](https://support.troopthemes.com/guide/blockshop/newsletters/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/newsletters/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/newsletters/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/newsletters/#troubleshooting)

### Store

- **Country, currency, and language selectors**: [Blockshop](https://support.troopthemes.com/guide/blockshop/configure-country-currency-selectors/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/configure-country-currency-selectors/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/configure-country-currency-selectors/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/configure-country-currency-selectors/#troubleshooting)
- **Custom CSS and template code**: [Blockshop](https://support.troopthemes.com/guide/blockshop/adding-css-editing-template-code/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/adding-css-editing-template-code/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/adding-css-editing-template-code/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/adding-css-editing-template-code/#troubleshooting)
- **Cart**: [Blockshop](https://support.troopthemes.com/guide/blockshop/cart/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/cart/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/cart/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/cart/#troubleshooting)
- **Advanced settings**: [Blockshop](https://support.troopthemes.com/guide/blockshop/advanced-settings/#troubleshooting) · [Maker](https://support.troopthemes.com/guide/maker/advanced-settings/#troubleshooting) · [Emerge](https://support.troopthemes.com/guide/emerge/advanced-settings/#troubleshooting) · [Beyond](https://support.troopthemes.com/guide/beyond/advanced-settings/#troubleshooting)