Standard metafield definitions are [metafield definitions](/docs/apps/build/custom-data/metafields/definitions) that we've created for some common use cases. If you need to store data for one of these use cases, then we recommend using the standard metafield definitions, because they're interoperable across the entire Shopify platform and connect more seamlessly to themes. Standards ensure interoperability across the Shopify ecosystem. [Standard metafield definition templates](/docs/api/admin-graphql/latest/objects/StandardMetafieldDefinitionTemplate) provide preset configurations to create metafield definitions. Each template has a specific namespace and key that we've reserved to have specific meanings for common use cases. > Tip: > For more information about the types of information that metafield definitions can store, refer to [Metafield types](/docs/apps/build/custom-data/metafields/list-of-data-types). The following table describes the standard metafield definitions: <table> <caption>Standard metafield definitions</caption> <thead> <tr> <th scope=“col”>Name and <a href="#interacting-with-standard-metafield-definitions">ID</a></th> <th scope=“col”><a href="/docs/apps/build/custom-data/metafields/list-of-data-types#supported-types">Type</a></th> <th scope=“col”>Details</th> </tr> </thead> <tbody> <tr> <td> <p><span class="visuallyhidden">Name</span>Product subtitle</p> <p><span class="visuallyhidden">ID</span><code>1</code></p> </td> <td><code><a href="/docs/apps/build/custom-data/metafields/list-of-data-types#singleLineText">single_line_text_field</a></code></td> <td> <p>Stores a concise description of a product.</p> <p>All apps should use this metafield instead of the product’s full description when a brief product summary is needed. For example, SMS apps can use the product subtitle for short text messages about a product.</p> <p><b>Maximum length:</b> 70 characters</p> <p><b>Allowed resources:</b> <code>PRODUCT</code>,<code>PRODUCTVARIANT</code></p> <p><b>Reserved namespace and key:</b> <code>descriptors.subtitle</code></p> </td> </tr> <tr> <td> <p><span class="visuallyhidden">Name</span>Care guide</p> <p><span class="visuallyhidden">ID</span><code>2</code></p> </td> <td><code><a href="/docs/apps/build/custom-data/metafields/list-of-data-types#multiLineText">multi_line_text_field</a></code></td> <td> <p>Stores detailed instructions on how to take care of clothing.</p> <p>Themes aimed at users selling apparel can use this metafield for display on product detail pages.</p> <p><b>Maximum length:</b> 500 characters</p> <p><b>Allowed resources:</b> <code>PRODUCT</code>,<code>PRODUCTVARIANT</code></p> <p><b>Reserved namespace and key: <code>descriptors.<wbr/>care_guide</code></b></p> </td> </tr> <tr> <td> <p><span class="visuallyhidden">Name</span>ISBN</p> <p><span class="visuallyhidden">ID</span><code>3</code></p> </td> <td><code><a href="/docs/apps/build/custom-data/metafields/list-of-data-types#singleLineText">single_line_text_field</a></code></td> <td> <p>Stores an ISBN book identifier.</p> <p>Themes supporting booksellers can use this metafield to identify books to customers. Apps helping to merchandise books should write to this metafield for optimal theme integration.</p> <p><b>Value:</b> Must be a 10-digit or 13-digit number, with optional hyphens.</p> <p><b>Allowed resources:</b> <code>PRODUCT</code>,<code>PRODUCTVARIANT</code></p> <p><b>Reserved namespace and key:</b> <code>facts.<wbr/>isbn</code></p> </td> </tr> <tr> <td> <p><span class="visuallyhidden">Name</span>UPC</p> <p><span class="visuallyhidden">ID</span><code>4</code></p> </td> <td><code><a href="/docs/apps/build/custom-data/metafields/list-of-data-types#singleLineText">single_line_text_field</a></code></td> <td> <p>Stores a Universal Product Code (UPC).</p> <p>Apps reading or writing UPCs should integrate this standard metafield for display purposes, or for integration with ERP systems.</p> <p><b>Value:</b> Must be a 12-digit number with at least one zero.</p> <p><b>Allowed resources:</b> <code>PRODUCT</code>,<code>PRODUCTVARIANT</code></p> <p><b>Reserved namespace and key:</b> <code>facts.<wbr/>upc</code></p> </td> </tr> <tr> <td> <p><span class="visuallyhidden">Name</span>EAN</p> <p><span class="visuallyhidden">ID</span><code>5</code></p> </td> <td><code><a href="/docs/apps/build/custom-data/metafields/list-of-data-types#singleLineText">single_line_text_field</a></code></td> <td> <p>Stores a European Article Number (EAN).</p> <p>Similar to UPCs, apps reading or writing EANs should integrate this standard metafield for display in online stores, or for integration with ERP systems.</p> <p><b>Value:</b> Must be a 13-digit number.</p> <p><b>Allowed resources:</b> <code>PRODUCT</code>,<code>PRODUCTVARIANT</code></p> <p><b>Reserved namespace and key:</b> <code>facts.<wbr/>ean</code></p> </td> </tr> <tr> <td> <p><span class="visuallyhidden">Name</span>Product rating</p> <p><span class="visuallyhidden">ID</span><code>6</code></p> </td> <td><code><a href="/docs/apps/build/custom-data/metafields/list-of-data-types#rating">rating</a></code></td> <td> <p>Stores the average rating for a product or variant.</p> <p>Product rating apps should write to this standard metafield and update it whenever a product’s rating has changed. Themes that display product ratings should reference this metafield for the aggregated average rating.</p> <p><b>Allowed resources:</b> <code>PRODUCT</code>,<code>PRODUCTVARIANT</code></p> <p><b>Reserved namespace and key:</b> <code>reviews.<wbr/>rating</code></p> </td> </tr> <tr> <td> <p><span class="visuallyhidden">Name</span>Product rating count</p> <p><span class="visuallyhidden">ID</span><code>7</code></p> </td> <td><code><a href="/docs/apps/build/custom-data/metafields/list-of-data-types#numberInteger">number_integer</a></code></td> <td> <p>Stores the total number of ratings for a product or variant.</p> <p>Product rating apps should write to this standard metafield and update it whenever a product’s rating has changed. Themes that display product ratings should reference this metafield.</p> <p><b>Allowed resources:</b> <code>PRODUCT</code>,<code>PRODUCTVARIANT</code></p> <p><b>Reserved namespace and key:</b> <code>reviews.<wbr/>rating_count</code></p> </td> </tr> <tr> <td> <p><span class="visuallyhidden">Name</span>Related products</p> <p><span class="visuallyhidden">ID</span><code>14</code></p> </td> <td><code><a href="/docs/apps/build/custom-data/metafields/list-of-data-types#listProdRef">list.product_reference</a></code></td> <td> <p>Stores products that are similar to a selected product.</p> <p>You can display potential substitutes to help customers discover other similar products that they might like.</p> <p><b>Allowed resources:</b> <code>PRODUCT</code></p> <p><b>Reserved namespace and key:</b> <code>shopify--discovery--product_recommendation.<wbr/>related_products</code></p> </td> </tr> <tr> <td> <p><span class="visuallyhidden">Name</span>Related products setting</p> <p><span class="visuallyhidden">ID</span><code>15</code></p> </td> <td><code><a href="/docs/apps/build/custom-data/metafields/list-of-data-types#singleLineText">single_line_text_field</a></code></td> <td> <p>Stores a setting value that controls how manual product recommendations are displayed.</p> <p><code>only manual</code> displays only manual recommendations.</p> <p><code>ahead</code> displays manual recommendations before auto-generated recommendations.</p> <p><b>Allowed resources:</b> <code>PRODUCT</code></p> <p><b>Reserved namespace and key:</b> <code>shopify--discovery--product_recommendation.<wbr/>related_products_display</code></p> </td> </tr> <tr> <td> <p><span class="visuallyhidden">Name</span>Search product boosts</p> <p><span class="visuallyhidden">ID</span><code>16</code></p> </td> <td><code><a href="/docs/apps/build/custom-data/metafields/list-of-data-types#listSingleLineText">list.single_line_text_field</code></td> <td> <p>Stores search terms that are associated to a product.</p> <p>When a customer searches a store using the search terms, the product ranks higher in the search results.</p> <p><b>Allowed resources:</b> <code>PRODUCT</code></p> <p><b>Reserved namespace and key:</b> <code>shopify--discovery--product_search_boost.<wbr/>queries</code></p> </td> </tr> <tr> <td> <p><span class="visuallyhidden">Name</span>Complementary products</p> <p><span class="visuallyhidden">ID</span><code>17</code></p> </td> <td><code><a href="/docs/apps/build/custom-data/metafields/list-of-data-types#listProdRef">list.product_reference</a></code></td> <td> <p>Stores products that are often bought in addition to a selected product.</p> <p>You can display complementary products to help customers discover new products and to increase sales.</p> <p><b>Allowed resources:</b> <code>PRODUCT</code></p> <p><b>Reserved namespace and key:</b> <code>shopify--discovery--product_recommendation.<wbr/>complementary_products</code></p> </td> </tr> <tr> <td> <p><span class="visuallyhidden">Name</span>Birth date</p> <p><span class="visuallyhidden">ID</span><code>19</code></p> </td> <td><code><a href="/docs/apps/build/custom-data/metafields/list-of-data-types#date">date</a></code></td> <td> <p>Stores the customer's date of birth in <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO 8601 format</a>.</p> <p>You can use this metafield to <a href="https://help.shopify.com/en/manual/customers/customer-segmentation/customer-segments/customer-segmentation-reference/customer-segment-metafield">create a filter</a> that segments customers by birthday to automatically send a discount.</p> <p><b>Allowed resources:</b> <code>CUSTOMER</code></p> <p><b>Reserved namespace and key:</b> <code>facts.<wbr/>birth_date</code></p> </td> </tr> <tr> <td> <p><span class="visuallyhidden">Name</span>Trade item description</p> <p><span class="visuallyhidden">ID</span><code>20</code></p> </td> <td><code><a href="/docs/apps/build/custom-data/metafields/list-of-data-types#multiLineText">multi_line_text_field</a></code></td> <td> <p>Stores a precise product description that describes specific attributes of the product for customs and import.</p> <p><b>Allowed resources:</b> <code>PRODUCT</code>,<code>PRODUCTVARIANT</code></p> <p><b>Reserved namespace and key:</b> <code>import_information.<wbr/>trade_item_description</code></p> </td> </tr> <tr> <td> <p><span class="visuallyhidden">Name</span>Product transport declaration</p> <p><span class="visuallyhidden">ID</span><code>21</code></p> </td> <td><code><a href="/docs/apps/build/custom-data/metafields/list-of-data-types#listSingleLineText">list.single_line_text_field</a></code></td> <td> <p>Stores public transport declarations, such as batteries, hazardous materials, creams, liquids, or powders.</p> <p><b>Allowed resources:</b> <code>PRODUCT</code>,<code>PRODUCTVARIANT</code></p> <p><b>Reserved namespace and key:</b> <code>import_information.<wbr/>product_transport_declaration</code></p> </td> </tr> </tbody> </table> ### Interacting with standard metafield definitions You can interact with standard metafield definitions using GraphQL queries or mutations: <a name="access-table"></a> | Action | Query or mutation | | --- | --- | | Access standard metafield definition templates | Use the [standardMetafieldDefinitionTemplates](/docs/api/admin-graphql/current/queries/standardMetafieldDefinitionTemplates) query to access standard metafield definition templates.| | Access metafield definition | Use the [metafieldDefinition](/docs/api/admin-graphql/current/queries/metafieldDefinition) query to access a standard metafield definition. | | <a id="accessID">Create a metafield definition</a> | Use the [standardMetafieldDefinitionEnable](/docs/api/admin-graphql/current/mutations/standardMetafieldDefinitionEnable) mutation to create a metafield definition using one of the standard metafield definition templates.<br></br> To specify the template you want to use, provide the ID for the template in the format `gid://shopify/StandardMetafieldDefinitionTemplate/<id>`, where `id` is the corresponding ID value from the table. | | Delete a metafield definition | Use the [metafieldDefinitionDelete](/docs/api/admin-graphql/current/mutations/metafieldDefinitionDelete) mutation to delete a metafield definition. | ### Next steps - Learn how to [manage metafield definitions](/docs/apps/build/custom-data/metafields/definitions) using the GraphQL Admin API. - Learn how to [manage validation options](/docs/apps/build/custom-data/metafields/list-of-validation-options) using the GraphQL Admin API.