Commerce report type
Review the Commerce report schema and parameters.
The Commerce report returns a snapshot of the catalogue feed you’ve imported through the Stripe product feed. Use this report to export your catalogue for bulk edits and re-import, or to verify that what you’ve imported matches Stripe’s records and perform programmatic reconciliation. The following tables define the required and optional parameters to run the report, as well as the schema of the CSV output.
| Report type | Required run parameters | Optional run parameters |
|---|---|---|
catalog_feed.product.1 Columns | columns |
Catalog Feed Product
API report type: catalog_feed.product.1
| Column name | Default | Description |
|---|---|---|
| additional_image_link | Comma-separated list of additional product image URLs. | |
| age_group | Intended age group: newborn, infant, toddler, kids, or adult. | |
| age_restriction | Minimum age requirement for this product. | |
| applicable_fees | Comma-separated fees in country:region:fee_label:fee_amount[:fee_basis] format. | |
| availability | Availability status: in_stock, out_of_stock, preorder, or backorder. | |
| availability_date | Expected availability date for preorder items (ISO 8601). | |
| brand | Brand associated with the product. | |
| color | Product color. | |
| condition | Product condition: new, refurbished, or used. | |
| custom_label_0 | Custom label 0 for merchant-defined tagging. | |
| custom_label_1 | Custom label 1 for merchant-defined tagging. | |
| custom_label_2 | Custom label 2 for merchant-defined tagging. | |
| custom_label_3 | Custom label 3 for merchant-defined tagging. | |
| custom_label_4 | Custom label 4 for merchant-defined tagging. | |
| custom_variant_option_name_1 | First custom variant option name. | |
| custom_variant_option_name_2 | Second custom variant option name. | |
| custom_variant_option_name_3 | Third custom variant option name. | |
| custom_variant_option_value_1 | First custom variant option value. | |
| custom_variant_option_value_2 | Second custom variant option value. | |
| custom_variant_option_value_3 | Third custom variant option value. | |
| description | Product description. | |
| disable_checkout | Whether checkout is disabled for this product. | |
| expiration_date | Date after which the product listing expires (ISO 8601). | |
| free_shipping_threshold | Comma-separated free shipping thresholds in country:region:service:price_threshold format. | |
| gender | Intended gender: male, female, or unisex. | |
| google_product_category | Google product category ID or full taxonomy path. | |
| gtin | Global Trade Item Number (the related setting). | |
| height | Product height with unit, e.g. 20 in. | |
| id | Unique identifier for this product. | |
| image_link | Primary product image URL. | |
| inventory_not_tracked | Whether inventory tracking is disabled for this product. | |
| inventory_quantity | Available inventory quantity. | |
| item_group_id | Identifier grouping product variants. | |
| item_group_title | Title for the product variant family. | |
| length | Product length with unit, e.g. 20 in. | |
| link | Product page URL. | |
| material | Primary material of the product. | |
| model_3d_link | Product 3D model URL (GLB/the related setting). | |
| mpn | Manufacturer Part Number (MPN). | |
| popularity_score | Popularity signal score on a 0-5 scale. | |
| price | Base price with currency, e.g. 15.00 USD. | |
| product_category | Merchant-defined category, using > as separator. | |
| product_review_count | Number of product reviews. | |
| product_review_rating | Average product rating on a 1-5 scale. | |
| product_warning | Comma-separated product warnings in type:message format. | |
| related_products | Comma-separated related products in relationship_type:target_id format. | |
| return_rate | Return rate as a number from 0-100. | |
| sale_price | Sale price with currency, e.g. 12.99 USD. | |
| sale_price_effective_date | ISO 8601 date range during which the sale price applies, e.g. 2025-12-01/2025-12-15. | |
| shipping | Comma-separated shipping options in country:delivery_area:service:speed_range:price format. | |
| shipping_cost_basis | Whether shipping cost applies per_order or per_item. | |
| shipping_exclusions | Comma-separated shipping exclusions in country:delivery_area:service format. | |
| shipping_tax_behavior | Tax behavior for shipping charges: inclusive or exclusive. | |
| size | Product size. | |
| size_system | ISO 3166 country code for the sizing system. | |
| stripe_product_tax_code | Stripe product tax code, e.g. txcd_99999999. | |
| tax_behavior | Tax behavior for the product price: inclusive or exclusive. | |
| third_party_tax_code | Third-party tax code in provider:tax_code format, e.g. anrok:prod_abc123. | |
| title | Product title. | |
| video_link | Product video URL. | |
| weight | Product weight with unit, e.g. 2.5 lb. | |
| width | Product width with unit, e.g. 20 in. |