Shopify Metafield & Attribute Mapping for TikTok Shop Category Attributes.
Overview
When you list a product on TikTok Shop, TikTok asks for category attributes — details such as Material, Gender, Pattern, or Recommended Uses that describe the product and help it appear correctly in search and browsing. Depending on the category, some of these attributes are required.
The Metafield & Attribute Mapping feature lets you decide, for each attribute, where its value comes from: a fixed TikTok value, or a Shopify metafield on each product.
Now you can map an attribute to a Shopify metafield instead, so each product sends its own value: one product's material can be "Acrylic" while another's is "Leather
Where to Find It

- In the TikTok Shop Sync app, open Profiles and select (or create) the profile for your products.
- Choose your category under Select preferred TikTok shop category.
- Attribute mapping is in the Attributes section of the profile, where each attribute has a source dropdown and a value dropdown.
Mapping Options
For each attribute, the first dropdown sets where the value comes from:
- TikTok value: use one of the standard values supported by TikTok, chosen in the Select Attribute dropdown. The same value is applied to every product using this profile.
- Shopify metafield: pull the value from each product's metafield. You choose which product metafield to use, and every product sends its own value.
- Shopify Attributes: pull the value from the each Shopify products attributes and every product sends its own value.
How to Map Attributes
- Open the profile in Profiles and select your TikTok shop category.
- In the Attributes section, set each attribute's source dropdown to TikTok value, Shopify Attributes or Shopify metafield.
- Pick the value: a TikTok value, or the product metafield to read from — for example, map Style to a metafield and Gender to a TikTok value.
- Click Save.
- Upload or re-upload your products to TikTok to apply the mapping.
How It Works
- Mapping is applied per product at upload. Attributes mapped to a metafield send each product's own value; attributes mapped to a TikTok value send the same value for every product.
- If an attribute value can't be resolved when a product uploads (for example, a mapped metafield is empty for that product), the app flags the attribute as not resolved on the product's TikTok profile. The listing still uploads to TikTok, but those attributes need attention. ( Screenshot attached for reference)

- To fix unresolved attributes, open the product's profile, map or correct the values, click Save, and re-upload the product.
- After an upload or re-upload, TikTok may place the product In review. Changes only take effect once TikTok approves the product, which can take some time. Once approved, you can confirm on TikTok Seller Center that each attribute shows the correct per-product value.
Important Notes
- Mapping to a Shopify metafield and Shopify Attributes lets each product send its own attribute value; a TikTok value applies the same value to every product in the profile.
- Unresolved attributes don't block the upload, but the listing won't be complete on TikTok until they're resolved and the product is re-uploaded.
- TikTok's review step can delay when your changes appear live.
Frequently Asked Questions
Can different products send different attribute values?
Yes. Map the attribute to a Shopify metafield and each product sends its own value. A TikTok value applies the same value to every product in the profile.
What happens if an attribute can't be resolved?
The product still uploads to TikTok, but the app marks the attribute as not resolved. Fix the value in the profile, click Save, and re-upload the product.
Why don't my changes show on TikTok right away?
After you upload or re-upload, TikTok may place the product in review. Your changes take effect once TikTok approves the product.
Updated on: 06/08/2026
Thank you!