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 collection details page is a focused view for a single Shopify collection. From one screen you can see the products in the collection, set the default sort order, manage the merchandising rules that target it, and review how the collection is performing for shoppers.

​
Prerequisites

  • Your storefront must forward click, add-to-cart, and purchase events to the Beacon API with the attributionToken returned by the Browse API. Without these events, the performance section shows empty results.

​
Steps

  1. In the dashboard, go to Collections.
  2. Click the collection you want to inspect.
  3. Use the page sections described below to review or update the collection.

​
Performance strip

The performance strip at the top of the page summarizes how the collection is performing right now. Each tile shows the absolute value and the percent change versus the prior period of the same length.
  • Impressions — Collection page views where Layers served products.
  • Clicks (CTR) — Click-through rate on those impressions.
  • Add-to-Cart — Add-to-cart rate on those impressions.
  • Revenue — Total attributed revenue for the timeframe.
Use the 7d, 14d, and 30d buttons to switch the timeframe. Results are cached briefly and refreshed in the background as new data arrives, so you don’t need to reload the page. For a deeper breakdown, open the Performance sheet from the page header (described below).

​
Products

Below the performance strip, Layers shows a paginated grid of every product currently in the collection — 24 per page. Each tile shows the product image, title, vendor, price, and a status badge if the product is in draft or archived state. Click a tile to open the product details page. The right sidebar gives you quick access to the most common collection-level controls:
  • Default Sort Order — The sort order that applies when no merchandising rule overrides it. Pick from any storefront-enabled sort order, or Not Set to leave the collection on the platform default.
  • Merchandising Rules — Every rule that targets this collection’s handle, with its enabled state. Click a rule to open it for editing, or + New to create one targeting this collection. The View all rules link takes you to the Merchandise list pre-filtered by the collection handle.

​
Page header actions

The overflow menu in the page header includes:
  • View Performance — Opens the full performance sheet (see below).
  • Sync Products — Re-pulls this collection’s product list from Shopify. Use this when a product was added or removed in Shopify and the change hasn’t appeared yet. See Manually resync a single collection.
  • View on Shopify — Opens the collection in your Shopify admin in a new tab.
  • Create Merchandising Rule — Starts a new merchandising rule pre-targeted at this collection.

​
Full performance sheet

Click View Performance in the page header to open the sheet with a richer breakdown.

​
KPI cards

The sheet shows two rows of metrics for the selected timeframe. Primary tiles:
  • Impressions — Collection page views where products were served.
  • CTR — Percentage of impressions that resulted in a product click.
  • ATC — Percentage of impressions that resulted in an add to cart.
  • Conv — Percentage of impressions that resulted in a purchase.
  • Rev — Total attributed revenue.
  • RPI — Revenue per impression: average revenue generated per page view. Highlighted because it’s the single best summary of how well the collection earns per visit.
Engagement tiles:
  • Zero-click — Percentage of browse sessions where no product was clicked. Lower is better.
  • Clicks/session — Average number of product clicks per browse session.
  • Prod/100 sess — Unique products clicked per 100 browse sessions, a measure of how broadly shoppers explore the collection.
Each tile shows the percent change versus the prior period of the same length. Improving direction is shown in green; degrading direction (including a rising Zero-click rate) is shown in red.

​
Performance trend

A line chart of CTR and RPI across the selected timeframe, so you can see whether the collection is improving, holding steady, or sliding day over day.

​
How clicks, add-to-carts, and purchases are counted

Layers reports blended counts: a sum of events tied directly to the request’s attributionToken plus modeled events from the same browsing session that happened within ten minutes of the collection being browsed. Modeled events that occurred more than two minutes after the impression are weighted at half a count to reflect the lower confidence that this collection drove them. This keeps your collection’s totals accurate even when the attributionToken doesn’t survive the full path to checkout. See Metrics: Blended attribution for the full set of attribution categories.

​
Troubleshooting

SymptomLikely causeWhat to do
All metrics show —No tracked events received yet for this collectionConfirm your storefront forwards the attributionToken to the Beacon API on every shopper interaction.
Sections show “Unavailable”Analytics warehouse not provisioned for the storeContact support to enable performance analytics on the store.
Products list is missing items you expectShopify added products to the collection after the last syncUse Sync Products from the page header. See Manually resync a single collection.
Default sort order didn’t apply on the storefrontA merchandising rule with a different sort order is winning for the collectionCheck the Merchandising Rules sidebar for an enabled rule that overrides the default. See Multiple rules per collection.

​
Next steps