Getting Started with Theme Extensions
Theme extensions allow you to add custom blocks containing metafield data to your Shopify storefront without any coding. They are compatible with Online Store 2.0 themes.
Supported Block Types
Metafield Studio provides 11 no-code theme blocks:
| Block | Purpose | List Support |
|---|---|---|
| Text / HTML | Display text-based metafields with customizable styling | Bulleted, numbered, or comma-separated lists |
| Reference / Related Products | Show product, collection, or variant references | Card grid or slider |
| Image / Gallery | Display images with lightbox and gallery layout | Image gallery grid |
| Link / File | Display links and downloadable files | Bulleted or numbered link lists |
| Video | Embed Shopify-hosted, YouTube, or Vimeo videos | Video grid |
| Rating | Display ratings with customizable icons | Multi-characteristic ratings with labels |
| Color | Show color swatches | Inline, grid, or vertical swatch layouts |
| Date / Time | Display formatted dates and times | Stacked, bulleted, numbered, or comma-separated |
| Boolean | Conditional display based on true/false values | — |
| Variant Text / HTML | Variant-level text metafields | — |
| Variant Link / File | Variant-level link/file metafields | — |
List Metafield Types
Most blocks support list versions of their metafield types (e.g., list.color, list.file_reference, list.product_reference). List metafields store multiple values in a single field and unlock additional layout and formatting options, such as image galleries, color palette grids, multi-characteristic ratings, and video grids. See each block's documentation for details on available list layouts.
How to Add a Block
- Go to your Shopify admin → Sales channels → Online store
- Locate and customize your desired theme
- Select the template to modify (e.g., product template)
- Click (+) Add Block and search for Metafield Studio
- Choose a block type and configure it with your metafield's namespace and key
- Position the block appropriately on the page
- Optionally assign descriptive labels
- Click Save
Important Limitations
- Blocks integrate with specific themes only it is technically impossible to assign a single block to multiple themes
- Blocks are removed if the app is uninstalled
- Theme transfers and customizations are not supported