Dynamic Product Ads on X.
X's shopping spec is the smallest of the nine: 28 fields, eight required, no recommended tier, and a set of 100-character limits on identifiers, colour and size that other channels set at 50 or 200.
Beyond the required fields, X needs at least one of brand, gtin or mpn, ignores every instance of a duplicate id, and will not show an in stock product whose inventory is 0.
Generated from the Ducted X (Twitter) Shopping template, the same field rules your mapping is validated against.
28 fields: 8 required, 20 optional.
| Field | Level | Accepted values / example |
|---|---|---|
| id | required | TWSHOES-22 |
| title | required | X Blue Sneakers |
| description | required | The first of its kind at X, the X Blue Sneaker is a sleek, fashionable athletic sneaker. |
| availability | required | in stock · available for order · preorder · out of stock · discontinued |
| condition | required | new · used · refurbished |
| price | required | 99.99 USD |
| link | required | https://www.x.com/medium_tshirt |
| image_link | required | https://t.co/demin_jeans_452.jpg |
Field rules from the official spec, verified 2026-10-02.
Also supported, always optional (20): brand, gtin, mpn, mobile_link, additional_image_link, google_product_category, product_type, inventory, sale_price, sale_price_effective_date, item_group_id, gender, color, size, age_group, custom_label_0, custom_label_1, custom_label_2, custom_label_3, custom_label_4
X requires at least one of the three product identifiers on every record, and recommends all of them for Dynamic Product Ads.
X ignores every instance of a duplicate id, the original included. Two records sharing an id both disappear.
When availability is in stock, inventory must be 1 or higher, or X will not show the product. available for order and preorder may carry 0.
color is a name (blue, forest green), never a hex code; product_type levels are separated by " > " with a space on each side. Descriptions are plain text with no HTML and no excessive capitalisation.
One mapped catalog serves every channel; each page covers what that platform's feed needs.
Add an X Shopping output to an existing project, or start free and map your first.