PDP Metafield Blocks

Last updated: August 6, 2025

Overview

Appbrew supports a variety of metafield types that allow you to display dynamic content on your product detail pages (PDP). This makes it easy to showcase product-specific information that's fully manageable from your Shopify store. Examples of supported content include banners, videos, products, and text.

Feature Overview

The Product Detail Metafield block allows Shopify merchants to enrich their Product Detail Pages (PDPs) by dynamically displaying product content from product metafields—without requiring any code.

This feature is ideal for showcasing additional visual information such as size charts, technical diagrams, trust badges, usage instructions, warranty cards, and promotional banners. Content is sourced from your Shopify store’s metafields and rendered through customizable blocks within your PDP layout.

The block supports flexible display modes, including collapsible sections and standard displays, while maintaining responsive behavior across devices. This makes it easy to deliver rich, branded, and informative product pages for your customers.

Key Benefits

  • Add visual content without touching code

  • Automatically fetches content from Shopify metafields

  • Customizable layout, icon, and styling

  • Mobile-friendly and fully responsive

Content Types Supported

This feature can be configured to render various metafield content types:

  • Image files (stored in Shopify Files)

  • Rich text (HTML supported)

  • Video files or YouTube URLs

  • Collections or product references

  • Text strings or numeric values

Rendering Capabilities

  • Static content (e.g., uploaded banners or badges)

  • Dynamic content based on product metafields or tags

  • Interactive media such as video

  • Structured data like specifications, pricing details, or product highlights

Configuration

1. Shopify Setup

To use this feature:

  • Ensure your Shopify product has the appropriate metafield defined with the correct namespace and key (e.g., custom.visuals.size_chart_image)

  • The metafield type must be set to File for images or videos, or the appropriate type for text or URL content

  • The image or file must be uploaded and stored in the Shopify Files section

2. Appbrew Dashboard Configuration

Using the Appbrew dashboard, configure the Product Detail Metafield block as follows:

  • Metafield Image and Rich text Block are self serve and can be added from Dashboard itself.

  • Reach out to support for implementation of other content types

Advanced Functionalities

  • Support for rendering:

    • A+ section images and tabbed layouts

    • Promotional banners tied to specific tags or metafield content

    • Dynamic YouTube or uploaded videos

    • Technical specifications in list format

    • Subtitles, vendor/brand details, and contextual descriptions

  • Static or conditional content display (based on tags or metafield presence)

Feature Use Cases

Visual Enhancements

  • Display apparel size charts as dedicated images

  • Embed how-to-use or feature walkthroughs using uploaded videos or YouTube links

  • Add certification, warranty, and trust badges as graphics

  • Showcase what’s included in the box via packaging images

Product Specifications & Technical Content

  • Dynamically list specifications such as material type, gemstone grade, purity, and weight

  • Visualize technical diagrams or feature comparisons for electronic products

Promotions and Offers

  • Present seasonal or product-level promotions using offer banners pulled from metafields

  • Feature discounts or flash sale announcements as static images

Brand Storytelling & Value Communication

  • Highlight brand names or vendor credentials using text metafields

  • Display eco-friendly, bestseller, or cruelty-free labels

  • Surface additional subtitles or marketing messaging to reinforce brand voice

Upselling and Recommendations

  • Show related products or frequently bought together items via metafields linked to collections

  • Suggest accessories or complementary items visually

Troubleshooting / FAQ

1. Why is the image or content not showing on the PDP?

  • Verify the metafield exists in Shopify with the correct namespace and key

  • Ensure the metafield has data populated (e.g., image or video file assigned)

  • Confirm that the metafield is mapped correctly to the desired block in the Appbrew dashboard

  • Some configurations may require a refresh or app version update to render changes

2. Can I upload a video URL in a variant metafield?

  • No. Variant metafields are not supported for video URLs

  • Instead, use a product-level metafield of type File or embed a YouTube URL in a product-level metafield

3. Can I conditionally hide or show blocks based on metafield values?

  • Conditional logic (e.g., if-else rendering) is not currently supported

  • Content will be displayed as long as the metafield is populated

4. Can users copy text or discount codes from image-based offer blocks?

  • No. When offers are rendered as images, text cannot be copied

  • Embed all relevant information (including codes) directly into the image design

5. Is there a limit to the number of metafields I can use on a single PDP?

  • There is no hardcoded limit, but excessive use (especially of high-resolution images or multiple videos) may affect page performance

  • Use performance best practices when rendering large or numerous metafield assets

6. Can the app dynamically pull metafield data from the live website or storefront?

  • Yes, you can use existing metafields in use for your website.