Skip to Content
DocumentationReferenceProduct-link data sources

Product-Link Data Sources

Product-link media lets merchants attach shoppable product cards to images and videos. Use this reference when product cards, links, or media do not show the expected content.

Data Sources

Data sourceUsed forWhere to configure it
Product pickerProduct title, URL, optional thumbnail, and price for Product link cards.Product-link block or compatible media block.
Custom linkA non-product destination when the block supports a manual link.Compatible content or media block settings.
Image mediaStill media that holds product-link positions or cards.Section or media block image picker.
Shopify-hosted videoVideo media that can pair with product links.Section or video media block.
Product dataAvailability, price, variants, images, tags, collections, and metafields used by the linked product card.Shopify product admin.

Setup Notes

  • Use real products for product-link cards before launch.
  • Image and video Product link blocks can open product-backed links on the product page or in the quick-add modal. Choose the behavior with Product link action.
  • A custom link always opens its assigned destination, even when Product link action is set to Open quick add.
  • Product link cards do not expose inline variant selection, badges, or swatches. When quick add opens, its modal provides the applicable product options and purchase controls.
  • Keep linked cards away from important image details and video controls.
  • Test product cards on desktop hover and mobile tap.
  • Use Product-card blocks when swatches, badges, quick add, or Product item composition needs review on collection, search, recommendation, or catalog product cards.