In addition to the metafields, the integration app gets the metafield definitions for product and their variants from Shopify. The metafield definitions allow you to create additional data constraints for metafields and enable the merchant to edit metafield values in context. For every metafield that is synced to Shopify, the integration app searches for the matching metafield definition and send sync the metafield “type” accordingly. The metafield definitions act as templates that specify what part of your store a metafield applies to and what values the metafield can have. Adding metafield definitions ensures that the same validation rules apply to every value that you enter for a specific metafield.
- The suggested approach to get the metafield definition is to use a GraphQL endpoint.
- You can sync metafield definitions only in the standard and premium editions of the integration app.
To sync metafield definitions, check the Sync Shopify metafield definitions check box in the Settings > General section. Check the box to get the metafield definitions for the Shopify products and their variants. If you add or update the metafield definitions in Shopify, ensure to check the box and click Save in the Settings tab to sync the metafields with the appropriate metafield type.
Find metafield definitions in Shopify
Each metafield and metafield definition has a type, which defines the type of information that it can store. To understand more about the supported values for the Type field, see Metafield types. You can add a metafield definition or create a custom metafield definition in Shopify.
After you add, create, or pin the metafield definition, you can find the metafield definitions in your Shopify store in the Admin > Metafields section.
Note: You can pin upto 20 metafield definitions.
Types of metafield definitions
There are different types of metafield definitions and each type has its own instructions for adding values to the metafield. For more information, see Metafield content types and values. The integration app allows you to add 100 metafield definitions for each store per resource.
Configure setting in the integration app
In the Shopify - NetSuite integration app, in the Settings > General section, check the Sync Shopify metafield definitions box to sync the metafield definitions for the Shopify products and their variants. If you add or update the metafield definitions in Shopify, ensure to check the box and click Save in the Settings tab to bring the metafields with the appropriate metafield type.
Note: If the metafield definitions are not created in Shopify, the item or matrix item flow assigns one of the default metafield types (single_line_text_field, number_integer, number_decimal, boolean, json, or date) based on the metafield value.
If you do not check the Sync Shopify metafield definitions box and click Save in the Settings > General section, an error message, “Unable to set the metafield type, check the Sync Shopify metafield definitions check box and click Save in the Settings tab. To resolve the error, click Retry on the integration app Dashboard.
- Support product metafields at the variant level
- Map metafields at product level using the saved search
- Configure metafields using the “Specify your Shopify variant metafield components” setting
- Configure metafields using the NetSuite saved search
- Map Shopify item metafields at the variant level using NetSuite saved search