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

Link Behavior

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 Type	Link Text	Link Target
list.url	Truncated URL (60 characters)	The URL itself
list.link	The link label (or URL as fallback)	The link URL
list.file_reference	File name (or alt text)	Direct download
list.product_reference	Product title	Product page URL
list.variant_reference	Product title — Variant title	Product page with variant selected
list.collection_reference	Collection title	Collection 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