Arcella documentation

Troubleshooting

ProblemWhat to check
The featured collection shows grey placeholder cardsNo collection is selected in Featured collection > Collection, or the collection has no products available on the Online Store
A collapsible row is missingThe metafield is empty, and the block’s Text and Page content are empty too. Check the Product metafield spelling (namespace.key)
Filters don’t appearInstall Search & Discovery and add filters. Check Enable filtering. Filters show only when products have values for them
The country or language selector is missingMore than one country (Markets) or published language is needed. Check the footer and header toggles
Follow on Shop doesn’t appearThe Shop channel and Shop Pay are required, and Show Follow on Shop button must be on
The low-stock message never showsInventory tracking is off for the variant, or the quantity is above Low stock threshold
The variant image doesn’t changeNo image is assigned to that variant in admin
The hover image doesn’t changeThe product has only one media item, or Show second image on hover is off
The hero mobile image doesn’t showPreview at a width under 750px. The desktop image is used whenever Mobile image is empty
Images look cropped badlySet a focal point on the image. Choose a matching Image ratio, or Original in the product gallery
Add to cart says some items weren’t addedInventory or quantity rules limit the amount. The message shows what was added
A Custom Liquid section shows nothing or breaks the pageCheck the code for errors; remove it to confirm
The page jumps or animations feel heavyTurn off Reveal sections on scroll, and check that large videos are compressed
Swatches don’t showThe option values have no Shopify swatch and no matching line in Swatch colors. Names must match exactly (case doesn’t matter)
The free shipping bar doesn’t showFree shipping threshold is empty, the cart is empty, or the customer shops in a different currency
A menu image doesn’t appearMenu item must match the top-level menu item’s name, and that item needs at least one child link
Changes don’t show on the live storeChanges on an unpublished theme only show in its preview. Publish it, or apply the change to the live theme

When contacting support, include:

  • your store URL
  • the theme version (Online Store > Themes)
  • the page and section affected
  • steps to reproduce
  • a screenshot or screen recording

Still stuck? Contact support with your store URL and the steps to reproduce, and we’ll reply within two business days.