Skip to main content

​
Overview

Dynamic Linking allows you to pin specific products to the top of collection pages when customers arrive from your advertising campaigns. This ensures that the products featured in your ad creative appear at the top of the page, creating a seamless experience from ad to landing page. Common use cases:
  • Social media ads featuring specific products
  • Google Shopping campaigns with product images
  • Email campaigns showcasing featured items
  • Influencer partnerships highlighting specific products

​
How it works

When you drive traffic to a collection page from an ad, you can pass product identifiers (handles or IDs) via the Browse API’s dynamicLinking parameter. These products will appear at the top of the first page, regardless of your merchandising rules or sort orders. Priority hierarchy:
  1. Dynamic Linking (first page only)
  2. Merchandising Rules
  3. Base Sort Order
Dynamic Linking takes the highest priority and only applies on page 1 of results. On subsequent pages, your normal merchandising rules and sort orders apply.

​
Example scenario

You’re running a Facebook ad featuring three specific necklaces. When customers click the ad and land on your “Necklaces” collection page, you want those three products to appear at the top in the same order as shown in the ad. Without Dynamic Linking: Customers see products sorted by your default sort order, which may not include the advertised products at the top. With Dynamic Linking: The three featured necklaces appear at positions 1, 2, and 3, exactly as shown in your ad, creating a consistent experience.

​
Technical implementation

Dynamic Linking is implemented via the Browse API. Your development team will need to:
  1. Identify the products featured in your ad (by handle or ID)
  2. Pass these identifiers in the dynamicLinking parameter when calling the Browse API
  3. Ensure the API call is triggered when customers arrive from your ad campaign
Example API request: 
{
  "sort_order_code": "relevance",
  "dynamicLinking": {
    "products": ["summer-dress-blue", 8234567890123, "classic-tee-white"]
  }
}
See the Browse API documentation for complete technical details.

​
Behavior and constraints

  • First page only: Dynamic Linking only applies on page 1 of results
  • Graceful handling: Non-existent or unavailable products are silently skipped
  • Automatic shifting: Subsequent products shift up to fill any gaps
  • Mixed identifiers: You can use product handles (strings) and IDs (numbers) in the same array
  • Order matters: Products appear in the exact order you specify in the array

​
Enabling Dynamic Linking

Dynamic Linking is an advanced feature that requires configuration by the Layers team. To enable it for your store:
1

Contact support

Reach out to the Layers support team via your dedicated Slack channel or email [email protected]
2

Provide use case details

Share information about your advertising campaigns and how you plan to use Dynamic Linking
3

Technical setup

Work with your development team to implement the Browse API integration with the dynamicLinking parameter
4

Testing

Test your implementation to ensure products appear correctly when arriving from ad campaigns

​
Tips for success

  • Coordinate with marketing: Ensure your merchandising team knows which products are featured in active ad campaigns
  • Track performance: Monitor conversion rates for ad traffic to measure the impact of Dynamic Linking
  • Keep it relevant: Only pin products that are actually featured in your ad creative
  • Limit the number: Pin 3-5 products maximum to maintain a natural browsing experience
  • Update regularly: As ad campaigns change, update your Dynamic Linking configuration to match

​
See also