Your platform needs to provide essential product data to enable product discovery and merchant management in Store Sync. A well-structured product feed ensures that AI agents can find, understand, and transact against your inventory across PayPal surfaces.This page tells developers who are responsible for integrating product feeds into Store Sync how to format and structure their product feed. To complete the integration, you will review prerequisites, choose a file format, select a feed specification, structure your product variants, and verify your feed before connecting it to Store Sync.
PayPal supports 3 feed specifications. Choose the option that best fits your existing setup and business needs. A more complete and detailed product feed enables PayPal to surface your products more effectively in relevant shopping experiences.Regardless of which specification you use, each row in your feed represents a single product variant. The sections below describe the required and important optional fields for each specification.
The field lists in the following sections highlight the most critical fields for each specification, but they are not exhaustive. For the complete field reference, see the full specification documentation for Google Product Feed or OpenAI ACP Product Feed.
Google Product Feed specification
The most common product feed format. If you already maintain a Google Product Feed, you can reuse it to power both traditional and AI-driven discovery with minimal extra work.The following fields apply when using the Google Product Feed specification.
A newer specification that is optimized for conversational, agent-led shopping and instant checkout in LLM environments, the OpenAI ACP Product Feed format has richer requirements around inventory, shipping, and structured context.The following fields apply when using the OpenAI ACP Product Feed specification.
The PayPal Enhanced Shopping Feed specification extends the Google Product Feed specification with a select set of additional fields for agentic commerce. This specification lets you prepare for AI-driven commerce with minimal changes to your existing Google feed. It requires two additional fields (is_eligible_search and is_eligible_checkout) and supports several additional optional fields.The PayPal Enhanced Shopping Feed specification uses the same fields as the Google Product Feed specification with the following additions.
You must list products with variations, such as different sizes or colors, as separate rows in your feed, using one row for each variant. Each variant row must include:
A unique id or item_id value for the variant.
The same item_group_id or group_id value to indicate the variants belong to the same product.
Variant-specific attributes, such as color and size.
The following example shows 3 variants of the same T-shirt:
id,item_group_id,title,description,link,image_link,price,availability,color,sizeshirt123-red-m,shirt123,"Classic T-Shirt - Red, Medium","Comfortable cotton t-shirt in red",https://yourstore.com/products/shirt-red-m,https://yourstore.com/images/shirt-red-m.jpg,"19.99 USD","in_stock",red,mediumshirt123-red-l,shirt123,"Classic T-Shirt - Red, Large","Comfortable cotton t-shirt in red",https://yourstore.com/products/shirt-red-l,https://yourstore.com/images/shirt-red-l.jpg,"19.99 USD","in_stock",red,largeshirt123-blue-m,shirt123,"Classic T-Shirt - Blue, Medium","Comfortable cotton t-shirt in blue",https://yourstore.com/products/shirt-blue-m,https://yourstore.com/images/shirt-blue-m.jpg,"19.99 USD","in_stock",blue,medium
Before submitting, validate each variant row for correct data types and required fields. Rows with missing required fields or malformed values are skipped during ingestion without failing the entire feed.
Before you upload your feed to Store Sync, confirm that it meets these requirements to ensure a smooth ingestion process and optimal product representation.
All required fields for your chosen specification are present in every row.
Each variant has a unique id or item_id and shares the correct item_group_id or group_id with its siblings.
The feed file is UTF-8 encoded and includes a header row.
The file does not exceed 4 GB. If it does, split it into multiple smaller files.
All URLs (product links, image links, policy URLs) are accessible and return HTTP 200.
All image URLs resolve to a JPG or PNG file at a minimum resolution of 300×300 pixels.
Price values follow the "XX.XX USD" format and the currency code matches your merchant profile.
For the PayPal Enhanced Shopping Feed, warning_url values resolve to HTTP 200.
Optimize fields for discoverability and performance
Follow these recommendations for the most common fields to ensure that your products are accurately represented and discoverable.Product identifier (id / item_id)
Must be unique within your catalog.
Used for deduplication and product updates.
Should identify the specific variant (for example, shirt-red-medium).
Product title (title)
Should match the title on your product page.
Include variant details such as color and size.
Keep under 150 characters for optimal display.
Product link (link / url)
Must be a valid, accessible URL.
Should link directly to the specific variant page.
Product images (image_link / image_url)
Must be a direct URL to a JPG or PNG image file.
Image should clearly show the product.
Minimum recommended resolution: 300×300 pixels.
Additional images can be included in additional_image_link or additional_image_urls.
Price (price, sale_price)
Format as "XX.XX USD" (for example, "19.99 USD").
The currency code must match your merchant profile.
Include sale_price if a discounted price applies.
Availability (availability) must be one of the following exact values.
To enable AI-driven discovery and checkout across PayPal surfaces, connect your product feed to Store Sync. For details, see Connect your product feed.
Your platform needs to provide essential data components to enable product discovery and merchant management in Store Sync. These components ensure that AI agents find and understand your inventory. They also facilitate seamless transactions across your entire network.
