Metafield content types and values
Each type of metafield accepts a range of supported values for different use cases. Refer to the table of common metafield content types for information about the following:
- supported values for each type of metafield
- example use cases for each type of metafield
- if the content type can be used as a metafield list
For more information, refer to the developer documentation for Metafields.
|Color||Supports RGB values in
Color fields can be used in a list of values.
|Store the color of a product and then set the background of the product page to the same color.|
|Date||Supports date values in ISO 8601 format, without a time zone.
Date fields can be used in a list of values.
|Add product expiration dates, order delivery dates, or customer birth dates.|
|Date and time||Supports date values in ISO 8601 format and time values in UTC time.
Date and time fields can be used in a list of values.
|Add launch event dates or product release dates.|
|Dimension||Supports both whole number and decimal values. Dimension uses either metric or imperial units of measurement.
Dimension fields can be used in a list of values.
|Add box heights or product lengths, such as the length of a scarf.|
|Weight||Supports both whole number and decimal values. Weight uses either metric or imperial units of measurement.
Weight fields can be used in a list of values.
|Add the weight of a product or ingredient, for example, grams of sugar.|
|Volume||Supports both whole number and decimal values. Volume uses either metric or imperial units of measurement.
Volume fields can be used in a list of values.
|Add the volume capacity of a water bottle.|
Supports either integer or decimal values, depending on how you configure your definition. Both integer and decimal fields can be used in a list of values.
An integer metafield might be used to add a page count for books.
A decimal metafield might be used to add a carat weight for jewelry.
|Rating||Supports decimal values along a given scale, depending on how you configure your definition.
Rating fields can be used in a list of values.
|Add an audience score or a star rating for a product.|
|Product reference||Supports linking to a single or multiple products in a metafield list.||Store and display featured products on product pages or collection pages in your online store.|
|Product variant reference||Supports linking to a single product variant.||Store and display other clothing items in the same color on product pages in your online store|
Supports uploading a single file in one of the following file types:
Images and videos can be displayed on your online store or used as a downloadable resource. Generic files are intended for downloading only.
Refer to File format requirements for supported file types.
|Add a PDF file for assembly instructions.|
|Page reference||Allows you to link to an existing page. Supports linking to a single or multiple pages in a metafield list.||Insert your policy page or a detailed care guide on products in your online store.|
URL fields can be used in a list of values.
|Add a link to book reviews or product videos that are hosted on a specific website.|
Supports plain text in either single-line or multi-line fields. Multi-line fields can include line breaks.
Single and multi-line text fields can be used in a list of values.
You can limit single-line fields to preset choices that you specify when you create your metafield definition.
|Add shipping notes, announcements, or washing instructions.|
|True or false||Creates a checkbox for selecting whether a condition is true or false.||Add whether an option is available, such as whether an item can be engraved.|
|JSON||Supports raw JSON data for advanced use cases when you need a structured data source.||Add a table of specifications that has different columns for each product, for example, tables of ingredients.|