> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://tiktokshopintegration.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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__

![](https://storage.crisp.chat/users/helpdesk/website/-/1/0/4/3/1043fa0a95edac00/image_8o6w9o.png)

* 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__

1. Open the profile in **Profiles** and select your **TikTok shop category**.
2. In the **Attributes** section, set each attribute's source dropdown to **TikTok value, Shopify Attributes** or **Shopify metafield**.
3. 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.
4. Click **Save**.
5. 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)**

![](https://storage.crisp.chat/users/helpdesk/website/-/1/0/4/3/1043fa0a95edac00/image_11nm7qs.png)
* 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.

---