Skip to main content
The product details page gives you a single place to inspect everything Layers has synced for a product — featured media, the full variant list with prices and inventory, options, metafields, and category metadata — without leaving the dashboard or jumping to Shopify.

​
When to use this

  • You want to confirm Layers has the latest data for a product after editing it in Shopify.
  • You need to verify variant pricing, inventory, or selected options before pinning a product in a merchandising rule.
  • You’re debugging why a product isn’t appearing where you expect and want to inspect its tags, collections, metafields, or status.

​
Steps

  1. In the dashboard, go to Products.
  2. Find the product in the list and click its title (or the row). Use the Status and Type column filters to narrow the list. See Filter the products list.
  3. Review the product detail page.

​
What you can see

The page is split into a media-and-summary area, a variants table, and a metafields table.
  • Media — A hero image, secondary images, and any additional photos in a grid. The featured media (if set) appears first.
  • Status badge — Shows whether the product is active, draft, or archived in Shopify.
  • Summary — Vendor, product type, handle, tags, category, the published date, and a Channels field showing which sales channels the product is published to.
  • Collections — A sidebar card listing every collection the product belongs to, ordered by title. Click a collection to open its details page. See View collection details. If the product is in more than 10 collections, the card shows the first 10 with a Show more toggle. The card doesn’t appear when the product isn’t in any collection.
  • Variants — Every variant with its title, SKU, price, compare-at price, inventory, and selected options. A Channels column shows which sales channels each variant is published to. When a product has many variants and a shared first option (for example, color), Layers groups them so the table stays readable. Click a variant row to open a side sheet with that variant’s full metafield list and a Sales channels section listing every publication the variant is available on. Each row also has an Actions column with a Sync inventory from Shopify button. See Manually resync variant inventory.
  • Metafields — A table of namespace, key, and value for every product-level metafield Layers has synced. See How metafield values render.

​
How metafield values render

The metafields table (and the variant side sheet’s metafield list) formats each value based on its type, so you can read it without parsing raw JSON:
  • Money — Formatted as currency, for example $10.00 instead of a raw amount-and-currency object.
  • Metaobject references — Rendered as a card showing the metaobject’s display name, type, handle, and each of its fields. Lists of metaobjects render as stacked cards, and nested metaobjects render inline. If Layers hasn’t resolved a referenced metaobject yet, the card shows its ID instead.
  • Tabular metaobject fields — Some metaobjects store rows of comma-separated values alongside a matching headers field (a common size-guide pattern). Layers renders these as a table with the headers as the header row.
  • Lists — Scalar lists (text, numbers) render as chips. Color lists render as swatch chips with a color preview.
  • Rich text — Rendered as formatted text.
  • HTML — Values containing HTML markup (for example, a size chart stored as body_html with a <style> block and a table) render as a formatted preview instead of raw source text. The preview runs in an isolated sandbox: authored styling is kept, but scripts, forms, and network requests are blocked. The preview has a fixed height and scrolls internally. Click Show source below the preview to see the raw markup. This applies to HTML fields inside metaobject cards too.
  • Empty values — Shown as —.
  • Everything else — Falls back to an expandable JSON viewer.
Layers detects these shapes from the value itself as well as the metafield’s declared type, so a mistyped Shopify metafield still renders readably.

​
Hidden-from-search alert

If a product is active and published in Shopify but Layers is still excluding it from search and collections, the sidebar shows a Product hidden from search alert. The alert lists the exact rule causing the exclusion. Use it to confirm whether a “missing” product is genuinely absent from the index or is being filtered out on purpose. The alert only appears when the product would otherwise be searchable. Its presence always means an exclusion is active, and its absence means no product-level exclusion is in play. Products whose online-store publication is only scheduled for a future date don’t show the alert, because Layers treats them as not yet published. See Scheduled publications. Reasons the alert can name:
  • A built-in exclusion tag (hide, algolia-ignore, or layers-ignore) is on the product.
  • A tag you’ve listed in Settings → Search Behavior → Search Excluded Tags is on the product. The alert names the offending tag and links to Search Settings so you can adjust the list. See Configure search behavior.
  • Shopify’s Hide from search engines and sitemap option is on for the product (the seo.hidden metafield).
If multiple rules match, the alert lists every one. To make the product searchable again, remove the offending tag in Shopify, remove the tag from your Search Excluded Tags list, or turn off the Shopify SEO hide option. Then run Sync from Shopify from the page header to reindex.

​
Actions

The page header provides quick actions for the product:
  • Sync from Shopify — Refresh this product’s data without resyncing the rest of your catalog. Useful when a Shopify edit hasn’t propagated yet. See Manually resync a single product.
  • View on Shopify — Open the product in your Shopify admin in a new tab.

​
Tips

  • Use the breadcrumb at the top of the page to jump back to Products or to the dashboard root.
  • Variant rows show a thumbnail when the variant has its own featured media. This is useful for spot-checking that color or material variants point at the right photo.
  • If a variant’s inventory_quantity looks stale, run Sync from Shopify from the page header to pull the latest values, or use the per-variant Sync inventory from Shopify action in the variants table to refresh just that variant.
  • If a product looks published in Shopify but doesn’t appear on the storefront, compare the Channels field in the summary with the Channels column in the variants table. A product-level channel with no matching variant channels usually means the storefront and search will treat the product as unpublished. Run Sync from Shopify to reconcile it.

​
Next steps