Common issues and how to resolve them. If your issue is not listed here, see the support policy for how to get help.

Filters do not appear on collection or search pages

Cause: filters require the Shopify Search and Discovery app. Without it, the theme has nothing to render.

Fix:

  1. Go to Apps in your Shopify admin.
  2. Search for Shopify Search and Discovery and install it (free, by Shopify).
  3. Open the app, go to Filters, and add filters (availability, price, vendor, type, color, size, or any product metafield).
  4. Save. Filters appear automatically.

If filters still do not appear after installing the app:

  • Confirm Enable filtering is on in the section settings (collection main or search main).
  • Confirm the collection has more than zero products. Empty collections show no filter UI.
  • On search pages: filters apply to the Products tab only. The Articles, Pages, and All tabs do not show filters.
  • If the search returns more than 1000 products, Shopify does not return filter data. Ask customers to narrow their query.

Color scheme not applying as expected

Cause: most likely a setting mismatch between the section and the parent context.

Fix:

  1. Open Customize and click the section that looks wrong.
  2. Find the Color scheme setting in the right sidebar.
  3. Switch to a different scheme, then back. This forces a re-render.
  4. If the section uses an inherited scheme, check the global default in Theme settings > Colors.

If a specific element (button, link, focus ring) still looks wrong:

  • Open Theme settings > Colors and edit the active scheme.
  • Adjust the relevant color (button, focus, text, background) and save.
  • Reload the storefront with cache disabled (in DevTools, check "Disable cache" while DevTools is open).

Cart drawer does not open

Cause: usually JavaScript error from a third-party app, or a browser extension blocking the script.

Fix:

  1. Open the storefront and check the browser console (DevTools > Console) for JavaScript errors. App-injected scripts can break the cart drawer; disable apps one by one to identify the culprit.
  2. Test in an incognito window to rule out browser extensions.
  3. Confirm the cart icon in the header is the cart drawer trigger, not a direct link to the cart page (some custom modifications may have changed this).

Search overlay does not show predictive results

Cause: usually a search term shorter than two characters, a slow connection, or an interfering app.

Fix:

  • Confirm the customer typed at least two characters.
  • Check the browser console for errors on /search/suggest.json requests. If Shopify returns an error, it is a platform issue, not a theme issue.
  • If only some result types are missing (no products but articles show), check that the missing content is published and not password-protected.

Header is not sticky

Cause: Enable sticky header is off in the header section settings.

Fix: open Customize, click the Header section, and turn on Enable sticky header.

Images look stretched or cropped wrong

Cause: image aspect ratio mismatch with the container, or the focal point is set incorrectly.

Fix:

  • For product images: make sure all product images have the same aspect ratio. Mixed aspect ratios cause inconsistent grids.
  • For collection, hero, and content section images: open the image in your Shopify admin's Files library and adjust focal point if available, or upload a version with the focal point centered correctly.
  • For images uploaded through theme settings: re-upload at a larger size. The theme does not upscale images; small source images stay small.
  • Hero: 2400 by 1200 pixels minimum.
  • Slideshow: 2400 by 1200 pixels.
  • Product images: 2048 by 2048 pixels (square) or matching consistent ratio.
  • Logo: 600 by 200 pixels at 2x density (so 1200 by 400 actual).
  • Image with text: 1200 by 1200 pixels.
  • Collection images: 1500 by 1500 pixels.

Mobile menu does not open

Cause: rare, but usually a JavaScript error from another app loading before the theme's mobile nav script.

Fix:

  1. Open the storefront on mobile and check the browser console. Connect a phone to a computer for remote DevTools (Chrome remote devices for Android, Safari Develop menu for iOS).
  2. Look for errors mentioning mobile-nav, header, or third-party scripts.
  3. Disable apps one at a time to identify which app's script is causing the problem.

Newsletter signup does not work

Cause: signups go to your customer list, not to a third-party marketing tool, unless you have an email app configured.

Fix:

  • Go to Customers in your admin and check whether the test signup appears with Accepts email marketing enabled.
  • If you use Klaviyo, Mailchimp, or another email tool, configure their app to sync the customer list.
  • The form's success message comes from your locale file. To customize it, edit your active language under Content > Languages and find the newsletter form strings.

Free shipping bar shows the wrong threshold or currency

Cause: the threshold setting and the customer's currency are decoupled. The threshold value is entered as a single number; multi-currency stores need configuration.

Fix:

  1. Open Customize and find the Cart drawer or Cart section, then the free shipping setting.
  2. Confirm the threshold value (in your shop's primary currency).
  3. If you sell in multiple currencies through Shopify Markets, the displayed amount may be converted using Shopify's exchange rates, depending on your Markets configuration. Customers in other currencies see the converted equivalent.

Variant images do not switch when a customer selects a variant

Cause: the variant has no image assigned, or the variant image is the same as the master.

Fix:

  1. Edit the product in your Shopify admin.
  2. Scroll to Variants, click a variant, and assign an image to that variant.
  3. Save and reload the product page. The image should switch when that variant is selected.

If variants share an image, the image will not change because there is nothing to switch to.

Text appears in English when the store language is not English

Cause: missing translations in the locale file for the active language.

Fix:

  1. Confirm the language is published in Settings > Languages.
  2. Open Content > Languages > the active language, and find any blank fields. Fill them in.
  3. For merchant-created content (product titles, descriptions, page text), translations come through the Translate and Adapt app or another translation tool, not from the theme.

Pages load slowly

Cause: usually heavy images, too many apps, or third-party scripts.

Fix:

  • Run a Lighthouse audit (DevTools > Lighthouse) on a typical page. Check the Performance score and the largest issues.
  • Check the Performance tab in DevTools to see which scripts are slow. Apps and third-party tools are common offenders.
  • Compress images before uploading. The theme delivers responsive sizes automatically, but a 10MB source image still takes time to process.
  • Disable apps you are not actively using.
  • Avoid stacking many large sections on the home page. The first paint includes everything above the fold.

Custom CSS or Liquid edits stopped working after an update

Cause: direct file edits do not transfer between theme versions.

Fix: see the theme updates reference. After every update, you need to reapply any direct code modifications. Keep a separate documented record of customizations to make this easier.

Editor preview looks different from the live storefront

Cause: the editor renders the theme version you are editing (which may not be the published one), and may render with simulated data for empty fields.

Fix:

  • Click Preview in the editor to open the actual storefront URL with the theme rendered.
  • If you are editing a non-published theme, click Publish before expecting changes to appear on the live store.
  • Hard reload the storefront (Cmd+Shift+R on Mac, Ctrl+Shift+R on Windows) to bypass the browser cache.

How to gather information for a support request

If you need to report an issue, include the following:

  • Theme name and version.
  • The page URL where the issue occurs.
  • A screenshot or screen recording of the issue.
  • Browser and operating system (for example, Chrome 130 on macOS 14).
  • Mobile or desktop, and which device.
  • Steps to reproduce: what you clicked, in what order.
  • Browser console output: open DevTools > Console, copy any red error messages.
  • List of installed apps, especially any added recently.

Things to know

  • Many display issues are caused by apps, not the theme. If something looks wrong, disable third-party apps one at a time to isolate the cause before assuming a theme bug.
  • Shopify's edit cache can persist. After saving changes in Customize, reload the storefront with cache disabled to see the latest version.
  • Some issues only appear in production. The theme editor uses sample data for empty product fields, missing collections, and so on. Always preview a real published page.
  • Browser extensions can break things. Test in an incognito window with extensions disabled when troubleshooting.
  • Direct theme code edits are not recommended. They do not survive theme updates and they make it harder for support to help. Use theme settings, sections, and app blocks where possible.
  • If a feature does not exist, it does not exist. The theme provides specific sections, blocks, and settings. Some commonly-requested features (saved carts, account wishlists, real-time stock notifications, customer-uploaded files) are not part of the theme and require an app.