Troubleshooting

A section is missing from “Add section”

Some sections only appear on templates where they make sense. A product-specific section will not be offered on the blog template. Check which template you are editing — the dropdown at the top of the theme editor tells you.

My changes are not showing on the live store

You are almost certainly editing an unpublished theme. The theme editor works on whichever theme you opened it from, and only the published theme serves customers.

Go to Online Store → Themes and check which theme sits under Live. If your work is in a theme in the library below, either publish it or reapply the changes to the live one.

The section looks empty

Sections that pull from your catalog render nothing when there is nothing to render — a featured collection with no collection assigned, a related products section on a store with no order history.

Check the section’s settings for an unassigned resource. This is intentional: a section showing placeholder content on a live store is worse than a section showing nothing.

Filters are not appearing on my collection page

Faceted filtering in Shopify comes from the Search & Discovery app, which is free and made by Shopify. Install it, then configure which filters your store offers under Search & Discovery → Filters.

The theme renders whatever filters that app is configured to provide. If the app has none set up, the theme has none to show.

Product images look cropped or inconsistent

Check the image ratio setting under theme settings → product cards. If it is set to portrait or square, images are cropped to fit. Setting it to the natural ratio stops the cropping but produces an uneven grid if your images are inconsistently sized.

The real fix is consistent source images. The setting can only choose which compromise you make.

Text is too small on mobile

Manifest’s type scale is tuned so body copy and action labels stay legible at small sizes. If something looks small on your phone specifically, check whether you have set a very large display heading nearby — an oversized heading can make adjacent copy look disproportionately small even when it is a perfectly readable size.

If text genuinely renders too small, that is a bug and worth reporting.

Animations are not running

Three things switch them off, and all three are working as designed:

1. Transition style set to none in theme settings.
2. Scroll reveals turned off — a separate setting from interface motion.
3. The visitor’s own reduced-motion preference. Manifest honors the operating system setting automatically. If you have reduced motion enabled on your Mac or phone, you will not see animations, and neither will visitors who have made the same choice.

The cart is not updating

Check whether you have a cart-related app installed that modifies cart behavior. Conflicts between a theme and a cart app are the single most common source of this, and the fastest diagnosis is to disable the app temporarily and retest.

Something broke after I edited the code

Go to Online Store → Themes, and publish the duplicate you made before editing. If you did not make one, upload a fresh copy of Manifest and reapply your settings.

Code edits do not survive theme updates. If you need a change to persist across versions, note what you changed and why, somewhere outside the theme.

Getting help

Email [email protected]. To get a useful answer on the first reply, include:

• Your store URL, and a preview link if the problem is on an unpublished theme
• The template and section involved
• What you expected, and what happened instead
• A screenshot, and the device and browser you saw it on

If the problem only happens on one device, say which one. That detail solves a surprising number of reports on its own.