Skip to Content
FAQ

FAQ

Common questions and gotchas. We add to this list as support tickets surface new patterns. If your question isn’t here, contact support.

Setup and presets

How do I switch between the 5 presets?

Open the Theme Editor → click Theme settings (gear icon at the bottom-left) → under Preset, pick one of Mercer, Warm Craft, Bold Pop, Quiet Luxe, or Tech Forward. Save. The storefront reloads with the new tokens applied.

Switching presets does not destroy your content. Your existing sections, blocks, settings, and home page composition are preserved. Switching presets only changes design tokens (colors, fonts, radius, button shape) — bound to body[data-preset] and applied via the theme’s CSS tokens. It does not add, remove, or swap any sections; the signature hero sections are chosen and placed by you manually.

Will switching presets lose my home page customizations?

No. Mercer uses one index.json home template across all presets. The signature hero sections are independent sections you add and place yourself — none auto-render or swap based on the active preset. Your home page customizations — content sections, blocks, copy, settings — are preserved when you switch presets. Switching a preset only re-binds design tokens; it leaves your sections untouched.

If you’ve moved sections around, edited copy, or composed a custom home page layout, that work carries forward across every preset.

Can I mix design tokens from different presets?

No. Each preset is designed end-to-end. The colors, fonts, radius, and button shape are tuned together. We don’t recommend (or test) mixing tokens across presets. If you need a custom palette or font pair, override individual settings — the resulting look will be “the closest preset, but with X overridden”.

Can I have different colors on different sections?

Yes. Seventeen sections have a color_scheme setting (11 reusable sections plus the 6 signature heroes), each with the same 5 named schemes: Default, Editorial dark, Warm neutral, Accent pop, and Soft contrast. Default tracks your global Theme Settings colors. See Color schemes.

Can I add a 6th preset?

Not directly through the Editor. The presets are defined in the theme’s config/settings_data.json presets map, with their per-preset color tokens restated in assets/tokens.css.liquid. If you want a custom preset, contact support; we offer a preset-customization service for an additional fee.

Performance

My Lighthouse mobile score is low. Is that normal?

If you’re testing in the Theme Preview (the preview overlay you see in the Editor), yes — preview adds ~660 KB of overhead (preview-bar JS, checkout-web hooks, perf-kit, web-pixel-manager) that production storefronts don’t load. Test against the live storefront at https://your-store.myshopify.com, not the preview URL.

Use the live storefront, not Theme Preview, for meaningful performance checks. Archive the date, pages, device profile, network throttle, and reports before using exact Lighthouse numbers in public listing copy.

Why is my LCP image slow?

Two common causes:

  1. The image is too large. Mercer auto-generates responsive srcsets, but the source image still affects byte size. Upload images at most 2000 × 2000 px; Shopify’s CDN handles smaller variants automatically.
  2. The image is below the fold but you’ve configured it as a hero. Mercer eagerly loads the first 4 collection-card images and the hero section’s image. If your “hero” is actually a featured collection deep in the home page, it loads lazily, which delays its LCP if it ends up being the largest element.

Does Mercer support AVIF / WebP?

Yes. Mercer emits width-based responsive srcsets via Shopify’s image_url: width and image_tag (no format argument). Shopify’s CDN then content-negotiates AVIF / WebP per request via the visitor’s Accept header, serving the best format the browser supports.

Sections and blocks

Mercer’s header and footer are section groups with a fixed set of allowed sections: the header group contains the Header section, and the footer group contains the Footer and Mobile bottom nav sections. (The announcement is a setting inside the Header section, and the country gate is a snippet rendered directly in the layout — neither is a section in these groups.) You can edit the sections within those groups, but you can’t add arbitrary sections to them.

If you need custom content above the header or below the footer, add a Custom Liquid section to the home page (or wherever you want it to appear) — it’ll render in the page area, between the header and footer.

How do I add a mega-menu image / featured product?

Edit the Header section → Blocks → Add block, then pick Mega image, Mega collection, Mega product, or Mega promo. Set the block’s parent_link_url to the exact URL of a top-level menu link to attach it to that link’s dropdown. See Header.

Can I render a section conditionally?

Yes, with Custom Liquid. Wrap your content in a {% if %} block:

{%- if request.locale.iso_code == 'en' -%}
  <p>This shows only to English-speaking visitors.</p>
{%- endif -%}

For more conditional rendering (per-customer-tag, per-cart-total, per-product-tag), see Custom Liquid.

How do I make a section appear only on mobile (or only on desktop)?

Mercer sections don’t have a per-section “Show on mobile / desktop” visibility setting. To target a single breakpoint, use a Custom Liquid block with CSS:

<style>
  @media (min-width: 768px) {
    .my-mobile-only-block { display: none; }
  }
</style>
 
<div class="my-mobile-only-block">
  Only renders on mobile.
</div>

Markets and B2B

How do I enable currency switching?

Set up your markets in Shopify admin → Settings → Markets with local currencies enabled. Mercer’s switcher (header, modal, or footer) automatically picks up the available markets.

Does Mercer support languages other than English?

Yes. Mercer ships French, German, Italian, and Spanish starter locale packs alongside English. Have a native-speaker review market-specific copy before going live. See Markets.

My switcher doesn’t render

Check Theme settings → Markets → Switcher style isn’t set to Off. Then check there’s something to switch to — the switcher renders once you have 2+ countries or 2+ published languages. A single-country, single-language store has nothing to switch to, so no switcher renders (a single-country store with multiple languages still shows the language picker). See Markets for the full troubleshooting list.

How do I gate B2B-only sections?

Mercer’s B2B sections (catalog selector, company switcher, tier table, quantity rules) automatically render only when customer.b2b? is true. B2C visitors see no B2B markup, no extra requests, no overhead.

For your own B2B-only content (e.g. a wholesale-specific Custom Liquid section), wrap it in:

{%- if customer and customer.b2b? -%}
  Wholesale-only content here.
{%- endif -%}

Customizing

Can I edit Mercer’s CSS directly?

You can, but we don’t recommend it. The theme’s CSS is built around a design token system. Editing the CSS directly means your changes are lost on the next theme update.

For one-off styling, use a Custom Liquid block with inline style tags. For systemic customization, override the design tokens via Theme settings → Colors / Buttons / Typography. If you need a setting that doesn’t exist, request it via support.

Can I add a new font?

The Theme Editor’s Theme settings → Typography font picker uses Shopify’s font library. Most webfonts in common use are available there. To switch to a font Mercer doesn’t ship with, just pick it from the picker. Mercer renders any Shopify font correctly.

If your brand requires a self-hosted custom font that’s not in Shopify’s library, you’ll need a custom theme modification. Contact support.

Can I add a custom homepage layout?

Yes. The home page is composed in the Theme Editor — every section is rearrangeable. If the section you need doesn’t exist, use Custom Liquid (free-form HTML / Liquid) or contact us to request a new section type.

Can I have a different header on the product page?

Not directly through the Editor — Mercer ships one header group. For per-template header variations, you’d need to fork the theme or contract a custom modification. Ask support about per-template overrides.

Gift cards and selling plans

How do I add a gift card to my catalog?

Shopify admin → Products → Add product. Set the product type to Gift card, add denominations as variants ($25 / $50 / $100 / etc.), save. Mercer auto-detects the gift card product type and renders the recipient flow on its PDP. See Gift cards.

How do I add subscriptions?

Selling plans are managed in Shopify admin under Apps → [your subscription app] → Selling plans. Mercer renders the selling-plan picker on the PDP as a radio group below the variant picker. No merchant action required in the theme — Mercer reads product.selling_plan_groups from Shopify.

Why can’t customers quick-add gift cards or subscription products?

Mercer gates quick-add for two product types:

  • Gift cards — the recipient flow needs a full PDP.
  • Selling-plan-required products — the subscription terms need a full PDP.

Click-through to the PDP works as expected. This gating is intentional and not configurable.

Accessibility

How does Mercer approach accessibility?

Mercer is built with WCAG 2.1 AA-oriented patterns. We use native form labels, focus-visible focus rings, prefers-reduced-motion respect, SR-only skip links, and explicit id + for pairing on inputs. Archive current accessibility reports before using exact scores in listing copy.

Full a11y is a partnership — your content matters too. Always set alt text on images, use heading levels in order, and don’t rely on color alone to convey meaning.

How do I set alt text for hero images?

Every image-picker setting in Mercer pairs with an alt-text setting in the same panel. E.g. the Image with text section has Image + Alt text side by side. Set both.

Does Mercer support reduced motion?

Yes. All animations respect prefers-reduced-motion: reduce. The header’s auto-hide-on-scroll, image hover transitions, slide-in overlays, and dot pagination auto-rotation all freeze for users who prefer reduced motion.

SEO and analytics

Does Mercer ship structured data?

Yes. PDPs render JSON-LD product schema with name, image, price, brand, availability. Article pages render JSON-LD article schema. Search engines pick these up for Rich Results.

Mercer also renders OpenGraph + Twitter Card meta on every page. Check your page source under <meta property="og:*"> to verify.

How do I add Google Analytics / Meta Pixel / TikTok Pixel?

Use Online Store → Preferences → Custom JavaScript in Shopify admin (a Shopify-side feature, not theme-specific). Or install the analytics app from the Shopify App Store; it’ll inject via Shopify’s script-tag API.

For one-off pixels, you can also use a Custom Liquid section, but admin-side preferences are cleaner. Duplicate the theme before adding custom code and review Custom Liquid for support scope.

Does Mercer support Shop Pay?

Yes. The PDP renders a Shop Pay Installments banner when eligible. The cart and checkout pages render Shopify’s accelerated checkout buttons (Shop Pay, Apple Pay, Google Pay, PayPal) per your store’s payment configuration.

Update and changelog

How often does Mercer release updates?

We ship patch releases (bug fixes, performance, and accessibility work) and periodic minor releases that add new sections, blocks, and settings. Patch and minor releases are non-breaking — your theme settings and content always carry forward. Major releases (e.g. 1.x → 2.0) are reserved for breaking changes that require merchant re-setup; see the Changelog for the full semver policy.

See Changelog for what’s shipped recently.

How do I update to a new Mercer version?

  1. Once the Theme Store listing is live, you’ll see an “Update available” badge on your theme in Online Store → Themes.
  2. Click Update theme. Shopify creates a new draft theme with the update applied and your settings carried forward.
  3. Preview the draft. If everything looks right, Publish.
  4. The old theme remains in your library as a backup.

If anything is broken after the update, just publish the previous version from your library to roll back.

Support

How do I get help?

Last updated on
Support policyChangelog