# Layers

- [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.
- [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.
- [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.
- [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.
- [Real-time collaboration](https://docs.uselayers.com/platform/real-time-collaboration.md): Edit merchandising rules, sort orders, and facet values with your team using live cursors, field locking, threaded comments, and in-app notifications.
- [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.
- [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.
- [Banner injection](https://docs.uselayers.com/platform/merchandising/banners.md): Inject promotional banners into collection grids as a merchandising-rule consequence: hero banners above the grid or inline tiles alongside products.
- [Banner types](https://docs.uselayers.com/platform/merchandising/banner-types.md): Define the fields merchandising banners carry to your storefront. Reuse typed schemas across rules to render richer promos than image and link.
- [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.
- [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.
- [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.
- [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.
- [Diversity expressions in sort orders](https://docs.uselayers.com/platform/merchandising/diversity.md): Cap how many products share the same family, product type, or attribute in the top window of a collection so the first page shows a broader assortment.
- [Draft products & filtering](https://docs.uselayers.com/platform/merchandising/draft-and-filtering.md): Merchandise draft and scheduled products, disable variant breakouts per rule, and filter large collections from the merchandising grid toolbar.
- [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.
- [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.
- [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.
- [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.
- [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.
- [Recommendation block strategies](https://docs.uselayers.com/platform/blocks/strategies.md): Reference for recommendation block strategies in Layers: interaction, similarity, manual, metafield reference, sequence, set, trending, contextual, and related content.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [Hidden content rules](https://docs.uselayers.com/platform/hidden-products.md): Create rules that hide products, pages, or articles from search, collections, and recommendation blocks based on attribute or metafield conditions.
- [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 all 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.
- [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.
- [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.
- [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.
- [Weighted groups](https://docs.uselayers.com/platform/sorting/weighted-groups.md): Blend several attributes and metrics into one sort score with auto-normalized weights, per-attribute direction, and composable soft boost modifiers.
- [Soft boost](https://docs.uselayers.com/platform/sorting/soft-boost.md): Lift matching products with soft boost sorting using Amplify strong performers or Lift matches into view modes for natural ranking control.
- [Conditional sort expressions](https://docs.uselayers.com/platform/sorting/conditional-expressions.md): Gate a sort term with an Only when condition so products that don't qualify fall through to the next rule instead of ranking on an unreliable signal.
- [Segmented & conditional sorting](https://docs.uselayers.com/platform/sorting/segmented-sorting.md): Personalize product rankings in Layers with segmented metrics, contextual conditions, and per-product 'only when' gates on sort expressions.
- [Preview & annotations](https://docs.uselayers.com/platform/sorting/preview.md): Preview sort orders with per-product annotations that show which priority rules, boosts, sequences, diversity, and metrics shaped each ranking position.
- [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.
- [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.
- [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.
- [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.
- [Search instructions](https://docs.uselayers.com/platform/search-instructions.md): Write natural-language merchandising rules that Layers attaches to every AI step in the search pipeline, from query expansion to result evaluation.
- [Request transforms](https://docs.uselayers.com/platform/request-transforms.md): Dynamically modify search requests based on targeting conditions to apply query transformations, filter injections, and sort overrides across search types.
- [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.
- [Geospatial filtering and distance sort](https://docs.uselayers.com/engine/geospatial-filtering.md): Filter products by geographic radius, polygon, or bounding box, and sort by distance from an origin using geo attributes in Layers.
- [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.
- [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.
- [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.
- [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 Layers context payload: geo, cart, viewed products, purchase history, marketing, customer profile, and market fields for personalized search.
- [Usage & privacy](https://docs.uselayers.com/engine/contextual-information/usage-and-privacy.md): How Layers uses contextual data to influence search ranking and personalization, plus privacy guidelines, data retention, and PII handling notes.
- [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.
- [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.
- [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.
- [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.
- [Attribute classes](https://docs.uselayers.com/platform/attributes/attribute-classes.md): Classify attributes as categorical, feature, price, or identifier so the Layers search engine applies the correct ranking, faceting, and matching per data type.
- [Computed attributes](https://docs.uselayers.com/platform/attributes/calculated-attributes.md): Create computed and derived product attributes in Layers using JavaScript Functions or simple expressions for badges, filters, sorting, and rules.
- [Computed attribute Functions](https://docs.uselayers.com/platform/attributes/functions.md): Write JavaScript Functions in Layers to compute custom product attributes from Shopify data with an input query and typed output schema.
- [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.
- [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.
- [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.
- [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.
- [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.
- [LayersQL syntax reference](https://docs.uselayers.com/platform/layersql/syntax.md): LayersQL clause reference for SHOW, GROUP BY, WHERE, HAVING, time windows, TIMESERIES, COMPARE TO, and VISUALIZE in ecommerce analytics queries.
- [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 datasets and shared dimensions](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.
- [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 (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.
- [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.
- [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.
- [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.
- [Shopify catalog sync: webhooks, metafields, and inventory](https://docs.uselayers.com/shopify-integration/catalog-sync.md): How Layers keeps your Shopify catalog in sync through webhooks and bulk operations when products are created, updated, or deleted.
- [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.
- [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.
- [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.
- [Collection & app metafields](https://docs.uselayers.com/shopify-integration/metaobjects-metafields/app-metafields.md): Collection metafield for default sort orders and the shop-level 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.
- [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.
- [Shopify admin extensions](https://docs.uselayers.com/shopify-integration/shopify-admin-extensions.md): Layers extensions in the Shopify admin: product and collection cards, one-click resync, dashboard links, Sidekick tools, and Shopify Flow automation.
- [Shopify Markets](https://docs.uselayers.com/shopify-integration/shopify-markets.md): How Layers consumes Shopify Markets to localize product availability, prices, and currencies in search, browse, and block results.
- [Shopify B2B Catalogs](https://docs.uselayers.com/shopify-integration/b2b-catalogs.md): Scope Layers search, browse, and block results to a Shopify B2B catalog's products, price list, and collections using identity.companyLocationId.
- [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.
- [Mobile apps (Tapcart, Fuego, Canvas)](https://docs.uselayers.com/shopify-integration/mobile-apps.md): How Layers detects, syncs, and merchandises Shopify mobile app traffic from Tapcart, Fuego, and Mobiloud Canvas across search, browse, blocks, and analytics.
- [Third-party integrations](https://docs.uselayers.com/shopify-integration/third-party-integrations.md): Enable loyalty, analytics, and personalization integrations for Layers like Rivo, Smile.io, LoyaltyLion, Blotout, and Microsoft Clarity from the dashboard.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [Security overview](https://docs.uselayers.com/legal/security-overview.md): How Layers protects store and shopper data, covering AWS infrastructure, encryption, access controls, application security, monitoring, and personnel.
- [AI & your data](https://docs.uselayers.com/legal/ai-data-use.md): How Layers handles shopper and store data in its AI features, including what the storefront pixel captures and what model providers receive.
- [Data lifecycle](https://docs.uselayers.com/legal/data-lifecycle.md): What Layers collects, how long each category of data is retained, and how uninstall, deletion requests, and backup rotation flow through the system.
- [Incident response overview](https://docs.uselayers.com/legal/incident-response.md): How Layers detects, classifies, and communicates about production incidents, including recovery targets for the storefront APIs and live status.
- [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.
- [Install Layers on Shopify](https://docs.uselayers.com/help/onboarding/install.md): What to expect after installing Layers from the Shopify App Store: catalog sync, the automatic search-quality bootstrap, and first steps to launch search.
- [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.
- [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 and crawler signature configuration. The search-quality bootstrap runs automatically on install.
- [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.
- [Exporting search data](https://docs.uselayers.com/help/onboarding/exporting-search-data.md): Layers seeds historical search data automatically on install. Use this manual ShopifyQL export only when you need to supply searches the import missed.
- [Migrate from Boost Commerce](https://docs.uselayers.com/help/onboarding/migrate-from-boost.md): Reference for teams migrating from Boost Commerce Search & Discovery to Layers, with feature mapping for collections, search, analytics, and APIs.
- [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.
- [See how AI reads a product in your catalog](https://docs.uselayers.com/help/catalog/how-ai-sees-this-product.md): Review what Layers indexed for a product, which tags, collections, and metafields were ignored and why, how variants were split, and flag issues.
- [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.
- [Filter the products list](https://docs.uselayers.com/help/catalog/filter-products-list.md): Narrow the Products list by status or product type using the column filters on the catalog table to find the products you want to inspect or resync.
- [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, or sync many collections at once using bulk actions.
- [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, or sync many products at once using bulk actions.
- [Manually resync variant inventory](https://docs.uselayers.com/help/catalog/resync-variant-inventory.md): Refresh inventory levels for a single Shopify variant from the product details page without resyncing the rest of the product or your catalog.
- [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.
- [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.
- [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, with per-product badges that explain which rule, boost, sequence, or metric placed each item.
- [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.
- [Find duplicate sort orders in the dashboard](https://docs.uselayers.com/help/sort-orders/duplicate-detection.md): Layers flags sort orders that share the same setup or produce identical ranked results, so you can prune redundant configurations and tidy the list.
- [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.
- [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.
- [Run a sort order A/B test experiment](https://docs.uselayers.com/help/sort-orders/experiments.md): A/B test sort orders in Layers: split shopper traffic between a control and challengers, then measure conversion, add-to-cart, and revenue lift.
- [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.
- [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 a product sequence in Layers to update its members, change the display order, or adjust the targeting conditions that control where it applies.
- [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.
- [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.
- [Manage API access](https://docs.uselayers.com/help/configuration/manage-api-access.md): Create, rotate, and revoke API tokens for developers integrating your storefront with the Layers Search, Browse, Blocks, and Beacon APIs.
- [Manage outbound webhooks](https://docs.uselayers.com/help/configuration/manage-webhooks.md): Subscribe an HTTPS endpoint to real-time Layers events for merchandising rules, sort orders, and attributes so downstream systems stay in sync.
- [Review developer notices](https://docs.uselayers.com/help/configuration/view-developer-notices.md): Find and fix storefront requests that ask Layers for facets, attributes, or context your store cannot answer, using the Developer Notices page.
- [Manage team members](https://docs.uselayers.com/help/configuration/manage-team-members.md): Invite teammates to your Layers store by email or link, assign roles, manage individual access, transfer ownership, and remove members.
- [Manage roles and permissions](https://docs.uselayers.com/help/configuration/manage-roles-and-permissions.md): Control what each teammate can do in your Layers store with built-in roles, custom roles, a grouped permission picker, and resource-scoped permissions.
- [Manage organizations](https://docs.uselayers.com/help/configuration/manage-organizations.md): Group multiple Layers stores under one organization, invite members with organization roles, and switch between stores from a single account.
- [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.
- [View billing](https://docs.uselayers.com/help/configuration/view-billing.md): Review your Shopify-managed Layers subscription, see plan price and cadence, and accept pending charges from the Billing settings page.
- [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 instructions](https://docs.uselayers.com/help/configuration/configure-search-instructions.md): Use the Layers dashboard to write store-wide merchandising guidance that attaches to every AI step in the search pipeline, with examples and tips.
- [Set up Agentic Feedback for AI agents](https://docs.uselayers.com/help/configuration/set-up-agentic-feedback.md): Add Layers Agentic Feedback instructions to your Shopify llms.txt so AI agents can report search and discovery issues through the app proxy.
- [Manage store knowledge](https://docs.uselayers.com/help/configuration/manage-store-knowledge.md): Write short documents that teach Layers how to interpret your catalog, so the AI keeps the right tags, collections, and metafields.
- [Manage dimensions](https://docs.uselayers.com/help/configuration/manage-dimensions.md): Rename the contextual dimensions Layers records for your store, review coverage, and see the values your storefront actually sends.
- [Config history and version restore](https://docs.uselayers.com/help/configuration/config-history.md): Review a timeline of changes to your merchandising rules, ranking rules, request transforms, and sort orders, and restore a previous version when needed.
- [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.
- [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.
- [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.
- [Lab Insights for trends, anomalies, and opportunities](https://docs.uselayers.com/help/lab/insights.md): Use the Insights page in Lab to see trends, revenue attribution, anomalies, and opportunities Layers detected in your recent shopper activity.
- [Analytics dashboards](https://docs.uselayers.com/help/analytics/dashboards.md): Explore saved Analytics dashboards in Layers. Set date ranges, compare periods, and drill into product, collection, block, and search-term performance.
- [Weekly performance report email](https://docs.uselayers.com/help/analytics/weekly-report-email.md): Get an automated weekly email from Layers on Mondays that summarizes your storefront's search and merchandising performance for the past 7 days.
- [Lab Search quality optimizations](https://docs.uselayers.com/help/lab/search-quality.md): Review the search-quality optimizations Layers is testing for your store, see the source signal behind each one, and track progress from Reviewing to Live.
- [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 the Layers ranking pipeline processes queries.
- [Test image search](https://docs.uselayers.com/help/evaluate/test-image-search.md): Upload an image or select one from Shopify media, drag to crop, and preview the visually similar products and ranking scores shoppers will see.
- [Test content search with the API](https://docs.uselayers.com/help/evaluate/test-content-search.md): Run content search requests against your blog articles, knowledge base, and pages, then use response scores to understand result ordering.
- [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.
- [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.
- [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.
- [Add a banner to a merchandising rule](https://docs.uselayers.com/help/merchandising/add-banner-to-rule.md): Embed a promotional banner into a Shopify collection grid from a merchandising rule as a full-width hero or inline tile, with per-device media.
- [Create a banner type](https://docs.uselayers.com/help/configuration/create-banner-type.md): Define a reusable field schema for merchandising banners so promos carry structured data like headlines, dates, and product references.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [View the products behind a facet value](https://docs.uselayers.com/help/advanced-merchandising/facet-value-products.md): Open a product list for any facet value on the Faceting tab to see exactly which searchable products a filter option covers before you group or hide it.
- [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 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.
- [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.
- [Layers developer tools and integration options](https://docs.uselayers.com/developers/overview.md): Overview of Layers developer tools, including REST APIs, the JavaScript SDK, Liquid integration, and MCP servers for AI assistants.
- [SDK overview](https://docs.uselayers.com/sdk/overview.md): Overview of the Layers SDK - an ES module library for product discovery, search, browse, recommendations, and image search powered by the Layers API.
- [Installation](https://docs.uselayers.com/sdk/installation.md): Install and configure the Layers SDK in your project, including package manager setup, SDK initialization, and TypeScript type generation.
- [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 backends.
- [Client methods](https://docs.uselayers.com/sdk/api-reference/client-methods.md): Reference for every Layers SDK controller and direct method, including search, autocomplete, facets, feedback, tracking, and client creation.
- [Filtering](https://docs.uselayers.com/sdk/api-reference/filtering.md): Build type-safe filters with the Layers SDK filter DSL using and, or, eq, gte, lte, and inValues, and fetch runtime facets via sdk.facets().
- [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 error handling with the ApiError class.
- [Product card controller](https://docs.uselayers.com/sdk/api-reference/product-card.md): Reference for the createProductCard() controller in SDK v3, covering variant selection, option availability, swatches, media, and price state.
- [Cache and storage](https://docs.uselayers.com/sdk/api-reference/cache-and-storage.md): Reference for the Layers SDK in-memory LRU cache, TTL eviction, storage backends for prepared search IDs, singleton access, and cache invalidation options.
- [Error handling](https://docs.uselayers.com/sdk/error-handling.md): Handle Layers SDK errors with the Result pattern, the ApiError class, retry and timeout options, and reactive controller error state.
- [Framework integration](https://docs.uselayers.com/sdk/framework-integration.md): Patterns for consuming Layers SDK reactive state in React, Vue, Svelte, Lit, Alpine.js, and vanilla JavaScript using the controller subscribe method.
- [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.
- [Search patterns](https://docs.uselayers.com/sdk/search-patterns.md): Advanced Layers SDK search patterns including prepare and get flows, search ID management, debouncing input, and handling concurrent or aborted requests.
- [Caching](https://docs.uselayers.com/sdk/caching.md): How the Layers SDK handles in-memory caching, request deduplication, and prepared search ID reuse so your storefront feels fast and avoids duplicate API calls.
- [SDK performance optimization](https://docs.uselayers.com/sdk/performance.md): Speed up Layers SDK search and browse with concurrent requests, prefetching, debouncing, cache warming, and Early Hints image preload headers.
- [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: v2 to v3](https://docs.uselayers.com/developers/sdk/upgrade-v3.md): Migrate from @commerce-blocks/sdk v2 to v3: renamed client, stateless controllers, filter operator changes, simplified storage, and new controllers.
- [Upgrade guide: v1 to v2](https://docs.uselayers.com/developers/sdk/upgrade-v2.md): Legacy migration guide from @commerce-blocks/sdk v1 to v2. v2 is no longer the current major version. Use the v2 to v3 upgrade guide for new work.
- [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.
- [MCP servers](https://docs.uselayers.com/developers/mcp-servers.md): Connect AI assistants like Claude or ChatGPT to Layers with Model Context Protocol servers for store management and storefront search.
- [Product schema](https://docs.uselayers.com/developers/product-schema.md): Understand the standardized schema Layers expects for Shopify products to maximize search relevance, browsing efficiency, and merchandising precision.
- [Variant & option data](https://docs.uselayers.com/developers/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.
- [Available attributes for API requests](https://docs.uselayers.com/developers/product-schema/api-attributes.md): Product attributes you can request from the Layers Search, Browse, Blocks, and Similar Products APIs, with field types and example values.
- [Selling plans](https://docs.uselayers.com/developers/product-schema/selling-plans.md): How Shopify selling plan groups are synced onto Layers products, the shape of the selling_plans attribute, and the filters they enable.
- [Supported Shopify metafield types and access patterns](https://docs.uselayers.com/developers/product-schema/metafields.md): Supported Shopify metafield types in Layers, their structure, namespace conventions, and how to access metafield values as searchable product attributes.
- [Metaobjects & reference metafields](https://docs.uselayers.com/developers/product-schema/metafields/metaobjects-and-references.md): How Layers resolves metaobject references, media references, taxonomy values, and nested reference chains into a normalized shape.
- [Automatic sequences from metafields](https://docs.uselayers.com/developers/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.
- [Automatic families from metafields](https://docs.uselayers.com/developers/product-schema/metafields/automatic-families.md): Use Shopify list.product_reference metafields to automatically create and maintain product families in Layers without curating them in the dashboard.
- [Theme implementation checklist](https://docs.uselayers.com/developers/theme-implementation-checklist.md): Step-by-step checklist for implementing Layers in a Shopify theme — app embed, search, autocomplete, collections, recommendations, and go-live QA.
- [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.
- [What the app embed and SDK handle for you](https://docs.uselayers.com/developers/app-embed.md): Reference for what the Layers app embed and SDK handle automatically — auth, identity, cart context, attribution, tracking, semantic redirects, and more.
- [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 Layers sort order dropdowns in a Shopify theme using Liquid metaobjects, scope and default-sort rules, and the Browse and Search APIs.
- [Rendering blocks in Liquid](https://docs.uselayers.com/developers/rendering-blocks-in-liquid.md): Render Layers recommendation blocks in a Shopify theme as a Liquid section with a block picker setting, cart context, product deduplication, and pagination.
- [Rendering banners in Liquid](https://docs.uselayers.com/developers/rendering-banners-in-liquid.md): Render merchandising banners from the browse response in a Shopify Liquid theme — hero rows above the grid and inline overtake or inject tiles.
- [Implementing search in Liquid](https://docs.uselayers.com/developers/implementing-search-in-liquid.md): Build a Shopify theme search experience with Layers in Liquid using the prepare/execute flow, autocomplete, faceted filtering, and sort metaobjects.
- [Rendering facets with the SDK](https://docs.uselayers.com/developers/rendering-facets-with-the-sdk.md): Render Shopify filter sidebars by combining Layers facet metaobjects in Liquid with the @commerce-blocks/sdk facets controller for live values and counts.
- [Rendering sort orders with the SDK](https://docs.uselayers.com/developers/rendering-sort-orders-with-the-sdk.md): Render a sort dropdown in a Shopify theme using sort metaobjects in Liquid and the @commerce-blocks/sdk collection and search controllers.
- [Rendering blocks with the SDK](https://docs.uselayers.com/developers/rendering-blocks-with-the-sdk.md): Render Layers recommendation blocks in a Shopify theme as a Liquid section, hydrated by the @commerce-blocks/sdk blocks controller with cart context.
- [Rendering banners with the SDK](https://docs.uselayers.com/developers/rendering-banners-with-the-sdk.md): Render merchandising banners with the Layers SDK by reading data.banners from the collection controller. Hero rows and inline tiles overtake or inject products.
- [Implementing search with the SDK](https://docs.uselayers.com/developers/implementing-search-with-the-sdk.md): Build a Shopify theme search experience with @commerce-blocks/sdk using autocomplete, prepare/get, facets, sort orders, and reactive controllers.
- [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.
- [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.
- [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.
- [Text Search: Submit Feedback](https://docs.uselayers.com/api-reference/search-feedback.md): Search Feedback API endpoint to submit qualitative shopper feedback — thumbs up/down, free-form text, and per-product ratings — for a specific search.
- [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.
- [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.
- [Autocomplete: Get Suggestions](https://docs.uselayers.com/api-reference/predict.md): Autocomplete API endpoint returning ranked search-query suggestions and top trending queries as shoppers type into your storefront search bar.
- [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 from your catalog for recommendation carousels.
- [Content Search: Execute Search](https://docs.uselayers.com/api-reference/search-content.md): Content Search API endpoint to run semantic queries across blog articles, knowledge base pages, and other non-product content in your catalog.
- [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.
- [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.
- [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.
- [Tracking API overview](https://docs.uselayers.com/tracking-api/overview.md): The Layers Tracking API ingests storefront events — product views, clicks, add-to-cart, search, and block engagement — to power analytics and ranking.
- [Authentication](https://docs.uselayers.com/tracking-api/authentication.md): Authenticate Tracking API requests with your storefront access token, passed as a header or as a query parameter for sendBeacon compatibility.
- [Send events](https://docs.uselayers.com/tracking-api/send-events.md): POST a batch of storefront events to the Layers Tracking API. Up to 100 events per request, validated individually, dispatched to your configured pipelines.
- [Event types](https://docs.uselayers.com/tracking-api/event-types.md): Reference for every event_type accepted by the Layers Tracking API, including required fields, optional fields, and server-enriched attributes.
- [Payload examples](https://docs.uselayers.com/tracking-api/payload-examples.md): Copy-pasteable request body examples for every storefront event type accepted by the Layers Tracking API: views, clicks, cart, search, blocks, content.
- [Sending events with navigator.sendBeacon](https://docs.uselayers.com/tracking-api/guides/send-beacon.md): Use navigator.sendBeacon to ship Layers tracking events from the browser without blocking navigation, including page-unload and pagehide flushes.
- [Tracking page navigation in a SPA](https://docs.uselayers.com/tracking-api/guides/spa-tracking.md): Capture product_view and collection_view events from a single-page-app storefront (Hydrogen, Next.js, Remix) using router hooks and sendBeacon.