# Layers

## Docs

- [Tracking API: Capture Events](https://docs.uselayers.com/api-reference/beacon.md): Tracking API endpoint for capturing storefront events such as product views, add-to-cart actions, and checkout steps used to power Layers analytics.
- [Blocks API: Get Block Products](https://docs.uselayers.com/api-reference/blocks.md): Blocks API endpoint that returns product recommendations for a specific block using its configured strategy, fallback chain, and merchandising rules.
- [Browse API: Browse Collection Page](https://docs.uselayers.com/api-reference/browse.md): Browse API endpoint to fetch, filter, sort, and paginate merchandised collection pages in your catalog with facets, pins, and personalization applied.
- [Facets API: Get Collection Facets](https://docs.uselayers.com/api-reference/facets.md): Facets API endpoint that returns facet values and result counts for a collection without running a full browse query, ideal for filter sidebars.
- [Autocomplete: Get Suggestions](https://docs.uselayers.com/api-reference/predict.md): Autocomplete API endpoint returning real-time suggestions, top products, and curated terms as shoppers type queries in your storefront search bar.
- [Text Search: Execute Search](https://docs.uselayers.com/api-reference/search.md): Text Search API endpoint to run semantic product searches with typo tolerance, query understanding, faceting, and personalization across your catalog.
- [Content Search: Execute Search](https://docs.uselayers.com/api-reference/search-content.md): Content Search API endpoint to run semantic searches across blog articles, knowledge base pages, and other content using AI similarity matching.
- [Text Search: Submit Feedback](https://docs.uselayers.com/api-reference/search-feedback.md): Search Feedback API endpoint to submit shopper signals such as result clicks, conversions, and dismissals that train search relevance ranking.
- [Image Search: Execute Search](https://docs.uselayers.com/api-reference/search-image.md): Image Search API endpoint to run visual searches across your product catalog using uploaded image IDs or base64-encoded image payloads.
- [Text Search: Prepare Search](https://docs.uselayers.com/api-reference/search-prepare.md): Prepare Search API endpoint that starts a search asynchronously so personalization and ranking can run in the background during a redirect or page load.
- [Search API: Similar Products](https://docs.uselayers.com/api-reference/similar-products.md): Similar Products API endpoint that returns visually and semantically related items to a given product using image and text embeddings from your catalog.
- [Sort Orders API: Get Available Sort Orders](https://docs.uselayers.com/api-reference/sort-orders.md): Sort Orders API endpoint listing all configured sort orders for your store, including IDs and labels you can pass to browse and search requests.
- [Image Search: Upload Image](https://docs.uselayers.com/api-reference/upload-image.md): Image Upload API endpoint that accepts a binary image and returns an image ID you can pass into the Image Search endpoint for visual product lookup.
- [Product attributes: core concepts](https://docs.uselayers.com/core-concepts/attributes.md): Attributes are the foundation of the Layers platform — they define what your products are made of and how they can be searched, filtered, and sorted.
- [Merchandising](https://docs.uselayers.com/core-concepts/merchandising.md): Merchandising rules give you manual and automated control over how products are displayed on collection pages, layered on top of your sort orders.
- [Search](https://docs.uselayers.com/core-concepts/search.md): How Layers processes search queries using ranking signals, query understanding, and contextual awareness to deliver relevant product results.
- [Sorting](https://docs.uselayers.com/core-concepts/sorting.md): Sort orders determine how products are ranked on collection pages using attributes, priority rules, weighted groups, and soft boost.
- [Implementing search in Liquid](https://docs.uselayers.com/developers/implementing-search-in-liquid.md): Build a Shopify theme search experience with Layers using the prepare/execute flow, autocomplete suggestions, faceted filtering, and sort orders rendered from metaobjects.
- [JSONLogic](https://docs.uselayers.com/developers/jsonlogic.md): Reference guide to JSONLogic syntax, operators, and patterns for building computed attributes, expression-based rules, and data transformations in Layers.
- [Custom Layers operators](https://docs.uselayers.com/developers/jsonlogic/custom-operators.md): Custom JSONLogic operators designed for e-commerce use cases, including string manipulation, date parsing, counting, and time calculations.
- [Examples & best practices](https://docs.uselayers.com/developers/jsonlogic/examples.md): JSONLogic examples for common ecommerce scenarios — pricing tiers, inventory flags, badge logic — plus best practices for writing maintainable formulas.
- [Standard operators](https://docs.uselayers.com/developers/jsonlogic/standard-operators.md): Complete reference for standard JSONLogic operators supported in Layers, including data access, logic, comparison, arithmetic, array, and string operations.
- [Liquid integration](https://docs.uselayers.com/developers/liquid-integration.md): How to access Layers metaobjects, metafields, and configuration values directly in your Shopify theme using Liquid templates and snippet helpers.
- [MCP servers](https://docs.uselayers.com/developers/mcp-servers.md): Connect AI assistants like Claude or ChatGPT to Layers using Model Context Protocol (MCP) servers for store management and storefront operations.
- [Developers overview](https://docs.uselayers.com/developers/overview.md): Overview of Layers developer tools, including REST APIs, the JavaScript SDK, JSONLogic, Liquid integration, and MCP servers for AI assistants.
- [Rendering facets in Liquid](https://docs.uselayers.com/developers/rendering-facets-in-liquid.md): Render filter sidebars in a Shopify theme by combining Layers facet metaobjects with the Facets API so only available values, counts, and ranges are shown.
- [Rendering sort orders in Liquid](https://docs.uselayers.com/developers/rendering-sort-orders-in-liquid.md): Render the Layers sort order dropdown in a Shopify theme by reading sort metaobjects in Liquid, applying scope and default-sort rules, and passing the selected code to the Browse and Search APIs.
- [SDK changelog](https://docs.uselayers.com/developers/sdk/changelog.md): Release history and changelog entries for the @commerce-blocks/sdk package, including new features, breaking changes, and bug fixes for each version.
- [Upgrade guide: v1 to v2](https://docs.uselayers.com/developers/sdk/upgrade-v2.md): Step-by-step migration guide from @commerce-blocks/sdk v1 to v2, covering renamed methods, breaking API changes, and recommended upgrade patterns.
- [Contextual information](https://docs.uselayers.com/engine/contextual-information.md): How Layers uses shopper context — cart contents, purchase history, location, and Shopify Markets — to personalize search and browse results in real time.
- [Context data structure](https://docs.uselayers.com/engine/contextual-information/data-structure.md): Reference for the context payload — geography, cart, purchase history, marketing attribution, customer profile, and market fields used to personalize search.
- [Usage & privacy](https://docs.uselayers.com/engine/contextual-information/usage-and-privacy.md): How contextual data influences search ranking and personalization in Layers, plus privacy guidelines, data retention rules, and PII handling considerations.
- [Filtering language](https://docs.uselayers.com/engine/filtering.md): How to construct complex and nested filter expressions for the Search and Browse APIs, including comparison operators, boolean groups, and field selectors.
- [Query interpretation](https://docs.uselayers.com/engine/query-interpretation.md): How Layers parses search queries to correct typos, route non-product queries to the right page, and detect SKU lookups before generating results.
- [Supported languages](https://docs.uselayers.com/engine/supported-languages.md): Languages supported by Layers' multilingual search models, including locale codes, query understanding, and tokenization behavior per language.
- [Typo tolerance](https://docs.uselayers.com/engine/typo-tolerance.md): How Layers corrects spelling mistakes, expands acronyms, and fixes typing errors to help customers find products even when queries contain typos.
- [Query understanding](https://docs.uselayers.com/engine/user-intent-processing.md): How Layers interprets search queries to understand what customers really want, using query expansion, intent detection, and contextual awareness.
- [Group facet values](https://docs.uselayers.com/help/advanced-merchandising/facet-grouping.md): Organize long facet value lists like colors, sizes, or brands into shopper-friendly groups so customers can filter collection pages more efficiently.
- [Hide facet values](https://docs.uselayers.com/help/advanced-merchandising/facet-hiding.md): Hide specific facet values from shoppers on the storefront while keeping them visible in the Layers dashboard for internal merchandising and reporting.
- [Sort facet values](https://docs.uselayers.com/help/advanced-merchandising/facet-sorting.md): Control the order facet values appear to shoppers on collection pages, with options for alphabetical, count-based, and custom ordering across grouped facets.
- [Manage blocks in bulk](https://docs.uselayers.com/help/blocks/bulk-actions.md): Publish, unpublish, duplicate, or delete multiple recommendation blocks at once from the Blocks list using bulk select, filters, and the table toolbar actions.
- [View block performance](https://docs.uselayers.com/help/blocks/view-performance.md): Open the performance sheet for a recommendation block to review KPIs, trends, position effects, and top-performing products over selectable date ranges.
- [Manually resync your entire catalog](https://docs.uselayers.com/help/catalog/resync-catalog.md): Trigger a full product catalog resync from the Catalog page in Layers to refresh every product, variant, and metafield without contacting support.
- [Manually resync a single collection](https://docs.uselayers.com/help/catalog/resync-single-collection.md): Manually resync a single Shopify collection in Layers to refresh its product list and ordering without reindexing your entire catalog or other collections.
- [Manually resync a single product](https://docs.uselayers.com/help/catalog/resync-single-product.md): Manually resync a single product in Layers to refresh its title, variants, inventory, and metafields without reindexing the rest of your catalog.
- [View collection details and performance](https://docs.uselayers.com/help/catalog/view-collection-details.md): Open a collection to review its products, set its default sort order, jump to its merchandising rules, and inspect engagement and revenue performance.
- [View product details](https://docs.uselayers.com/help/catalog/view-product-details.md): Open a product from the Products list to inspect its media, variants, metafields, and Shopify metadata in a focused dashboard view.
- [Working with dates](https://docs.uselayers.com/help/catalog/working-with-dates.md): Learn how to work with date fields in Layers, including formats, filtering by date ranges, sorting, and ingesting dates from tags and metafields.
- [Configure autocomplete curation](https://docs.uselayers.com/help/configuration/configure-autocomplete-curation.md): Write a natural-language brand prompt that tells Layers which autocomplete suggestions to surface, how to label them, and which terms to suppress.
- [Configure search behavior](https://docs.uselayers.com/help/configuration/configure-search-behavior.md): Choose how text search and image search behave in your store, including typo tolerance, ranking signals, and fallback behavior on zero-result queries.
- [Manage API access](https://docs.uselayers.com/help/configuration/manage-api-access.md): Create, rotate, and revoke API tokens for developers who integrate your storefront with the Layers Search, Browse, Blocks, and Beacon APIs.
- [Manage team members](https://docs.uselayers.com/help/configuration/manage-team-members.md): Invite teammates to your Layers store, manage roles and store access, and respond to in-app invite notifications from the team settings page.
- [Navigate settings](https://docs.uselayers.com/help/configuration/navigate-settings.md): Find and open every store configuration page in Layers — search behavior, facets, team, API access, and pixels — from the central settings overview.
- [View GDPR requests](https://docs.uselayers.com/help/configuration/view-gdpr-requests.md): Monitor GDPR customer data requests and redaction requests received from Shopify and review their status inside the Layers privacy settings page.
- [Test collections and similar products](https://docs.uselayers.com/help/evaluate/test-collections-and-similar-products.md): Use the Lab tools in Layers to inspect collection browse results and similar product recommendations for a fast merchandising quality check.
- [Test image search](https://docs.uselayers.com/help/evaluate/test-image-search.md): Upload an image in the Layers dashboard to test image search and preview the visually similar products shoppers will see on the storefront.
- [Test text search (with demo profiles)](https://docs.uselayers.com/help/evaluate/test-text-search.md): Try text searches as different customer personas, tune search parameters, and inspect how queries are processed by the Layers ranking pipeline.
- [Audit Log](https://docs.uselayers.com/help/lab/audit-log.md): Inspect each AI search decision, the shopper session it affected, and the signals that drove the change.
- [Experiments](https://docs.uselayers.com/help/lab/experiments.md): Review search gaps the engine flagged so you can investigate coverage issues and suggested fixes.
- [Lab overview](https://docs.uselayers.com/help/lab/overview.md): Use Lab to monitor search decisions, replay searches, and test search quality before shoppers see changes.
- [Manage merchandising rules in bulk](https://docs.uselayers.com/help/merchandising/bulk-actions.md): Publish, unpublish, or delete multiple merchandising rules at once from the Merchandise list using bulk select, filters, and the table toolbar actions.
- [Manage variant breakouts in bulk](https://docs.uselayers.com/help/merchandising/bulk-actions-variant-breakouts.md): Publish or unpublish multiple variant breakouts from the Variant Breakouts list, or toggle a single breakout's status from the row actions menu.
- [Create a merchandising rule](https://docs.uselayers.com/help/merchandising/create-merchandising-rule.md): Curate a Shopify collection page in Layers by pinning specific products to positions and grouping items with simple expression-based merchandising rules.
- [Create a semantic redirect](https://docs.uselayers.com/help/merchandising/create-semantic-redirect.md): Step-by-step guide to creating a semantic redirect in the Layers dashboard so search queries are routed to specific pages using AI intent matching.
- [Create a variant breakout](https://docs.uselayers.com/help/merchandising/create-variant-breakout.md): Create a variant breakout in Layers to display product variants as individual tiles on collection pages and search results for richer browsing.
- [Dynamic linking for ads](https://docs.uselayers.com/help/merchandising/dynamic-linking.md): Use dynamic linking to pin products to the top of collection pages during ad campaigns so shoppers land on the exact items featured in your creative.
- [Edit or delete a variant breakout](https://docs.uselayers.com/help/merchandising/edit-delete-variant-breakout.md): Modify or remove an existing variant breakout configuration in Layers, including edits to scope, targeting rules, and display formatting on collection pages.
- [Edit, disable, or delete a merchandising rule](https://docs.uselayers.com/help/merchandising/edit-disable-delete-merchandising-rule.md): Update, disable, or delete an existing merchandising rule in Layers to pause it temporarily, edit pins and conditions, or remove it from a collection.
- [Recover a deleted merchandising rule](https://docs.uselayers.com/help/merchandising/restore-deleted-merchandising-rule.md): Restore a previously deleted merchandising rule from the Merchandise page using the Show Deleted filter and the Restore action in the table toolbar.
- [View merchandising rule performance](https://docs.uselayers.com/help/merchandising/view-rule-performance.md): Open the performance sheet for an active merchandising rule to review KPIs, conversion trends, and top-performing products over selectable date ranges.
- [Creating a crawler signature](https://docs.uselayers.com/help/onboarding/creating-crawler-signature.md): Create a Shopify crawler signature and share it with Layers to enable authenticated image fetching and accelerate the initial product media sync.
- [Dashboard home](https://docs.uselayers.com/help/onboarding/dashboard-home.md): Use the Home page to see headline storefront metrics, period comparisons, product updates, and quick links to every area of the Layers dashboard.
- [Exporting search data](https://docs.uselayers.com/help/onboarding/exporting-search-data.md): Export historical search data from Shopify and send it to Layers to seed your store with prior queries, click data, and conversions for ranking models.
- [Install](https://docs.uselayers.com/help/onboarding/install.md): What to expect after installing Layers from the Shopify App Store, including the catalog sync, onboarding checklist, and first steps to launch search.
- [Demo store setup](https://docs.uselayers.com/help/onboarding/setting-up-a-demo-store.md): Set up a demo store on Layers including app installation, crawler signature configuration, and importing seed search data so you can evaluate features.
- [Manage product families in bulk](https://docs.uselayers.com/help/product-families/bulk-actions.md): Publish, unpublish, or delete multiple product families at once from the Product Families list using bulk select and the table toolbar actions.
- [Create a product family](https://docs.uselayers.com/help/product-families/create-product-family.md): Create a product family in Layers to group related products so merchandising rules, diversity expressions, and analytics treat them as a single unit.
- [Manage ranking rules in bulk](https://docs.uselayers.com/help/ranking-relevancy/bulk-actions.md): Publish, unpublish, or delete multiple ranking rules at once from the Ranking Rules list using bulk select and the table toolbar actions.
- [Create a ranking rule](https://docs.uselayers.com/help/ranking-relevancy/create-ranking-rule.md): Create a ranking rule in Layers to promote, demote, pin, or sort products in search results based on query patterns, filters, and shopper conditions.
- [Tune signal weights](https://docs.uselayers.com/help/ranking-relevancy/tune-signal-weights.md): Adjust how much each ranking signal group — text relevance, popularity, recency, and personalization — contributes to your store's search result ordering.
- [Manage product sequences in bulk](https://docs.uselayers.com/help/sequences/bulk-actions.md): Publish, unpublish, or delete multiple product sequences at once from the Product Sequences list using bulk select and the table toolbar actions.
- [Create a product sequence](https://docs.uselayers.com/help/sequences/create-product-sequence.md): Create a product sequence in Layers to keep related items together on collection pages and search results so they always appear side-by-side.
- [Edit a product sequence](https://docs.uselayers.com/help/sequences/edit-product-sequence.md): Edit an existing product sequence in Layers to update its members, the display order of items, or the targeting conditions that control where it applies.
- [Manage sort orders in bulk](https://docs.uselayers.com/help/sort-orders/bulk-actions.md): Publish, unpublish, duplicate, edit, or delete multiple sort orders at once from the Sort Orders list using bulk select and the table toolbar actions.
- [Create a sort order](https://docs.uselayers.com/help/sort-orders/create-sort-order.md): Create a sort order in Layers to control how products rank on collection pages, combining metrics, signals, and priority rules into one configurable order.
- [Duplicate a sort order](https://docs.uselayers.com/help/sort-orders/duplicate-sort-order.md): Duplicate an existing sort order in Layers as a starting point for a new variation, copying its metrics, priority rules, and segmentation settings.
- [Preview a sort order](https://docs.uselayers.com/help/sort-orders/preview-sort-order.md): Preview a sort order on a real collection before publishing it live, with per-product scoring annotations that explain why each item placed where it did.
- [Reorder sort orders](https://docs.uselayers.com/help/sort-orders/reorder-sort-orders.md): Change the order in which sort orders appear inside the storefront sort dropdown to highlight your preferred default and most relevant options first.
- [Layers for Shopify Plus: search and merchandising](https://docs.uselayers.com/introduction.md): Layers gives Shopify Plus merchants everything they need to power lightning-fast search, visual discovery, and intelligent merchandising at scale.
- [Report abuse](https://docs.uselayers.com/legal/abuse.md): How to report abuse, fraud, or violations of the Layers terms of service, including which information to include and how the security team responds.
- [Compliance](https://docs.uselayers.com/legal/compliance.md): Security certifications, audits, and compliance standards Layers maintains, including SOC 2, GDPR readiness, and the partner program for enterprise customers.
- [Legal Information](https://docs.uselayers.com/legal/legal-information.md): Corporate identity, legal form, registered office, and contact details for Building Blocks For eCommerce, Inc., the entity operating the Layers platform.
- [Privacy Statement](https://docs.uselayers.com/legal/privacy-statement.md): How Layers collects, uses, retains, and shares personal data, plus your privacy rights, controls, and choices over the information we process about you.
- [Security Disclosure](https://docs.uselayers.com/legal/security-disclosure.md): Responsible disclosure policy explaining how to report security vulnerabilities to Layers, what scope is covered, and how researchers receive responses.
- [Service Level Agreement (SLA)](https://docs.uselayers.com/legal/service-level-agreement.md): Layers uptime commitments for the Search and Browse APIs, including the 99.99% monthly target, service credit calculations, exclusions, and claim process.
- [Infrastructure & Sub-Processors](https://docs.uselayers.com/legal/sub-processors.md): List of cloud providers, data centers, and third-party sub-processors that Layers uses to deliver its search, analytics, and merchandising services.
- [Terms of Use](https://docs.uselayers.com/legal/terms-of-use.md): Terms and conditions governing use of the Layers websites, services, and products, including account responsibilities, payments, content rules, and termination.
- [AI enablement](https://docs.uselayers.com/platform/ai-enablement.md): Access Layers documentation through AI-friendly formats including llms.txt, MCP servers, and structured exports designed for assistants and code agents.
- [Manage attributes in the Layers dashboard](https://docs.uselayers.com/platform/attributes.md): Manage searchable, filterable, and sortable product attributes in Layers to power facets, ranking, and merchandising across your search and browse experience.
- [Attribute classes](https://docs.uselayers.com/platform/attributes/attribute-classes.md): Classify attributes as categorical, feature, or price so the Layers search engine applies the correct ranking, faceting, and weighting per data type.
- [Attribute options](https://docs.uselayers.com/platform/attributes/attribute-options.md): Configure how attributes behave across the platform: searchable, filterable, sortable, keyword weight, API visibility, and storefront facet sync.
- [Computed attributes](https://docs.uselayers.com/platform/attributes/calculated-attributes.md): Create dynamic product attributes in Layers with Functions, derived attributes, and legacy JSONLogic formulas.
- [Computed attribute recipes](https://docs.uselayers.com/platform/attributes/calculated-attributes/recipes.md): Built-in Function templates for common computed attributes, including discounts, variant counts, margins, and catalog health checks.
- [Catalog attributes](https://docs.uselayers.com/platform/attributes/catalog-attributes.md): Catalog attributes reference fields from your Shopify product data. Learn about attribute codes, nested metafield keys, and automatic metafield creation.
- [Functions](https://docs.uselayers.com/platform/attributes/functions.md): Use JavaScript Functions to create computed product attributes from selected Shopify product data.
- [Autocomplete curation](https://docs.uselayers.com/platform/autocomplete-curation.md): Use a natural-language brand prompt to control which autocomplete suggestions appear, how they are labeled, and which queries are suppressed in search.
- [Blocks](https://docs.uselayers.com/platform/blocks.md): Configurable product recommendation widgets that surface personalized suggestions based on shopper behavior, product similarity, or curated collections.
- [Fallback chains](https://docs.uselayers.com/platform/blocks/fallback-chains.md): Configure fallback chains and conditional fallback trees so customers always see recommendations when a primary block returns too few products.
- [Priority & status](https://docs.uselayers.com/platform/blocks/priority-and-status.md): Control how recommendation blocks are evaluated using priority ordering and manage their lifecycle through draft, published, and archived statuses.
- [Rules & safeguards](https://docs.uselayers.com/platform/blocks/rules-and-safeguards.md): Configure block rules for conditional recommendation behavior and add safeguards that enforce minimum and maximum product counts before a block is shown.
- [Strategies](https://docs.uselayers.com/platform/blocks/strategies.md): Reference for recommendation block strategies in Layers, including interaction-based, similarity-based, collection interaction, and manual curation types.
- [Filters / facets](https://docs.uselayers.com/platform/facets.md): Configure rich facets and filters in Layers — value grouping, sorting, hiding, and dependencies — to give shoppers a fast, expectation-beating filter UX.
- [Datasets](https://docs.uselayers.com/platform/layersql/datasets.md): LayersQL provides multiple datasets — products, sales, blocks, collections, and search — that you query with SQL-like syntax for ecommerce analytics.
- [Blocks dataset](https://docs.uselayers.com/platform/layersql/datasets/blocks.md): LayersQL Blocks dataset reference for analyzing recommendation block requests, impressions, clicks, and conversions across strategies and fallback chains.
- [Collections dataset](https://docs.uselayers.com/platform/layersql/datasets/collections.md): LayersQL Collections dataset reference for analyzing browse traffic, page views, conversion rates, and revenue across your store's collection pages.
- [Products dataset](https://docs.uselayers.com/platform/layersql/datasets/products.md): LayersQL Products dataset reference covering catalog attributes and performance metrics — views, sales, returns, and velocity — at the product level.
- [Sales dataset](https://docs.uselayers.com/platform/layersql/datasets/sales.md): LayersQL Sales dataset reference for querying order-level purchase metrics including line items, revenue, returns, and customer attribution windows.
- [Search (image) dataset](https://docs.uselayers.com/platform/layersql/datasets/search-image.md): LayersQL Search (image) dataset reference for analyzing image search queries, uploaded image IDs, click-through rates, and conversions over time.
- [Search (similar) dataset](https://docs.uselayers.com/platform/layersql/datasets/search-similar.md): LayersQL Search (similar) dataset reference for analyzing similar product API requests, source products, click-through rates, and downstream conversions.
- [Search (text) dataset](https://docs.uselayers.com/platform/layersql/datasets/search-text.md): LayersQL Search (text) dataset reference for analyzing text search queries grouped by canonical term, with metrics for clicks, conversions, and zero results.
- [Functions](https://docs.uselayers.com/platform/layersql/functions.md): Reference of LayersQL aggregation functions — SUM, COUNT, AVG, percentiles, and rates — usable in the SHOW clause to compute metrics over grouped rows.
- [LayersQL: query language for Layers analytics](https://docs.uselayers.com/platform/layersql/overview.md): Overview of LayersQL, the domain-specific query language for Layers analytics, with syntax, datasets, and how to write queries for sort orders and metrics.
- [Syntax](https://docs.uselayers.com/platform/layersql/syntax.md): Syntax reference for LayersQL queries — SELECT, SHOW, GROUP BY, WHERE, and time windows — with predictable structure for ecommerce analytics queries.
- [Merchandising rules](https://docs.uselayers.com/platform/merchandising.md): Target collection pages and sort orders to pin, group, and reorder products using expressions, with the original sort applying to anything not matched.
- [Contextual conditions](https://docs.uselayers.com/platform/merchandising/contextual-conditions.md): Control when merchandising rules apply based on visitor session data like geographic location, customer attributes, and marketing channels.
- [Diversity expressions](https://docs.uselayers.com/platform/merchandising/diversity.md): Cap how many products from the same product family appear at the top of a collection so the first page represents a broader assortment.
- [Draft products & filtering](https://docs.uselayers.com/platform/merchandising/draft-and-filtering.md): Work with draft products in merchandising rules, disable variant breakouts per rule, filter products, and preview rules on your storefront.
- [Expressions & automation](https://docs.uselayers.com/platform/merchandising/expressions.md): Use expressions and soft boost in Layers merchandising rules to automatically group, prioritize, and interleave products without manual pinning.
- [Featured media override](https://docs.uselayers.com/platform/merchandising/featured-media.md): Override which image appears on collection page tiles for pinned products in Layers merchandising rules to highlight campaign-specific lifestyle imagery.
- [Multiple rules per collection](https://docs.uselayers.com/platform/merchandising/multiple-rules.md): Create multiple merchandising rules per collection with first-match-wins evaluation, conflict detection, and visibility into which rule applies to each shopper.
- [Pins & media overrides](https://docs.uselayers.com/platform/merchandising/pins.md): Configure conditional pins, default variant selection, and featured media overrides for merchandised products to control collection page presentation.
- [Previewing rules](https://docs.uselayers.com/platform/merchandising/preview.md): Preview merchandising rules on your live storefront before saving or publishing to verify pins, expressions, and targeting settings render correctly.
- [Rule scheduling](https://docs.uselayers.com/platform/merchandising/scheduling.md): Automatically enable and disable merchandising rules based on time windows for promotions, seasonal campaigns, and product launches.
- [Sell-out pin deletion](https://docs.uselayers.com/platform/merchandising/sell-out-deletion.md): Automatically remove pinned products when they sell out, with support for per-rule toggles and location-based inventory filtering.
- [Soft boost expressions](https://docs.uselayers.com/platform/merchandising/soft-boost-expressions.md): Use soft boost expressions in Layers merchandising rules to interleave products naturally using decaying boost multipliers instead of fixed positions.
- [Metrics](https://docs.uselayers.com/platform/metrics.md): Understand the performance metrics Layers provides — sales, views, conversions, returns, velocity — and how they power sort orders and merchandising rules.
- [Creating metrics & best practices](https://docs.uselayers.com/platform/metrics/creating-and-best-practices.md): How to create custom LayersQL and imported metrics in Layers, configure refresh schedules, and apply best practices for naming, scope, and query optimization.
- [Metric recipes](https://docs.uselayers.com/platform/metrics/recipes.md): Pre-configured metric recipes for common LayersQL and ShopifyQL use cases — sales, views, carts, returns, and velocity — that you can copy into your store.
- [Product families](https://docs.uselayers.com/platform/product-families.md): Group related products (like color variants of the same style) into families so merchandising and sort orders can reason about them as a unit.
- [Ranking relevancy](https://docs.uselayers.com/platform/ranking-relevancy.md): Control how search results are ranked by tuning signal weights and creating ranking rules that promote, demote, pin, or sort products.
- [Real-time collaboration](https://docs.uselayers.com/platform/real-time-collaboration.md): Work on merchandising rules and sort orders simultaneously with your team using live cursors, field locking, threaded comments, and in-app notifications.
- [Search rules](https://docs.uselayers.com/platform/search-rules.md): Dynamically modify search requests based on targeting conditions to apply query transformations, filter injections, and sort overrides across search types.
- [Semantic redirects](https://docs.uselayers.com/platform/semantic-redirects.md): How semantic redirects use AI to route shopper search queries to landing pages or collections based on intent rather than exact keyword matches.
- [Product sequences](https://docs.uselayers.com/platform/sequences.md): Create product sequences in Layers to show paired or grouped items next to each other across one or many collection pages for a consistent browsing experience.
- [Sort orders](https://docs.uselayers.com/platform/sorting.md): Create and manage sort orders for Shopify collection pages in Layers, combining metrics, signals, and priority rules to power best-in-class browsing.
- [Preview & annotations](https://docs.uselayers.com/platform/sorting/preview.md): Preview sort orders in Layers with sort effect annotations that show which priority rules and metrics influenced each product's final ranking position.
- [Priority rule examples](https://docs.uselayers.com/platform/sorting/priority-rule-examples.md): Worked examples of promoting, demoting, and combining priority rules inside Layers sort orders, including new arrivals, sale items, and inventory boosts.
- [Priority rules](https://docs.uselayers.com/platform/sorting/priority-rules.md): Use priority rules in Layers sort orders to force products to the top or bottom of results with hard override behavior based on conditions and tags.
- [Sort order recipes](https://docs.uselayers.com/platform/sorting/recipes.md): Pre-configured Layers sort order recipes for common merchandising patterns — best selling, newest, price sorting, and stock-aware ordering — ready to copy.
- [Segmented & conditional sorting](https://docs.uselayers.com/platform/sorting/segmented-sorting.md): Personalize product rankings in Layers using segmented metrics and conditional sort expressions tied to visitor location, device, or traffic source.
- [Soft boost](https://docs.uselayers.com/platform/sorting/soft-boost.md): Lift matching products toward a target value with soft boost sorting using multiplicative or additive modes for natural ranking control.
- [Variant breakouts](https://docs.uselayers.com/platform/variant-breakouts.md): Display products as individual variant tiles on collection pages and search results so customers can browse and compare specific colors and sizes.
- [API impact & use cases](https://docs.uselayers.com/platform/variant-breakouts/api-impact.md): How variant breakouts in Layers affect API responses, pagination, facets, filtering, and sorting, plus common ecommerce use cases for variant-level browsing.
- [Configuration & behavior](https://docs.uselayers.com/platform/variant-breakouts/configuration.md): Configure variant breakout options in Layers including scope, targeting rules, title formatting templates, and out-of-stock behavior on collection pages.
- [SDK API reference](https://docs.uselayers.com/sdk/api-reference.md): Complete reference for the Layers SDK covering controllers, methods, response types, error handling, filtering DSL, caching, and storage adapters.
- [Cache, storage, and signals](https://docs.uselayers.com/sdk/api-reference/cache-and-storage.md): Reference for the Layers SDK client cache, storage adapters for persistence, reactive signal primitives, singleton access, and other technical SDK details.
- [Client methods](https://docs.uselayers.com/sdk/api-reference/client-methods.md): Reference for every Layers SDK client controller method, the product card controller, request abort signals, and recommended usage patterns by framework.
- [Filtering](https://docs.uselayers.com/sdk/api-reference/filtering.md): Build filters using the Layers SDK filter DSL, configure filter aliases at client initialization, and combine boolean groups with comparison operators.
- [Response types and error handling](https://docs.uselayers.com/sdk/api-reference/responses-and-errors.md): Reference for shared response shapes returned by Layers SDK controllers, the complete product model, and the tagged error model used for error handling.
- [Best practices](https://docs.uselayers.com/sdk/best-practices.md): Essential patterns and common pitfalls when working with the Layers SDK, covering initialization, state management, caching, and request lifecycle handling.
- [Caching](https://docs.uselayers.com/sdk/caching.md): How the Layers SDK handles caching, request deduplication, and persistence to local storage so your storefront feels fast and avoids duplicate API calls.
- [Error handling](https://docs.uselayers.com/sdk/error-handling.md): Handle errors gracefully when using the Layers SDK with the tagged error model, retry strategies, and recommended UX patterns for network failures.
- [Framework integration](https://docs.uselayers.com/sdk/framework-integration.md): Patterns for consuming Layers SDK reactive state in React, Vue, Svelte, Lit, and vanilla JavaScript, including hooks, stores, and signal subscriptions.
- [Installation](https://docs.uselayers.com/sdk/installation.md): Install and configure the Layers SDK in your project, including package manager setup, client initialization, and TypeScript type generation.
- [SDK overview](https://docs.uselayers.com/sdk/overview.md): Overview of the Layers SDK — an ES module library for product discovery, search, browse, and recommendations powered by the Layers API.
- [Performance](https://docs.uselayers.com/sdk/performance.md): Optimization techniques for faster Layers SDK search and browse experiences, including prefetching, request deduplication, caching, and bundle size tips.
- [Search patterns](https://docs.uselayers.com/sdk/search-patterns.md): Advanced Layers SDK search patterns including prepare and execute flows, search ID management, debouncing input, and handling stale or aborted requests.
- [Set up Agentic Feedback for AI agents](https://docs.uselayers.com/shopify-integration/agentic-feedback-llms.md): Add Layers Agentic Feedback instructions to your Shopify llms.txt file so AI agents can report specific search and discovery issues through the Layers app proxy.
- [Catalog sync](https://docs.uselayers.com/shopify-integration/catalog-sync.md): How Layers keeps your Shopify catalog up to date through Webhooks and Bulk Operations whenever products are created, updated, or deleted in your store.
- [Crawler signatures](https://docs.uselayers.com/shopify-integration/crawler-signatures.md): Enable authenticated image fetching from Shopify using HTTP signatures, with automatic proxy fallback so Layers can sync product media reliably at scale.
- [Discount entitlements](https://docs.uselayers.com/shopify-integration/discount-entitlements.md): Apply dynamic discounts to products in Layers search and browse results through the Abra Promotions integration, including price overrides and badge logic.
- [Metaobjects & metafields](https://docs.uselayers.com/shopify-integration/metaobjects-metafields.md): Learn about the metaobjects and metafields that Layers creates in your Shopify store to enable seamless integration between the platforms.
- [Collection & app metafields](https://docs.uselayers.com/shopify-integration/metaobjects-metafields/app-metafields.md): Collection metafield used for default sort orders and the app installation metafields Layers uses to power storefront integrations and theme components.
- [Cache, sync & access](https://docs.uselayers.com/shopify-integration/metaobjects-metafields/cache-and-access.md): How Layers caches Shopify metaobjects, resolves nested references, manages synchronization windows, and controls access permissions for storefront reads.
- [Metaobjects](https://docs.uselayers.com/shopify-integration/metaobjects-metafields/metaobjects.md): Sort Order, Facet, and Block metaobjects that Layers automatically creates and manages in your Shopify store to power storefront search and merchandising.
- [Product schema](https://docs.uselayers.com/shopify-integration/product-schema.md): Understand the standardized schema Layers expects for Shopify products to maximize search relevance, browsing efficiency, and merchandising precision.
- [Available attributes for API requests](https://docs.uselayers.com/shopify-integration/product-schema/api-attributes.md): Reference of the product attributes you can request from the Layers Search, Browse, Blocks, and Similar Products APIs, with field types and example values.
- [Metafields](https://docs.uselayers.com/shopify-integration/product-schema/metafields.md): Supported Shopify metafield types in Layers, their structure, namespace conventions, and how to access metafield values as searchable product attributes.
- [Automatic sequences from metafields](https://docs.uselayers.com/shopify-integration/product-schema/metafields/automatic-sequences.md): Use Shopify list.product_reference metafields to automatically create and maintain product sequences in Layers without manual configuration in the dashboard.
- [Metaobjects and reference metafields](https://docs.uselayers.com/shopify-integration/product-schema/metafields/metaobjects-and-references.md): How Layers resolves metaobject references, media references, taxonomy values, and nested reference chains into a normalized shape.
- [Variant & option data](https://docs.uselayers.com/shopify-integration/product-schema/variant-data.md): Understand variant-level data fields including first_or_matched_variant, the full variants array, and the enhanced options_v2 structure.
- [Storefront pixel](https://docs.uselayers.com/shopify-integration/storefront-pixel.md): How the Layers storefront pixel uses a modern attribution algorithm that avoids third-party cookies and keeps the browser footprint light for fast pages.
- [Third-party integrations](https://docs.uselayers.com/shopify-integration/third-party-integrations.md): Connect Layers with your existing analytics and marketing tools — Klaviyo, GA4, and more — through the Integrations dashboard for unified attribution data.

## OpenAPI Specs

- [openapi](https://docs.uselayers.com/api-reference/openapi.json)