How do I add sizes and colors as variants in my catalog?
Give each variant its own row with a unique content ID, then put the same item_group_id on every variant of that product. Add at least one variant attribute, such as color, size, material, pattern or gender, and fill the same attributes for every variant in the group so each one is a unique combination.
In a Meta catalog, a variant isn’t a sub-item inside a product. Each size or color is its own product row, and a shared group ID ties the rows together into one virtual parent. Meta says setting variants up this way makes them display correctly in your ads and shop.
How do you add variants with a data feed?
- Add an item_group_id column to your feed.
- Give every variant of one product the same group ID, which often matches the parent SKU.
- Give each variant its own unique content ID in the id column.
- Make sure no group ID is the same as any content ID in your catalog.
- Add one or more variant attributes: color, size, material, pattern, gender or additional_variant_attribute.
- Fill the same attributes for every variant in the group, with a unique combination for each.
- Upload the file as a new feed or as an update to your existing one.
What does a correct setup look like?
Meta’s example of three valid variants:
| id | title | item_group_id | color | size |
|---|---|---|---|---|
| 1234 | Blue shirt | shirt_1 | blue | small |
| 5678 | Red shirt | shirt_1 | red | small |
| 9123 | Green shirt | shirt_1 | green | large |
Meta calls a setup incorrect when a variant leaves an attribute blank, when two variants share the same color and size, or when you send the parent SKU as its own row with the variant attribute left empty.
What tips does Meta give?
- A different image alone doesn’t make a variant; it needs at least one variant attribute.
- Give variants that look different their own main image; size variants can share one.
- Use a unique link for each variant, ideally to a page with that variant pre-selected.
- Keep every variant of a product in the same data feed.
- When adding variants to an existing product, keep its original content ID on one variant, so pixel event data for the product is preserved.
- Size is required for clothing and shoes if you sell with shops on Facebook and Instagram.
How many variants can a product have?
| Method | Limit Meta gives |
|---|---|
| Added manually in Commerce Manager | Up to 100 per product |
| Added with a data feed | Up to 800, with a warning above 300 |
Variants you add manually need their price, availability and other data updated one by one.
FAQ
Why does my ad show only one color of a product?
Meta says that when a product set contains several variants of one product, only one variant displays per ad. A set with 10 items where 8 are variants of one product counts as 3 unique products. Add distinct products if a format needs a minimum.
How do I take a variant out of its group?
Find the variant in your feed and delete its value in the item_group_id field, then upload. To remove the variant entirely, delete it as you would any product using your data feed. Variants added manually are deleted manually.
Do Shopify variants sync on their own?
Yes. Meta says that if you manage products on a connected partner platform such as Shopify, the variants you’ve set up there sync to Commerce Manager. Check how Shopify syncs product images so each variant gets your preferred image.
Sources
- Manage variants in your catalog in Commerce Manager (Meta, checked 2 Oct 2026)
- Product variants (Meta for Developers) (Meta, checked 2 Oct 2026)
- Troubleshoot not enough products in product set or product set is empty in Meta Ads Manager (Meta, checked 2 Oct 2026)
- Troubleshoot data feed errors in your catalog (Meta, checked 2 Oct 2026)
Drafted with AI and checked claim by claim against the pages linked under Sources. Found a mistake? Tell us via the corrections policy.