How to Fix “Category ID missing or invalid” in TikTok Catalog
TikTok validates each row against its own category tree. Sending a Google product category string, an internal collection name or nothing at all fails validation.
Scan your feed for this error for free
Paste your product feed URL (XML, CSV or JSON). The audit checks Category ID missing or invalid for TikTok taxonomy along with 25+ other pre-channel rules.
Why this happens
Technical root cause
Most catalogs already carry a Google taxonomy value because Merchant Center requires it. TikTok expects a numeric TikTok category ID, so the value has to be cross-mapped rather than reused.
TikTok Catalog reports it as Category ID missing or invalid for TikTok taxonomy and applies: Product rejected or excluded from category-based targeting.
Native CMS friction
Shopify
The standard product taxonomy maps to Google, not TikTok, so the exported value never validates.
VTEX
Category trees are merchant-defined and bear no relation to any marketplace taxonomy.
WooCommerce
Product categories are free-form terms created by the store owner.
Fixing it manually
- 1
Download TikTok's category list for your market.
- 2
Group your catalog by Google product category or internal collection.
- 3
Assign one TikTok category ID per group and record the mapping in a table.
- 4
Apply the mapping during export and revalidate the upload.
The IRONFEED automated solution
One rule, applied to every product on every export. No spreadsheets, no re-uploads.
IF tiktok_category_id IS EMPTY
SET tiktok_category_id = lookup('tiktok_taxonomy', google_product_category)
ELSE SET tiktok_category_id = lookup('tiktok_taxonomy', product_type)Run automatic linter checks before TikTok Catalog crawls your feed. IRONFEED validates every export against the channel spec, so this error is caught in Feed Review instead of in your channel dashboard.
Attribute requirements
| Attribute | TikTok Shop requirement | Accepted format | IRONFEED transformation |
|---|---|---|---|
category_id | Required; must exist in TikTok's taxonomy | Numeric TikTok category identifier | Lookup table cross-mapping Google categories to TikTok IDs |
google_product_category | Optional here, required for Google feeds | Numeric Google taxonomy ID or full path | Used as the mapping key |
Frequently asked questions
Related Feed Issues & Fixes
Other critical errors affecting catalog performance on Google, Meta, TikTok, and Mercado Libre.
Image aspect ratio not supported (must be 1:1)
Storefront photography is shot for product pages, commonly at 4:5 or 3:2. Feed exports pass the original aspect ratio through with no canvas normalization step.
View Fix & RuleSKU ID cannot be empty
SKU is an optional merchandising field in most storefronts. Products created quickly, or imported in bulk, frequently have no SKU at all, and the export writes an empty cell rather than deriving an identifier.
View Fix & RuleCombinación de variantes no válida para la categoría
Store catalogs allow arbitrary option names such as material, flavour or pack size. Mercado Libre rejects axes its category does not define, and it also rejects two variants that resolve to the same combination.
View Fix & RuleLooking for a different error?