If you accept cookies, we’ll use them to improve and customize your experience and enable our partners to show you personalized PayPal ads when you visit other sites. Manage cookies and learn more
Your platform needs to provide essential product data to enable product discovery and merchant management in Store Sync. By the end of this page, you will have a validated product catalog file that is ready to connect to Store Sync.
This page is for developers who are responsible for integrating product catalogs into Store Sync. To complete the integration, follow these steps:
To get approval to use Store Sync, contact your PayPal account manager or the PayPal AI team to request access. No additional tools, software, or configuration are required before you begin — access approval is the only prerequisite.
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.
The following requirements apply to all specifications:
Your feed file must not exceed 4 GB.
All feeds must be UTF-8 encoded and include a header row that specifies the column names.
For compressed formats, the archive must contain only one CSV or TSV file.
For additional requirements, see the following sections for each specification, and also see Handle product variants. For some good testing practices, see Verify your feed.
Finally, see Best practices for tips on how to optimize and maintain your feed.
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.
Required fields
You must include the following fields in every row of your Google Product Feed.
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.
Required fields
You must include the following fields in every row of your OpenAI ACP feed.
Field, Description, Example
Field
Description
Example
item_id
Unique product identifier (variant ID)
"shirt123-red-m"
group_id
Parent product ID for variants. Required if the product is a variant.
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.
Additional required fields
Use these two fields in addition to all Google Product Feed required fields.
Field, Description, Example
Field
Description
Example
is_eligible_search
Controls whether the product can be surfaced in search results.
"true"
is_eligible_checkout
Controls whether the product can be directly purchased in agentic surfaces. is_eligible_search must be true for this to take effect.
"true"
Additional important optional fields
These fields extend the Google Product Feed with agentic commerce and policy information.
Field, Description, Example
Field
Description
Example
item_group_title
Group product title
"Classic T-Shirt"
warning / warning_url
Product disclaimer text or a URL resolving to HTTP 200.
"Contains lithium battery"
seller_privacy_policy
Seller privacy policy URL
"https://yourstore.com/privacy"
seller_tos
Seller terms of service URL
"https://yourstore.com/terms"
return_policy
Return policy URL
"https://yourstore.com/returns"
For tips for setting up fields and other best practices, see Best
practices.
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
Results: Each variant appears as a separate row in your feed, grouped under the same item_group_id. 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.
To enable AI-driven discovery and checkout across PayPal surfaces, connect your product feed to Store Sync. For details, see Connect your product feed.