Skip to main content

Link / File Block

Display links and downloadable files from metafields on your storefront.

Compatible Metafield Types​

Single value types:

  • url — a single URL link
  • link — a single link with label
  • file_reference — a single downloadable file
  • product_reference — a link to a product
  • variant_reference — a link to a product variant
  • collection_reference — a link to a collection
  • page_reference — a link to a page
  • metaobject_reference — a link to a blog post

List types:

  • list.url — multiple URL links
  • list.link — multiple links with labels
  • list.file_reference — multiple downloadable files
  • list.product_reference — multiple product links
  • list.variant_reference — multiple variant links
  • list.collection_reference — multiple collection links

Customization Features​

Choose how links behave when clicked:

  • Open in current tab Navigate within the same window
  • Open in new tab Launch a new browser tab
  • Auto-download Automatically start file download

Styling​

  • Text color Match your theme's color palette
  • Background color Add visual distinction
  • Text size Adjust readability
  • Corner radius Round the corners of the block
  • Layout Control overall arrangement
  • Spacing Set gaps between items

Icons​

Add icons to enhance the visual presentation of links and files.

List Display Options​

When using list metafield types, multiple links or files are rendered as a formatted list with additional options:

List Format​

Choose between two list styles:

  • Bulleted An unordered list with bullet points
  • Numbered An ordered list with sequential numbers

List Spacing​

Control the vertical gap between list items for comfortable readability.

How Each List Type Renders​

Metafield TypeLink TextLink Target
list.urlTruncated URL (60 characters)The URL itself
list.linkThe link label (or URL as fallback)The link URL
list.file_referenceFile name (or alt text)Direct download
list.product_referenceProduct titleProduct page URL
list.variant_referenceProduct title — Variant titleProduct page with variant selected
list.collection_referenceCollection titleCollection page URL
Use Cases
  • Downloadable resources — Use list.file_reference to offer multiple PDF manuals, spec sheets, or certificates for download
  • Related links — Use list.url or list.link to show a list of external resources or documentation
  • Cross-sell links — Use list.product_reference to create a simple text-based list of related product links