Shopify metafields allow you to store additional information for products, collections, orders, blogs, pages, and your shop that cannot be managed using Shopify’s native fields. For example, if you want to maintain extra description fields for your catalog, such as detailed descriptions or featured descriptions, you can easily create custom fields in NetSuite. However, in Shopify, this is achieved using the metafields functionality. A Shopify metafield includes a namespace, a key, a value, and an optional description. For additional info, refer to the Shopify help article.
Tip
- Find additional Celigo migration resources at Shopify 2024-04 API release: Product REST API deprecation.
- For information about metafields mapping at variant level using a saved search, see Map Shopify item metafields at the variant level using NetSuite saved search.
The integration app enables you to map NetSuite standard/custom fields to Shopify metafields (if they already exist) and/or create the metafields in Shopify directly via the integration app and then map and update them.
Notes
-
Celigo supports all Shopify metafields except list types and metaobjects.
-
Ensure that all metafields are accurately defined in the saved search and mapping or setting to prevent the deletion of existing metafields in Shopify for a product. As stated by Shopify, any list field (e.g., collections, metafields, variants) will be updated such that included entries are created or updated, while existing entries not included will be deleted. For more details, refer to productSet.
Effective March 17, 2025: this behavior will change, aligning with the default REST flow behavior.-
Metafields will no longer be deleted, even if they are not defined in the mappings or are incorrectly defined.
-
Mapping metafields explicitly will not be necessary, as the default behavior of REST flows ensures that mappings are retained and not deleted.
-
Mapping Shopify metafields to NetSuite standard/custom fields
Start by selecting the standard or custom field(s) in NetSuite that you want to map to the corresponding metafield in Shopify. In the example below, we have highlighted a few fields that will be mapped to their respective Shopify metafields.
Next, navigate to the saved search in NetSuite used for exporting items from NetSuite to Shopify. If you are using the saved search provided by the bundle, its name should begin with "Celigo Shopify Item Export [your store name]." Open the saved search in edit mode and go to the Results tab.
In the Results tab, you will find all the fields configured for transfer to Shopify. In this use case, the fields ValueDemo(Meta) and ValueiPad(Meta) are utilized for metafield mapping.
Important
The label name must be suffixed with (Meta) to be identified as a meta field by the integration app (see image below). So for example: if you need to map the "ValueiPad" field, the custom label should be "ValueiPad (Meta)". Add as many fields as you like and then save the changes to the Saved Search.
-
Now, go to integrator.io and navigate to the Shopify - NetSuite integration app.
-
In the Flows > Product section, open the "Field Mappings" for the NetSuite Item to Shopify Product Add/Update flow.
-
Click Post products to Shopify.
-
Click + to add a new row under the product object.
- Select the data type as [Object] - array of object.
-
From the source object dropdown list, select the metafields object. In this case, it is meta [*].
-
In the destination object field, enter the name of your choice. In this case savedSearchProductMetafields.
Note: The field names are case-sensitive. Ensure that you enter the field names with the correct capitalization.
-
Click + within the object, to add a new row to your field mappings.
-
Click the field dropdown list.
-
Type in
ValueiPad (Meta)and select.
-
-
Click + to add another field.
-
Click the field dropdown list.
-
Type in
ValueDemo (Meta)and select.
-
Note
Namespace and key are colon-separated.
The following is an example of a namespace and key value in a sample Shopify Product API.
In the mapping section for destination fields, enter the namespace and key values for the ValueiPad (Meta) and ValueDemo (Meta) fields using the specified format above. Then, click Save to complete the mapping successfully.
Once the mapping is done, you can run the flow and you view the updated metafield data in Shopify.
Creating metafields if they do not exist
If you don't have metafields already created, directly add the 'namespace' and 'key' values in the mapping editor in the specified format (product.metafields[*].namespace:key) and the integration app will create the metafields in Shopify.
Viewing metafields in Shopify
Go to a Shopify Product and in the URL, append with the term 'metafields.json' and press 'Enter'.
Related Topics