OpenAI Product Feed Generator for Magento 2

Generates an OpenAI (ChatGPT) product feed per store view so your Magento catalog can be discovered — and purchased — inside ChatGPT.

The exported CSV is compliant with the OpenAI Product Feed file-upload specification (Stable) and covers all Magento product types: simple, virtual, downloadable, configurable, bundle and grouped.

Features

• Feed columns aligned with the OpenAI Product Feed file-upload specification (Stable): item_id, is_eligible_search, is_eligible_checkout, image_url, item_weight_unit, return_deadline_in_days, and more
• All Magento product types: simple, virtual, downloadable, configurable, bundle, grouped
• Configurable products exported as parent listing + child variant rows (group_id, variant_dict, item_group_title)
• Grouped products linked via related_product_id / relationship_type
• Digital goods flagged with is_digital
• Fault-tolerant generation: failing products are logged and skipped, never abort the run
• Dedicated log file: var/log/angeo_openai_feed.log
• Optional attributes (media gallery, reviews, Q&A)
• Test coverage

Requirements

• PHP >= 8.1
• Magento 2.4.x (Open Source or Adobe Commerce)

Installation

You can install this module as a Composer package.

1. composer require angeo/module-openai-product-feed
2. Run bin/magento setup:upgrade

As a module

1. Download latest release files and extract them under app/code/Angeo/OpenAiProductFeed
2. Run bin/magento setup:upgrade

Upgrading from 1.x

Version 2.0.0 is a breaking release. Feed columns were renamed to match the OpenAI
specification (item_id, is_eligible_search, is_eligible_checkout, image_url,
item_weight_unit, return_deadline_in_days, …) and ProductMapperInterface::map()
now returns a list of rows. See CHANGELOG.md for the full list.

No data migration is needed: the enable_search / enable_checkout product
attributes are unchanged — only the exported column names differ.

Configuration

You can find the module's configuration under Stores -> Settings -> Configuration -> Angeo:
seller identity (name, URL, privacy policy, terms of service) and return policy
(URL, return window in days). Per the OpenAI specification, seller_privacy_policy
and seller_tos are required when checkout is enabled for a product.

Two product attributes control per-product eligibility (found in the
"OpenAI Configurations" attribute group):

• Enable Search → exported as is_eligible_search
• Enable Checkout → exported as is_eligible_checkout (automatically forced to
  false in the feed when search is not enabled, per the specification)

Product Feed

To generate the product feeds manually, use the angeo:product-feed:generate Magento command:

  bin/magento angeo:product-feed:generate

A cron job (angeo_generate_openai_feed) also runs daily at 02:00.

Output file path, relative to the var directory: var/angeo/openai_feed/<store_code>.csv

Skipped products and per-store summaries are written to var/log/angeo_openai_feed.log.

Product type handling

Contributing

Found a bug, have a feature suggestion or just want to help in general? Contributions are very welcome! Check out the list of active issues or submit one yourself.

Need help with agentic commerce for Magento? Professional support, AEO audits and implementation at angeo.dev. Check how your store looks to AI agents with the free scanner at api.angeo.dev.

Questions? Contact me at [email protected]

Changelog

All notable changes to this module are documented in this file.

[2.0.1] - 2026-07-06

Changed

• Lowered the PHP requirement from 8.3 to 8.1, extending compatibility to
  Magento 2.4.4+ environments. Typed class constants (a PHP 8.3-only syntax)
  were replaced with untyped constants; no behavior changes.

[2.0.0] - 2026-07-04

Breaking changes

• Feed columns renamed to match the OpenAI Product Feed file-upload specification (Stable):
  id → item_id, enable_search → is_eligible_search, enable_checkout → is_eligible_checkout,
  image_link → image_url, return_window → return_deadline_in_days.
  If you post-process the generated CSV, update your column mapping.
• ProductMapperInterface::map() now returns a list of feed rows (each row is an
  associative array keyed by feed column name) instead of a single positional row.
  Custom type mappers must be updated accordingly.
• The weight column now contains only the numeric value; the unit is exported in the
  new item_weight_unit column (lb / kg), as required by the specification.
• Boolean flags are exported as lower-case true / false strings, as required by
  the specification.
• The custom GenerateOpenAiFeedForStoreException class was removed. Feed generation
  no longer throws on per-product or per-store errors (see below).

Added

• Support for all Magento product types: configurable, virtual, downloadable,
  bundle and grouped, in addition to simple products.
  • Configurable products are exported as a parent listing row plus one row per
    enabled child variant, with group_id, listing_has_variations,
    item_group_title and a JSON variant_dict built from the configurable
    attributes (spec "Variants" schema).
  • Virtual and downloadable products are exported with is_digital=true and no
    physical weight.
  • Grouped products reference their associated products through
    related_product_id / relationship_type=part_of_set (spec "Related Products"
    schema) and export their minimal price.
  • Bundle products export their minimal ("from") price for dynamic bundles and
    the fixed price for fixed bundles.
• New feed columns: item_weight_unit, is_digital, group_id,
  listing_has_variations, variant_dict, item_group_title,
  related_product_id, relationship_type.
• Dedicated log file var/log/angeo_openai_feed.log with a per-store summary
  (rows written / products skipped).

Changed

• Feed generation is now fault-tolerant. Custom exceptions were replaced with
  logging: a product that fails to map is skipped and logged, a failing attribute
  handler produces an empty cell and a warning, and a store whose writer cannot be
  created is skipped — the run always continues.
• description is exported as plain text (HTML stripped, entities decoded,
  whitespace collapsed, truncated to 5,000 characters) per the specification.
• product_category now exports the full category path with the > separator
  (e.g. Apparel & Accessories > Shoes) and no longer crashes on uncategorized
  products.
• Prices are formatted as <amount> <ISO 4217 code> (e.g. 79.99 USD) without
  locale symbols or thousands separators, and resolve through the price-info
  pipeline so composite product types export a correct minimal price.
• sale_price is only exported when an active discount exists (final price below
  regular price), honoring special-price date ranges and catalog price rules.
• is_eligible_checkout is forced to false whenever is_eligible_search is not
  true, per the specification dependency rule.
• CSV rows are normalized against the header definition, guaranteeing column order
  and empty cells for missing values.
• Attribute handlers are instantiated once per run instead of once per product row.

Fixed

• Fatal error in the per-store service: the second throw referenced an unimported
  exception class, and the exception file name did not match its class name (PSR-4).
• Operator-precedence bug in ProductWeightProvider that dropped the weight unit
  for products with a weight and exported 0 <unit> for products without one.
• ProductCategoryProvider crash on products without categories (current([])
  returns false, which the null-coalescing fallback never caught).
• Broken ProductAttributeHandlerProvider (class/file name mismatch and wrong
  import) rewritten and wired into the mapping pipeline.
• Inventory quantity lookups no longer fail rows for composite product types that
  have no salable quantity of their own.
• bin/magento angeo:product-feed:generate no longer fails when the area code is
  already set.

[1.0.2]

• Initial public release line: simple product export, seller and return policy
  enrichment, CLI command and daily cron.