Shopify
      Back to home
      1. Knowledge Base
      2. Apps
      3. Shopify

      Metafields

      Use Shopify metafields to add dynamic data to your Nyla site

      The Shopify Metafields app in Nyla allows you to reference Shopify metafields in order to create dynamic experiences on your site. Once added, metafields act like any property on Nyla. 
      This article covers: 

      Introduction to Metafields

      Metafields allow you to add custom content/data that are attached to different entities Shopify like products and variations, collections and so on. To read about metafields, you can reference Shopify's documentation here. 

      Adding metafields: 

      To use metafields in Nyla: 
      1. Create your metafield in Shopify. Ensure it has a definition and has read access activated for the storefront API
      2. Add your metafield in Nyla. Go to Apps > Shopify Metafields and fill in your details. 
        1. The metafield type, namespace and key must match exactly what has been entered in Shopify. 
        2. You need to save and publish your metafield in order to use it on your site. 
      3. Once added, metafields act like any other property within Nyla. 

        1. After your metafield has been added, then you can use it as a property within the corresponding source(s) in Nyla. 

      Note: metafields that include the "price" in the namespace or key cannot be used with Nyla due to clashes with other properties. If your metafield includes price in the namespace or key, you will need to substitute it for another metafield without "price". 

      Tip: For performance reasons, we recommend to only make metafields available within a source: collection if they are needed in order to optimise performance on product listing pages. 

      Adding a metafield to your Nyla site

      Use metafields with Line Item Properties and Cart Attributes

      Metafields can be used in conjunction with Shopify line Item properties and cart attributes to send data through to the cart, checkout and beyond. See more on that here.  

       

      Supported Metafield Types

      Most metafield types are supported, however there are a few types that are unsupported. These include: 

      • Color
      • Product list
      • Collection list
      • Page list
      • Metaobject and metaobject list

      Rich text types are supported, however you cannot mix a property with a rich text reference with normal text in a text or header field. 

      Example Use case: 

      How do I make a product metafield appear on a grid?

       

      See Also