Catalog feedPrivate preview

Use the product feed specification to provide your complete structured product data (for example, titles, descriptions, identifiers, pricing, fulfillment, and media). Each row represents a product or variant.

1. Format your product data using the field reference in this document. Each field includes sample values, validation rules, and whether it’s required, recommended, or optional.
2. Send your product data securely using the Stripe Product Catalog Import API in CSV format. Each row represents one product or variant. Submit a full initial feed to the sandbox endpoint to confirm your data parses correctly and meets all field requirements before you push to production.
3. Keep your data current and refresh your feed frequently. Update changes to product attributes, pricing, or fulfillment details when they occur to maintain customer trust and prevent stale listings. We validate and clean your data, index it into the Stripe product feed, and convert it to the format each agent requires.

Feed processing mode

Product feed uploads support two processing modes: upsert (default) and replace.

Upsert mode treats each row as an insert or update for a product identified by its id.

• If the id doesn’t exist, we create the product.
• If the id already exists, we update the product with the values provided in that row.
• Products not included in the file remain unchanged.

Replace mode treats the uploaded file as the complete, authoritative product catalog.

• If the id doesn’t exist, we create the product.
• If the id already exists, we update the product with the values provided in that row.
• Products that exist in your catalog but aren’t present in the uploaded file are permanently deleted.
• Replace mode is only supported for the product feed.

Use replace mode when you want the uploaded file to fully define your catalog. Use upsert mode when you want to apply partial updates without affecting products you didn’t include.

Deletion behavior

To remove a product or variant through the feed, include the optional delete column in your CSV. Set it to true for any products you want to delete. For products you want to keep, set it to false or leave the field blank.

When delete=true, Stripe only reads the id and delete columns for that row and ignores every other column.

Discovery-only products

Products with disable_checkout=true are syndicated to AI agents for discovery, but they aren’t eligible for in-agent checkout. When an agent displays a discovery-only product, it redirects the user to the product’s link URL to complete the purchase on your website.

Discovery-only products follow the same feed processing rules as other products. Agents can index, search, and rank them. The only difference is that the purchase action redirects to your site instead of starting an in-agent checkout session.

For details on setting this field, see Feed processing instructions.

Product feed field reference

Review the full schema used by the Stripe product feed in the following sections. Each table lists data types, examples, and requirements.

Download a sample file.

Use the inventory feed to refresh product availability and stock quantities without resubmitting your full product feed. Send frequent updates from your warehouse, point of sale, or fulfillment systems so your products reflect accurate in-stock status across agentic interfaces.

1. Keep your product feed in sync: The id values in your inventory file must already exist in the main product feed.
2. Send frequent inventory files: Push updates through the Stripe Product Catalog Import API in CSV format.
3. Send partial updates: Include only changed SKUs—missing SKUs retain their last known inventory state.

Inventory feed field reference

Use the following reference to format your inventory feed fields.

Use the price feed to refresh pricing information for display and promotions without resubmitting your full product feed.

1. Keep your product feed in sync: The id values in your price file must already exist in the main product feed.
2. Send frequent price files: Push updates through the Stripe Product Catalog Import API in CSV format.
3. Send partial updates: Include only changed SKUs—missing SKUs retain their last known pricing information.

Price feed field reference

Use the following reference to format your price feed fields.

Use the promotion feed to provide your active and scheduled promotions, including discount codes, percentage-off deals, fixed-amount discounts, and free shipping offers. Each row represents a single promotion. The promotion feed works alongside your product feed and references products by id or item_group_id from your catalog.

1. Keep your product feed in sync: Product IDs and item group IDs in your promotion file must match id or item_group_id values in the main product feed.
2. Send frequent promotion files: Push updates through the Stripe Product Catalog Import API in CSV format.
3. Send partial updates: Include only changed promotions. If you omit promotions, they retain their last known promotion information.

Promotion feed field reference

Use the following reference to format your promotion feed fields.