Primary navigation

Onboarding

Integrate your product feeds with ChatGPT using onboarding, delivery, and troubleshooting guidance.

Onboarding product feeds in ChatGPT is currently available to approved partners. To apply for access, fill out this form

here

Use this guide to move from first sample to production feed delivery with minimal back-and-forth, and use the Product Feed Spec for full schema and field definitions.

Implementation path

  1. Review the Product Feed Spec. Confirm canonical field names, required attributes, data formats, and validation rules before generating your first export.
  2. Validate required fields. Confirm required fields are present for every row before full-feed delivery.
  3. Deliver your full snapshot feed. Use SFTP, file upload, or hosted URL based on your onboarding setup.

Feed model and delivery

Supported feed type

  • Full snapshot feed: a complete catalog export treated as the source of truth.
  • Recommended cadence: at least daily. Intraday price and availability changes are not currently supported.

Delivery and file requirements

TopicGuidance
Delivery modelPush feeds to OpenAI via SFTP, file upload, or hosted URL.
Formatsjsonl.gz and csv.gz
EncodingUTF-8
Filename stabilityUse a stable file name. Keep the same file name on every update and overwrite it with the latest snapshot instead of creating a new name each run.
Update behaviorIf you use multiple shard files, keep that shard set stable and replace the same shard files on each update.
Shard sizingUp to 500k items per shard is recommended; target shard files under ~500MB

Watch common ingestion failures

  • Missing required fields
  • Outdated or non-spec field names
  • Malformed field values

Handle removals explicitly

  • To remove a product, either set is_eligible_search=false or remove the record from your next full snapshot.

Track post-launch performance explicitly

  • Add feed attribution parameters to url (for example utm_medium=feed) when you need feed-specific click tracking.
  • Keep your internal tracking parameters consistent across snapshots.

Best practices

Review best practices for guidance that complements the schema.