Third-Party Integrations

​

Overview

Layers integrates with popular analytics, personalization, and promotional tools to enhance your search and discovery experience. All integrations are configured through the Layers dashboard, making it easy to enable and manage connections without modifying your theme code. The integration system is designed to be:

• Privacy-compliant: All integrations respect the same consent settings as the Layers Pixel
• Non-intrusive: Integrations only use services already loaded on the page
• Dashboard-managed: Enable or disable integrations with a single toggle
• Extensible: New integrations are added regularly based on merchant needs

​

Configuring integrations

To manage your integrations:

1. Go to the Settings page in the Layers dashboard
2. Select the Integrations tab
3. Toggle integrations on or off as needed
4. Click Save changes

Changes take effect immediately and are synced to your storefront.

​

Supported integrations

​

Rivo

Rivo is a loyalty and rewards platform for Shopify merchants. When enabled, Layers receives richer customer profile context from Rivo, enabling enhanced personalization in search results based on loyalty tier, points balance, and reward eligibility. Benefits:

• Personalize search results based on customer loyalty status
• Surface products relevant to available rewards
• Enhance customer segmentation with loyalty data

​

Blotout

Blotout is a privacy-first customer data platform that helps you collect, unify, and activate customer data without relying on third-party cookies. When enabled, Layers forwards widget clickstream events to Blotout and uses Blotout’s User and Device IDs for consistent cross-session tracking. Benefits:

• Unified customer identity across touchpoints
• Privacy-compliant event tracking
• Enhanced attribution for visual search interactions

​

Microsoft Clarity

Microsoft Clarity is a free analytics tool that provides session recordings, heatmaps, and behavioral insights to help you understand how customers interact with your website. When enabled, Layers streams widget click data to Clarity, allowing you to replay sessions involving visual search and shop similar interactions to identify UX friction points. Benefits:

• Session recordings of visual search usage
• Heatmaps showing widget interaction patterns
• Behavioral insights for search optimization

​

Abra Promotions

Abra Promotions is a promotional pricing platform that enables dynamic discounts and flash sales on Shopify. When enabled, Layers natively integrates with Abra’s discount engine, ensuring that price-based sorting and filtering accurately reflects promotional pricing. This integration is essential for merchants using Abra to run sales and promotions. Benefits:

• Accurate price sorting with active promotions
• Correct price filtering during sales
• Consistent pricing across search and collection pages

For detailed information on using discount entitlements with the Layers API, see Discount Entitlements.

​

FoxSell Bundles

FoxSell Bundles is a product bundling app for Shopify that lets you create fixed bundles, mix-and-match bundles, cross-sell offers, multi-variant bundles, and volume discounts. When enabled, Layers computes accurate prices for FoxSell bundle products so they appear correctly in price-based sorting, filtering, and search results. Without this integration, bundle products may display incorrect prices because Shopify stores them differently than standard products. Benefits:

• Accurate price sorting and filtering for all bundle types
• Correct price display in search and collection results
• Improved search relevance through bundle component awareness — Layers indexes the titles of products included in a bundle, so searches for component products can surface relevant bundles

How it works: When this integration is enabled, Layers automatically:

1. Reads the FoxSell metafields on your products and variants to determine bundle configuration
2. Computes the true bundle price by resolving component product prices
3. Overrides the indexed price range so sorting and filtering reflect the actual bundle price
4. Includes component product titles in the search index for better discoverability

Supported bundle types: Each bundle type is priced differently based on how FoxSell structures its components:

• Fixed bundles — the price is calculated by summing each component product’s price multiplied by its quantity. The resulting price range reflects the cheapest and most expensive possible combinations.
• Mix-and-match bundles — supports two pricing models. With fixed pricing, a flat price is applied based on the selected tier. With dynamic pricing, the price is computed by summing the individual prices of the selected component products.
• Cross-sell bundles — the total price is computed from the component products, and any configured percentage discount is applied. The original undiscounted total is preserved as a compare-at price so shoppers can see the savings.
• Multi-variant bundles — Layers evaluates each parent variant’s bundled component variants to determine a minimum and maximum price across all configurations.
• Volume discount bundles — Shopify already stores the correct base price for volume bundles, so no price override is applied. The integration still indexes component product titles for search discoverability.

​

Edgemesh

Edgemesh is a client-side performance optimization platform that accelerates page load times through intelligent prefetching, predictive preloading, and edge-based caching. When enabled, Layers syncs integration status to your storefront so that Edgemesh-aware components can coordinate prefetching behavior with Layers API responses. Benefits:

• Coordinate image prefetching with Layers search and browse responses
• Leverage Edgemesh’s predictive engine alongside Layers’ Link header preload hints
• Unified performance optimization across search, browse, and product pages
• Improved purchase attribution through Edgemesh session tracking — Layers reads _em_session_id from order note attributes to link purchases back to browsing sessions (see Order Attributes)

​

Global-E ^Beta

Global-E is an international e-commerce platform that enables cross-border selling by handling localized pricing, currency conversion, and country-specific adjustments for Shopify merchants. When enabled, Layers applies country-based pricing to all search and browse API responses using rate snapshots synced from Global-E. This means shoppers in different countries see prices converted to their local currency with the correct conversion rates, country coefficients, and rounding rules applied directly in Layers results. Benefits:

• Localized pricing in search, browse, and recommendation results without additional client-side conversion
• Accurate price-based sorting and filtering using the shopper’s local currency
• Country coefficient adjustments that reflect regional pricing strategies (not just currency conversion)
• Global-E rounding rules applied server-side so displayed prices match your storefront checkout

How it works:

1. You provide your Global-E Merchant Token and API Base URL in the integration settings
2. Layers periodically syncs rate data from Global-E, fetching the list of supported countries along with their currency conversion rates, country coefficients, and rounding rules
3. When a storefront API request includes a country code (via the country parameter or geo context), Layers looks up the matching rate snapshot for that country
4. All product prices in the response are converted using the formula: price × currency_conversion_rate × country_coefficient_rate, then rounded according to Global-E’s rounding rules
5. The response includes currency_code and currency_decimal_places metadata so your storefront can format prices correctly

Configuration: Rate table dashboard: After configuring the integration, the Rate Table panel in the Layers dashboard shows all synced countries with their conversion rates, coefficient rates, and currency details. You can manually trigger a resync from this panel if rates need to be refreshed immediately.

​

Okendo

Okendo is a customer marketing platform for Shopify that includes product reviews, surveys, referrals, and quizzes. The Layers integration focuses on Okendo’s quiz feature, bringing shopper quiz responses into Layers so you can personalize search and collection results based on each customer’s stated preferences. When a shopper completes an Okendo quiz, the responses are sent to Layers via webhook and stored against the shopper’s session. On every subsequent search or browse request, Layers automatically enriches the session context with the shopper’s quiz profile, allowing merchandising rules and ranking signals to factor in their preferences. Benefits:

• Personalize search and collection results using quiz-derived preferences
• Surface products that match a shopper’s stated needs (e.g., skin type, style preferences, fitness goals)
• Combine quiz context with other signals like cart contents, purchase history, and location for richer personalization
• No theme code changes required. Quiz data flows into Layers automatically once the integration is enabled

How it works:

1. Enable the Okendo integration in the Layers dashboard under Settings > Integrations
2. Copy the webhook endpoint shown in the setup panel
3. In your Okendo dashboard, register the webhook endpoint and copy the signing secret
4. Paste the signing secret into the Webhook Secret field in Layers and save
5. When a shopper completes a quiz, Okendo sends the response to Layers via webhook
6. Layers normalizes the quiz answers and attaches them to the shopper’s session
7. All subsequent search and browse requests for that session automatically include the quiz profile as part of the contextual information

Configuration: Supported webhook topics: The integration listens for the following Okendo quiz response events:

• quiz_response.create — a shopper submits a new quiz response
• quiz_response.update — a shopper updates an existing quiz response
• quiz_response.delete — a quiz response is removed

​

Klaviyo

Klaviyo is a marketing platform for email, SMS, and push campaigns. The Layers integration lets you target merchandising rules, banners, blocks, product sequences, search, and sort orders at shoppers who arrive from a specific Klaviyo campaign — instead of pasting UTM strings by hand. Once connected, Layers syncs your Klaviyo campaigns and their tracking UTMs on a nightly schedule and adds a Klaviyo: Campaign field to the contextual conditions builder. Selecting a campaign from the picker matches any shopper whose session UTMs (utm_source, utm_medium, utm_campaign) came from that campaign, across email, SMS, and push channels. Benefits:

• Target merchandising at shoppers arriving from a specific campaign without copying UTMs by hand
• Consistent campaign targeting across every contextual surface (rules, banners, blocks, sequences, search, sort orders)
• Automatic nightly sync keeps the campaign list current as you launch new sends
• Resolves Klaviyo’s dynamic campaign-name UTM placeholders to the literal values that actually reach the storefront

How it works:

1. Go to Settings → Integrations in the Layers dashboard
2. Toggle Klaviyo on. A dialog opens with a Continue to Klaviyo button
3. Approve the requested read-only access to campaigns and account info in Klaviyo
4. Klaviyo redirects back to Layers and the initial campaign sync starts automatically
5. Open any surface that supports contextual conditions (for example, a merchandising rule) and select Klaviyo: Campaign in the condition builder
6. Select a campaign from the searchable dropdown. The condition matches when the shopper’s session UTMs match that campaign’s source, medium, and campaign values

Supported operators: The Klaviyo: Campaign field supports two operators:

• equals — the rule matches only when the shopper arrived from the selected campaign
• does not equal — the rule matches every shopper except those who arrived from the selected campaign

Which campaigns appear in the picker: The picker lists campaigns that have all three tracking UTMs (utm_source, utm_medium, utm_campaign) configured in Klaviyo. Campaigns without tracking UTMs are skipped because they cannot be uniquely matched by the shopper’s session. Disconnecting: Toggle Klaviyo off in Settings → Integrations to disconnect. Layers revokes its OAuth grant with Klaviyo and clears the synced campaign list. Any existing merchandising rules that reference a Klaviyo campaign continue to evaluate against the stored UTM values, but the picker will no longer be available until you reconnect.

​

Event forwarding

When analytics integrations (Blotout, Clarity) are enabled, Layers forwards visual search and shop similar events to these services. The following events are forwarded:

​

Implementation notes

• Integrations only forward events to services that are already loaded on your page
• No additional scripts are loaded by enabling integrations
• All integrations respect your store’s consent management settings
• Events are forwarded with the same payload structure as they are sent to Layers
• If an integration service is not available on the page, events will silently skip forwarding

​

Requesting new integrations

Layers regularly adds new integrations based on merchant needs. If you use a tool that isn’t currently supported, you can request it. To request a new integration:

1. Email support@uselayers.com with:
   • The name of the tool or platform
   • How you currently use it in your store
   • What data or functionality you’d like to integrate with Layers
2. The Layers team evaluates the request based on:
   • Technical feasibility
   • Merchant demand
   • Privacy and performance considerations
   • Alignment with Layers’ integration principles

Current integration priorities: We prioritize integrations that enhance search personalization, improve analytics visibility, or enable better pricing and promotional capabilities. Analytics, loyalty, and customer data platforms are particularly well-suited for integration.

​

Need help?

For questions about integrations or to request a new integration, contact support@uselayers.com.