--- title: Type alias: ProductFeedItemInput slug: chord-ui/type-alias-productfeediteminput docTags: createdAt: 2023-11-06T15:03:31.906Z --- [product-rss-feed](docId:6Uo_tqnsPfSBPjDRuymKw).ProductFeedItemInput Ƭ **ProductFeedItemInput**: `Object` This schema represents Chord's understanding of what is expected by Google's Merchant Feed and Facebook's Data Feed for Product Listings. The minimal fields that are required are: - `id` - `title` - `description` - `availability` - `image_link` - `gtin` | `mpn` | `identifier_exists = false` [Google Merchant Feed Specification](https://support.google.com/merchants/answer/7052112) [Facebook Data Feed Reference](https://www.facebook.com/business/help/120325381656392) ### Type declaration | Name | Type | Description | | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `additional_image_link?` | `string` \| `string`\[] | One or more additional images describing the product. [https://support.google.com/merchants/answer/6324370](https://support.google.com/merchants/answer/6324370) | | `ads_redirect?` | `string` | URL for an ad to redirect to. [https://support.google.com/merchants/answer/6324450](https://support.google.com/merchants/answer/6324450) | | `adult?` | [`feedBool`](docId\:MofCiiGa8NUC_hN0CJyUf) | [https://support.google.com/merchants/answer/6324508](https://support.google.com/merchants/answer/6324508) | | `age_group?` | `"newborn"` \| `"infant"` \| `"toddler"` \| `"kids"` \| `"adult"` | [https://support.google.com/merchants/answer/6324463](https://support.google.com/merchants/answer/6324463) | | `availability?` | `"in_stock"` \| `"out_of_stock"` \| `"preorder"` \| `"backorder"` \| `string` | This value must roughly match the type union to be valid. If strictly validated, the string will have spaces replaced with `_` and lower cased before validation. [https://support.google.com/merchants/answer/6324448](https://support.google.com/merchants/answer/6324448) | | `availability_date?` | [`flexibleDate`](docId\:KTZah9Qlq1CK8hNvEMu_4) | [https://support.google.com/merchants/answer/6324470](https://support.google.com/merchants/answer/6324470) | | `brand?` | `string` | [https://support.google.com/merchants/answer/6324351](https://support.google.com/merchants/answer/6324351) | | `canonical_url?` | `string` | [https://support.google.com/merchants/answer/9340054](https://support.google.com/merchants/answer/9340054) | | `certification?` | \{ `certification_authority`: `string` ; `certification_code`: `string` ; `certification_name`: `string` } | [https://support.google.com/merchants/answer/13528839](https://support.google.com/merchants/answer/13528839) | | `certification.certification_authority` | `string` | - | | `certification.certification_code` | `string` | - | | `certification.certification_name` | `string` | - | | `color?` | `string` | [https://support.google.com/merchants/answer/6324487](https://support.google.com/merchants/answer/6324487) | | `condition?` | `"new"` \| `"refurbished"` \| `"used"` | [https://support.google.com/merchants/answer/6324469](https://support.google.com/merchants/answer/6324469) | | `cost_of_goods_sold?` | [`numberPlusCurrency`](docId\:lx4y3-W5Ltsdg1Cve86gW) | [https://support.google.com/merchants/answer/9017895](https://support.google.com/merchants/answer/9017895) | | `custom_label_0?` | `string` | - | | `custom_label_1?` | `string` | - | | `custom_label_2?` | `string` | - | | `custom_label_3?` | `string` | - | | `custom_label_4?` | `string` | - | | `custom_labels?` | `string`\[] | If you want to include custom labels for this product, you must either provide an array of `custom_labels` or them individually as `custom_label_0 ... custom_label_4` but not both. [https://support.google.com/merchants/answer/6324473](https://support.google.com/merchants/answer/6324473) | | `custom_number_0?` | `number` \| `string` | - | | `custom_number_1?` | `number` \| `string` | - | | `custom_number_2?` | `number` \| `string` | - | | `custom_number_3?` | `number` \| `string` | - | | `custom_number_4?` | `number` \| `string` | - | | `custom_numbers?` | (`string` \| `number`)\[] | Up to five custom fields for any additional number-related information you want to filter items by when you create product sets. These fields allow you to filter by number ranges (is greater than and is less than) when you create a set. For example, you could use a custom number field to indicate the year each item was produced, and then filter a certain year range into a set. These field supports whole numbers between 0 and 4294967295. It doesn't support negative numbers, decimal numbers or commas, such as -2, 5.5 or 10,000. | | `description` | `string` | [https://support.google.com/merchants/answer/6324468](https://support.google.com/merchants/answer/6324468) | | `disclosure_date?` | [`flexibleDate`](docId\:KTZah9Qlq1CK8hNvEMu_4) | [https://support.google.com/merchants/answer/13034208](https://support.google.com/merchants/answer/13034208) | | `energy_efficiency_class?` | [`energyEfficiencyClass`](docId\:gE2olceLwwlH3W9EzDq5h) | [https://support.google.com/merchants/answer/7562785](https://support.google.com/merchants/answer/7562785) | | `excluded_destination?` | [`googleDestinations`](docId:31PvtN_UUAL5MTWIquikV) | [https://support.google.com/merchants/answer/6324486](https://support.google.com/merchants/answer/6324486) | | `expiration_date?` | [`flexibleDate`](docId\:KTZah9Qlq1CK8hNvEMu_4) | [https://support.google.com/merchants/answer/6324499](https://support.google.com/merchants/answer/6324499) | | `external_seller_id?` | `string` | [https://support.google.com/merchants/answer/11537846](https://support.google.com/merchants/answer/11537846) | | `fb_product_category?` | `string` | Use either the name or the ID from the link below. [https://www.facebook.com/business/help/120325381656392?id=725943027795860#Optional](https://www.facebook.com/business/help/120325381656392?id=725943027795860#Optional) [https%3A%2F%2Fwww.facebook.com%2Fproducts%2Fcategories%2Fen\_US.txt\&event\_type=click\&last\_nav\_impression\_id=2jSfG2BV7qrbdQcU2\&max\_percent\_page\_viewed=47\&max\_viewport\_height\_px=1239\&max\_viewport\_width\_px=1505\&orig\_http\_referrer=@link https%3A%2F%2Fwww.google.com%2F\&orig\_request\_uri=@link https%3A%2F%2Fwww.facebook.com%2Fbusiness%2Fhelp%2F120325381656392\&primary\_cmsid=120325381656392\&primary\_content\_locale=en\_US\®ion=noam\&scrolled=true\&session\_id=1iaetjZMQ8SvHO2Xk\&site=fb4b\&extra\_data\[view\_type\]=v3\_initial\_view\&extra\_data\[site\_section\]=help\&extra\_data\[placement\]=%2Fbusiness%2Fhelp%2F120325381656392](https://www.facebook.com/micro_site/url/?click_from_context_menu=true\&country=US\&destination=@link) | | `gender?` | `"male"` \| `"female"` \| `"unisex"` | [https://support.google.com/merchants/answer/6324479](https://support.google.com/merchants/answer/6324479) | | `google_product_category?` | `string` | [https://support.google.com/merchants/answer/6324436](https://support.google.com/merchants/answer/6324436) | | `gtin?` | `string` | This is either a UPC, EAN, JAN or ISBN. It will be validated as a sequence of numbers that are 8, 12, 13 or 14 digits long. [https://support.google.com/merchants/answer/6324461](https://support.google.com/merchants/answer/6324461) | | `id` | `string` | [https://support.google.com/merchants/answer/6324405](https://support.google.com/merchants/answer/6324405) | | `identifier_exists?` | [`feedBool`](docId\:MofCiiGa8NUC_hN0CJyUf) | If neither a `gtin` or `mpn` is provided, this field must be set to `false`. [https://support.google.com/merchants/answer/6324478](https://support.google.com/merchants/answer/6324478) | | `image_link` | `string` | [https://support.google.com/merchants/answer/6324350](https://support.google.com/merchants/answer/6324350) | | `included_destinations?` | `string` | [https://support.google.com/merchants/answer/7501026](https://support.google.com/merchants/answer/7501026) | | `installment?` | [`installment`](docId\:AbpDXUQysE1eFZJzIUT_H) | [https://support.google.com/merchants/answer/6324474](https://support.google.com/merchants/answer/6324474) | | `is_bundle?` | [`feedBool`](docId\:MofCiiGa8NUC_hN0CJyUf) | [https://support.google.com/merchants/answer/6324449](https://support.google.com/merchants/answer/6324449) | | `item_group_id?` | `string` | [https://support.google.com/merchants/answer/6324507](https://support.google.com/merchants/answer/6324507) | | `lifestyle_image_link?` | `string` | [https://support.google.com/merchants/answer/9103186](https://support.google.com/merchants/answer/9103186) | | `link?` | `string` | [https://support.google.com/merchants/answer/6324416](https://support.google.com/merchants/answer/6324416) | | `material?` | `string` | [https://support.google.com/merchants/answer/6324410](https://support.google.com/merchants/answer/6324410) | | `max_energy_efficiency_class?` | [`energyEfficiencyClass`](docId\:gE2olceLwwlH3W9EzDq5h) | [https://support.google.com/merchants/answer/7562785](https://support.google.com/merchants/answer/7562785) | | `max_handling_time?` | `number` \| `string` | [https://support.google.com/merchants/answer/7388496](https://support.google.com/merchants/answer/7388496) | | `min_energy_efficiency_class?` | [`energyEfficiencyClass`](docId\:gE2olceLwwlH3W9EzDq5h) | [https://support.google.com/merchants/answer/7562785](https://support.google.com/merchants/answer/7562785) | | `min_handling_time?` | `number` \| `string` | [https://support.google.com/merchants/answer/7388496](https://support.google.com/merchants/answer/7388496) | | `mobile_link?` | `string` | [https://support.google.com/merchants/answer/6324459](https://support.google.com/merchants/answer/6324459) | | `mpn?` | `string` | This is a string that is between 1-70 characters that is basically a product's slug. [https://support.google.com/merchants/answer/6324482](https://support.google.com/merchants/answer/6324482) | | `multipack?` | `number` \| `string` | [https://support.google.com/merchants/answer/6324488](https://support.google.com/merchants/answer/6324488) | | `pattern?` | `string` | [https://support.google.com/merchants/answer/6324483](https://support.google.com/merchants/answer/6324483) | | `pause?` | `"ads"` \| `"all"` | [https://support.google.com/merchants/answer/11909930](https://support.google.com/merchants/answer/11909930) | | `price` | [`numberPlusCurrency`](docId\:lx4y3-W5Ltsdg1Cve86gW) | [https://support.google.com/merchants/answer/6324371](https://support.google.com/merchants/answer/6324371) | | `product_detail?` | \{ `attribute_name`: `string` ; `attribute_value`: `string` ; `section_name?`: `string` }\[] | [https://support.google.com/merchants/answer/9218260](https://support.google.com/merchants/answer/9218260) | | `product_height?` | [`measurement`](docId\:IKxACOg9WZBMFXOsBfs7v)\<`"in"` \| `"cm"`> | [https://support.google.com/merchants/answer/11018531](https://support.google.com/merchants/answer/11018531) | | `product_highlight?` | `string` \| `string`\[] | [https://support.google.com/merchants/answer/9216100](https://support.google.com/merchants/answer/9216100) | | `product_length?` | [`measurement`](docId\:IKxACOg9WZBMFXOsBfs7v)\<`"in"` \| `"cm"`> | [https://support.google.com/merchants/answer/11018531](https://support.google.com/merchants/answer/11018531) | | `product_type?` | `string` | [https://support.google.com/merchants/answer/6324406](https://support.google.com/merchants/answer/6324406) | | `product_weight?` | [`measurement`](docId\:IKxACOg9WZBMFXOsBfs7v)\<`"lb"` \| `"oz"` \| `"kg"` \| `"g"`> | [https://support.google.com/merchants/answer/11018531](https://support.google.com/merchants/answer/11018531) | | `product_width?` | [`measurement`](docId\:IKxACOg9WZBMFXOsBfs7v)\<`"in"` \| `"cm"`> | [https://support.google.com/merchants/answer/11018531](https://support.google.com/merchants/answer/11018531) | | `quantity_to_sell_on_facebook?` | `number` \| `string` | Use this field to sync stock from the OMS to Facebook. [https://www.facebook.com/business/help/120325381656392?id=725943027795860#Checkout](https://www.facebook.com/business/help/120325381656392?id=725943027795860#Checkout) | | `rich_text_description?` | `string` | A description of the item containing rich text (HTML) formatting such as bullet points or multiple paragraphs. We recommend using rich text if the description is longer than 200 characters to help make it easier to read. If this field is provided, it will display instead of the description field wherever possible, but you must still provide description as a backup option. Character limit: 9,999. Supported HTML tags: \* ``, `
`, `
`, `
`, `` \* Header tags: `
`, `

` to `

` \* Table tags: ``, ``, ``, ``, `` \* List tags: `
    `, `
  • `, `
      `, `
      `, `
      `, `
      ` \* Other formatting tags: `

      `, ``, ``, ``, ``, ``, ``, `<small>`, `<br>`, `<div>`, `<sub>`, `<sup>`, `<pre>`, `<q>`, `<s>` [https://www.facebook.com/business/help/120325381656392?id=725943027795860#Optional](https://www.facebook.com/business/help/120325381656392?id=725943027795860#Optional) | | `sale_price?` | [`numberPlusCurrency`](docId\:lx4y3-W5Ltsdg1Cve86gW) | [https://support.google.com/merchants/answer/6324471](https://support.google.com/merchants/answer/6324471) | | `sale_price_effective_date?` | `string` \| \{ `end`: [`flexibleDate`](docId\:KTZah9Qlq1CK8hNvEMu_4) ; `start`: [`flexibleDate`](docId\:KTZah9Qlq1CK8hNvEMu_4) } | [https://support.google.com/merchants/answer/6324460](https://support.google.com/merchants/answer/6324460) | | `shipping?` | [`shipping`](docId:5uHYisQrRkORRhahUTyT8) | [https://support.google.com/merchants/answer/6324484](https://support.google.com/merchants/answer/6324484) | | `shipping_height?` | [`measurement`](docId\:IKxACOg9WZBMFXOsBfs7v)\<`"in"` \| `"cm"`> | [https://support.google.com/merchants/answer/6324498](https://support.google.com/merchants/answer/6324498) | | `shipping_label?` | `string` | [https://support.google.com/merchants/answer/6324504](https://support.google.com/merchants/answer/6324504) | | `shipping_length?` | [`measurement`](docId\:IKxACOg9WZBMFXOsBfs7v)\<`"in"` \| `"cm"`> | [https://support.google.com/merchants/answer/6324498](https://support.google.com/merchants/answer/6324498) | | `shipping_weight?` | [`measurement`](docId\:IKxACOg9WZBMFXOsBfs7v)\<`"lb"` \| `"oz"` \| `"kg"` \| `"g"`> | [https://support.google.com/merchants/answer/6324503](https://support.google.com/merchants/answer/6324503) | | `shipping_width?` | [`measurement`](docId\:IKxACOg9WZBMFXOsBfs7v)\<`"in"` \| `"cm"`> | [https://support.google.com/merchants/answer/6324498](https://support.google.com/merchants/answer/6324498) | | `ships_from_country?` | [`country`](docId\:OEXjVAI7Ur29RRp_e3CKk) | [https://support.google.com/merchants/answer/9837936](https://support.google.com/merchants/answer/9837936) | | `shopping_ads_excluded_country?` | [`country`](docId\:OEXjVAI7Ur29RRp_e3CKk)\[] | [https://support.google.com/merchants/answer/9837523](https://support.google.com/merchants/answer/9837523) | | `size?` | `string` | [https://support.google.com/merchants/answer/6324492](https://support.google.com/merchants/answer/6324492) | | `size_system?` | `"AU"` \| `"BR"` \| `"CN"` \| `"DE"` \| `"EU"` \| `"FR"` \| `"IT"` \| `"JP"` \| `"MEX"` \| `"UK"` \| `"US"` | [https://support.google.com/merchants/answer/6324502](https://support.google.com/merchants/answer/6324502) | | `size_type?` | [`sizeType`](docId\:cc_h7AsJRPGZMeNM8NmwC) \| [`sizeType`](docId\:cc_h7AsJRPGZMeNM8NmwC)\[] | [https://support.google.com/merchants/answer/6324497](https://support.google.com/merchants/answer/6324497) | | `status?` | `"active"` \| `"archived"` \| `"staging"` | [https://www.facebook.com/business/help/120325381656392?id=725943027795860#Optional](https://www.facebook.com/business/help/120325381656392?id=725943027795860#Optional) | | `subscription?` | \{ `amount`: [`numberPlusCurrency`](docId\:lx4y3-W5Ltsdg1Cve86gW) ; `period`: `"month"` \| `"year"` ; `period_length`: `string` \| `number` } | [https://support.google.com/merchants/answer/7437904](https://support.google.com/merchants/answer/7437904) | | `subscription.amount` | [`numberPlusCurrency`](docId\:lx4y3-W5Ltsdg1Cve86gW) | - | | `subscription.period` | `"month"` \| `"year"` | - | | `subscription.period_length` | `string` \| `number` | - | | `tax?` | [`tax`](docId\:NSYQ_ExP_dO-ZYDHvpX_v) | [https://support.google.com/merchants/answer/6324454](https://support.google.com/merchants/answer/6324454) | | `tax_category?` | `string` | [https://support.google.com/merchants/answer/7569847](https://support.google.com/merchants/answer/7569847) | | `title` | `string` | [https://support.google.com/merchants/answer/6324415](https://support.google.com/merchants/answer/6324415) | | `transit_time_label?` | `string` | [https://support.google.com/merchants/answer/9298965](https://support.google.com/merchants/answer/9298965) | | `unitPricingMeasure?` | [`unitPricingMeasure`](docId\:aBpiyB6DWaQglxfNqyiT8) | [https://support.google.com/merchants/answer/6324455](https://support.google.com/merchants/answer/6324455) | | `unit_pricing_base_measure?` | `string` \| \{ `unit`: [`unitPricingMeasure`](docId\:aBpiyB6DWaQglxfNqyiT8) ; `value`: `string` \| `number` } | [https://support.google.com/merchants/answer/6324490](https://support.google.com/merchants/answer/6324490) | | `video?` | \{ `url`: `string` } | The link and tags for one or more videos of your item, in JSON format. Must be a direct link to download your video file, not a link to YouTube or another video hosting platform. Include at least one tag. [https://www.facebook.com/business/help/120325381656392?id=725943027795860#Optional](https://www.facebook.com/business/help/120325381656392?id=725943027795860#Optional) | | `video.url` | `string` | - | | `virtual_model_link?` | `string` | [https://support.google.com/merchants/answer/13674896](https://support.google.com/merchants/answer/13674896) | ### Defined in [packages/product-rss-feed/src/simple/types.ts:170](https://github.com/chordcommerce/chord-ui/blob/2b105e1/packages/product-rss-feed/src/simple/types.ts#L170)

`, ``, `