Skip to content

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.

Shopify admin: catalog and content, such as products, collections, pages, menus, and blog posts. The theme only displays this data. See Catalog and content.

Outside the theme: checkout, payments, shipping, and inventory live in Shopify Settings or Products, not Theme settings. See 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

Catalog and content (Shopify admin)

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

Search, filters, and discovery

Markets, currency, and languages

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
  • Shopify overview: Extending your theme with 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 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.
  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. 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 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.

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

Appearance

Sections and templates

Products

Content

Store