Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.uselayers.com/llms.txt

Use this file to discover all available pages before exploring further.

The Home page is the first screen you land on after signing in. It gives you a quick read on storefront performance, surfaces what is new in Layers, and helps you jump to the area you came in to work on.

Prerequisites

  • Your store must be past onboarding. See Install if you have just installed Layers.
  • Sync events from your storefront to the Beacon API so the headline metrics have data to show.

What you can see

The Home page is organized into four areas:

Date range and comparison

At the top of the page you choose the window every metric on the page reports against:
  • Date range — pick a relative window such as Past 7 days, a calendar window such as This month, or a custom range.
  • Compare to — pick the baseline you want every metric compared against. Options include Previous period, Previous month, Previous year, and Previous year (match day of week).
Both controls also report sync health on the right side of the row: the time of your last bulk catalog import and the time of the last Shopify webhook Layers received.

Headline metrics

A row of metric cards summarizes your storefront over the selected window. Each card shows the current value, a sparkline, and the percent change versus the comparison period. Cards typically include search volume, revenue, orders, and recommendation block engagement, but the exact set is store-specific. Click a card to open the full report in Reports for deeper analysis.

Notices

If Layers detects something that needs your attention — for example, a stuck catalog sync or a misconfigured integration — it appears here as an inline notice with a one-click action to resolve it.

Product updates

The lower half of the page highlights what is new in Layers, with links to the relevant feature, an in-product CTA, and a link to the full changelog entry. Cards can be dismissed individually so the list stays focused on what you have not seen yet. Use the Keep building in Layers modal to jump to any area of the dashboard. The modal groups every destination by:
  • Merchandising — rules, sort orders, sequences, blocks, product families.
  • Search & Discovery — autocomplete, request transforms, query expansions, semantic redirects.
  • Catalog & Data — catalog, attributes, collections, metafields.
  • Analytics & Evaluation — reports, analytics dashboards, search and image testing, evaluation runs.
  • Integrations — third-party integrations and API access.
Use the category tabs to filter the list while you are looking for a specific surface.

Troubleshooting

SymptomLikely causeWhat to do
Headline cards show No tracked events received yetConfirm your storefront is forwarding the events to the Beacon API.
Last Bulk Catalog Import is days oldCatalog sync is failing or pausedTrigger a catalog resync or contact support.
Last Shopify Webhook is hours oldShopify is not delivering webhooksCheck the Shopify app installation and reinstall if needed.
Comparison column shows The comparison window has no data (for example, the store was not live yet)Pick a more recent Compare to target or a shorter date range.

Next steps

  • Reports — build, save, and export reports off the same data.
  • Metric recipes — pre-built reports you can drop in.
  • LayersQL syntax — the query language behind every report and headline metric.