How to Send Custom Shopify Metafields to Amazon Listings
Introduction:
This guide explains how to send custom information stored in Shopify Variant Metafields to specific attributes on your Amazon listings when creating new listings using our app. This is useful for data that doesn't have a standard field in Shopify but is required or beneficial for your Amazon listings (e.g., material composition, specific dimensions, style notes).
Important Note: This process is applicable when you are creating new listings on Amazon using the Matching Groups and Models features within our app.
Step 1: Create and Populate the Metafield in Shopify
First, you need to define the metafield in Shopify and then add the relevant data to your product variants.
Define the Variant Metafield in Shopify:
In your Shopify admin, navigate to Settings.
Go to Custom Data.
Select Variants (under "Metafields").
Click Add definition to create the new metafield you need.
Give it a clear Name (e.g., "Material Composition," "Country of Origin").
Shopify will generate a Namespace and key (e.g., custom.material_composition). Note this down, as it might be helpful for identification.
Select the appropriate Type (e.g., Single-line text, Integer, True or False).
Add a Description if desired.
Save your new metafield definition.
Add Data to Your Variants in Shopify:
Go to your Products in Shopify.
Select a product you want to update.
Scroll down to the Variants section.
Click Edit for each variant (or use the bulk editor).
Find the metafield you just created (it will appear as a field at the bottom of the variant details page or as a column in the bulk editor).
Enter the specific information for that variant into the metafield.
Save your changes to the product/variants.
Repeat this for all relevant variants that need this custom data.
Step 2: Sync Metafield Data with Our App
Now, you need to ensure our app is aware of the new metafield definition and has the latest values you've entered.
Import Metafield Definitions:
In our app, navigate to Actions.
Under Actions, select Operations.
Execute the operation: Full metafield import from Shopify.
Wait for this process to complete. This step tells our app about the new metafield structure you created in Shopify.
Import Metafield Values:
Still under Actions > Operations, execute the operation: Full inventory import from Shopify.
Wait for this process (timer) to complete. This step pulls the actual data you entered into the metafields for each variant into our app.
Step 3: Map the Metafield to an Amazon Attribute in a Model
Finally, you'll tell the app which Amazon attribute should receive the data from your Shopify metafield.
Navigate to the Models > Models section in our app.
Find and Edit the specific Model you are using (or will use) for the products that have this new metafield. (Models are typically linked to product types or categories you set up in Matching Groups).
Within the Model editor, find the Amazon Attribute where you want this custom data to appear (e.g., "material_composition," "bullet_point," etc.).
You might need to add the attribute to your Model if it's not already there.
Click on the dropdown menu next to "Existing Values" (or a similarly named field for selecting the data source) for that Amazon attribute.
From the dropdown list, find and select the Shopify metafield you created and synced in the previous steps (it will usually be listed with its namespace and key, like custom.material_composition).
Save the changes to your Model.
Outcome:
Once you have completed these steps, when you use this Model to create new listings on Amazon, the app will automatically pull the data from the specified Shopify variant metafield and send it to the mapped Amazon attribute for each corresponding product.
This guide explains how to send custom information stored in Shopify Variant Metafields to specific attributes on your Amazon listings when creating new listings using our app. This is useful for data that doesn't have a standard field in Shopify but is required or beneficial for your Amazon listings (e.g., material composition, specific dimensions, style notes).
Important Note: This process is applicable when you are creating new listings on Amazon using the Matching Groups and Models features within our app.
Step 1: Create and Populate the Metafield in Shopify
First, you need to define the metafield in Shopify and then add the relevant data to your product variants.
Define the Variant Metafield in Shopify:
In your Shopify admin, navigate to Settings.
Go to Custom Data.
Select Variants (under "Metafields").
Click Add definition to create the new metafield you need.
Give it a clear Name (e.g., "Material Composition," "Country of Origin").
Shopify will generate a Namespace and key (e.g., custom.material_composition). Note this down, as it might be helpful for identification.
Select the appropriate Type (e.g., Single-line text, Integer, True or False).
Add a Description if desired.
Save your new metafield definition.
Add Data to Your Variants in Shopify:
Go to your Products in Shopify.
Select a product you want to update.
Scroll down to the Variants section.
Click Edit for each variant (or use the bulk editor).
Find the metafield you just created (it will appear as a field at the bottom of the variant details page or as a column in the bulk editor).
Enter the specific information for that variant into the metafield.
Save your changes to the product/variants.
Repeat this for all relevant variants that need this custom data.
Step 2: Sync Metafield Data with Our App
Now, you need to ensure our app is aware of the new metafield definition and has the latest values you've entered.
Import Metafield Definitions:
In our app, navigate to Actions.
Under Actions, select Operations.
Execute the operation: Full metafield import from Shopify.
Wait for this process to complete. This step tells our app about the new metafield structure you created in Shopify.
Import Metafield Values:
Still under Actions > Operations, execute the operation: Full inventory import from Shopify.
Wait for this process (timer) to complete. This step pulls the actual data you entered into the metafields for each variant into our app.
Step 3: Map the Metafield to an Amazon Attribute in a Model
Finally, you'll tell the app which Amazon attribute should receive the data from your Shopify metafield.
Navigate to the Models > Models section in our app.
Find and Edit the specific Model you are using (or will use) for the products that have this new metafield. (Models are typically linked to product types or categories you set up in Matching Groups).
Within the Model editor, find the Amazon Attribute where you want this custom data to appear (e.g., "material_composition," "bullet_point," etc.).
You might need to add the attribute to your Model if it's not already there.
Click on the dropdown menu next to "Existing Values" (or a similarly named field for selecting the data source) for that Amazon attribute.
From the dropdown list, find and select the Shopify metafield you created and synced in the previous steps (it will usually be listed with its namespace and key, like custom.material_composition).
Save the changes to your Model.
Outcome:
Once you have completed these steps, when you use this Model to create new listings on Amazon, the app will automatically pull the data from the specified Shopify variant metafield and send it to the mapped Amazon attribute for each corresponding product.
Updated on: 14/05/2025
Thank you!