Peregrinedocs

FAQ & Troubleshooting

Quick answers to the questions we hear most.

Where did my H1 go?

If you set a heading tag to H1 on any section, the slideshow's automatic H1 politely demotes itself to H2 — that's the override system working as designed (how it works). Note the theme editor's live preview can briefly show the pre-demotion state when a single section refreshes; the real storefront is always correct — check with View Source if you want certainty.

The currency or language picker isn't showing — or a country is missing from it

The pickers only render when there's a genuine choice: two or more active markets (currency) or two or more published languages (language). One market = no picker, by design. If a country you expect is missing, three checks in order:

Full setup for both pickers, including the Shopify Payments requirement for local currencies, is in Header & Navigation.

Why has the price filter disappeared?

Check which currency the store is being viewed in — that's almost always the answer. Shopify only supports price filtering in your store's default currency; a shopper (or you, previewing with admin's "View as" set to another country) browsing in any other currency gets every filter except price. It's platform behaviour shared by every theme, and it reverses the moment the view returns to your default currency. Full explanation here.

The theme editor hangs after I press Save

You save, the progress bar runs across the top, and then a block's settings panel spins forever while the section list on the left never finishes loading. Reloading the editor page fixes it, and nothing is lost — the save itself completed.

Check the page selector at the top of the editor. If it says /password instead of the page you were working on, that's your answer: the preview briefly hit your storefront password screen, and the editor took that as the page you're now editing. It then goes looking for your product blocks on the password page, where they don't exist, and waits indefinitely.

The usual culprit is privacy software on your own computer. The editor shows your storefront in a frame inside the Shopify admin, which makes your storefront's cookie a "third-party" cookie as far as your browser is concerned. Anti-tracking tools block exactly that — and without it the frame can't prove it's already past your password screen, so it gets sent back to it.

Add https://admin.shopify.com/ to the exceptions of whatever is doing the blocking. In order of likelihood:

If your store is live and no longer needs the password, removing it under Online Store → Preferences also removes the cause. That isn't available on a development store, where password protection is permanent — so on a dev store the exception above is the fix.

This affects every theme, not just Peregrine. No theme can cause or prevent it: a theme has no way to redirect you anywhere, and the password screen is Shopify's own.

A filter looks missing when I open the drawer in the theme editor

The editor draws its blue section-selection outline on top of the preview, and it can sit exactly over a filter group in the open drawer. Press Escape to deselect the section, or verify on the storefront — the storefront is always correct.

My grid shows fewer columns than I set

If the sidebar filter layout is showing, the grid deliberately gives up one column so cards don't get squeezed — set 4 and you'll see 4 on an unfiltered page and 3 alongside a sidebar. Choose the horizontal bar or drawer filter layout if you want the grid at full width. More on the grid.

Quick add isn't showing on some products

Three things to check, in order. Is Quick add set to something other than None? It's off out of the box — it's in the Collection section's settings, not theme settings. Is the product sold out? The button style shows a disabled "Sold out"; the size-chip style shows nothing at all rather than an unusable strip. Does the product have more than one option? Size chips only appear inline for products with a single option of up to ten values — anything more complex falls back to your Choose options setting. Full behaviour here.

My mega menu block isn't working

The block matches your menu item by exact title. "Shop All" won't match "Shop all". Copy the item name from Online Store → Navigation and paste it into the block.

The placeholder images look odd / where do they come from?

Sections show Shopify's grey placeholder art until you pick real images — they scale and crop like real photos and disappear the moment you set your own. Placeholders on a published store usually just mean a section is missing its image.

Slides don't rotate

Rotation needs two or more slides and the auto-rotate toggle on. It also pauses while the cursor is over the slideshow, and is disabled for visitors whose devices request reduced motion — an accessibility feature, not a bug.

I set a mobile image but desktop shows it / vice versa

Mobile images apply below the tablet breakpoint; desktop images at and above it. Check the per-image "Use mobile image on mobile" switch — off means the desktop image shows everywhere.

Search flyout shows no results

Predictive search needs at least two characters and searches product titles, types, vendors and variants. "No results" with a correct spelling usually means the products are in Draft status or excluded from the Online Store sales channel.

A product shows Sold out but admin says it has stock

Admin's inventory columns are per-location accounting — "Available: 20" means twenty units are free to commit at that location. The storefront asks a different question: can any location that's allowed and able to fulfil Online Store orders ship it? Stock at a retail-only location, a disconnected fulfilment service, or any location excluded from online fulfilment counts in admin but can't back an online sale — so Shopify marks the product unavailable and Peregrine's badge reports it. You can verify it's Shopify's decision, not the theme's: the Add to cart button on that product will refuse too. Fix it by stocking the product at a location that fulfils online orders (Settings → Shipping shows which those are).

The same product shows twice in my cart

Almost always Shopify doing its job, and usually a sign a discount is working. Shopify keeps units on separate cart lines when only some of them earned something — a Buy X get Y offer such as the free gift milestone is the usual cause. Two units earned the gift, a third didn't, so they sit apart even though the shopper sees the same product, size and price on both rows.

Peregrine combines them for you: Theme settings → Cart → Combine duplicate lines is on by default and shows one row with the quantities added together. If you're seeing two rows, that setting has been switched off. Note that checkout still lists them separately — that part isn't the theme's to change, and the totals always match.

One case where it is not Shopify's doing: two rows that differ in their line-item properties — a personalised message, a gift-card recipient, a subscription. Those are genuinely different lines and are never combined, because a shopper needs to see them apart.

Adding from a cart recommendation adds the wrong variant

Check the dropdown on the tile before adding — it starts on the product's first available variant, not on a blank "choose one" state, so a shopper who doesn't touch it gets that first variant. If a product's variants really need thinking about, lower Theme settings → Cart → Most variants to list so those products link to the product page instead, or switch Add to cart from the recommendation off entirely.