Migrating metafields

If you want to add validation rules to an existing set of metafields, then you can migrate your metafields to a definition. When you create a custom definition for existing sets of metafields, the validation rules that you specify prevent you or your apps from adding invalid values.

You migrate your metafields by creating a custom definition for a set of metafields with a particularnamespace and key. You can migrate metafields to most content types, except for file, reference, and true or false. For more information about creating custom definitions, refer to the following:

• Creating custom definitions
• Metafield content types and values

You can only add definitions for sets of metafields that have a namespace and key with the correct format. If your namespace and key contains special characters, then you can't migrate that set of metafields to a definition.

Create a definition for sets of metafields that don't yet have a definition

1. From your Shopify admin, go toSettings>Custom data.
2. Select the part of your store that you want to add a metafield definition for. For example,Products.
3. ClickMetafields without a definition, and then clickAdd definitionnext to the namespace and key that you want to add a definition for.
4. Review theSample metafieldto determine the correct type and validation rules for the namespace and key. To display additional sample values, clickView more.
5. Enter the following information for your metafield definition:
   1. In theNamefield, enter a name for your definition.
   2. Optional: In theDescriptionfield, enter a description for your metafield.
6. ClickSelect content type, and then select the content type that best matches your metafield values from the list.
7. Configure the content type and validation information by doing the following:
   1. If the content type has additional configuration options, then select the correct option for your metafield. For example, type of measurement.
   2. In theValidationsection, configure theAdditional rulesfor your definition.
8. ClickSave.
9. Review the validation results, and then clickSave and continue.

If any metafield values don’t match your new definition, then you need tofix your metafield values. After you save your definition, you're automatically redirected to the bulk editor to review and fix any validation errors.

Edit metafields without a definition

Third-party metafields from an app can be migrated into your Shopify admin, but they are hidden. You can edit these metafields from the resource page that they appear on.

Steps:

1. From your Shopify admin, go to the resource that has the migrated metafields.
2. Scroll down to theMetafieldssection.
3. ClickShow all.
4. Click the metafield line for the definition you want to edit, and then add the value.
5. ClickSave.

If you don't see theMetafieldssection on your resource page, then go toSettings>Custom dataand make sure at least one metafield definition exists. You can't see metafields in your resource without having at least one metafield definition created.

Next steps after adding metafield definitions

After you add definitions for your metafields, you can complete the following actions:

• Pin or unpin metafield definitions确定你的metafields ar的顺序e displayed.
• Add values to metafieldsfor parts of your store.
• Connect your metafields to your themeto display them on your online store.