Each store view has its own OpenAI Commerce feed. You can enable or disable feed generation per store view and optionally adjust the filename. The feed is generated in JSON format according to the OpenAI Commerce specification.

This section lets you control the ChatGPT/OpenAI Commerce product feed for every Magento 2 store view separately. Use it to turn feeds on/off, choose the output filename, and manually run a feed for a specific store view.

Enable

• Yes/No: Toggle feed generation for the currently selected Store View.
• If disabled, this store view will not output a feed file and manual runs will be blocked.

Filename

• Set the JSON filename for this store view, e.g. openai-commerce-feed.json or openai-commerce-feed-en.json.
• Use a unique filename per store view to avoid overwriting files when multiple views publish to the same directory.

Feeds Table

The table lists all store views and their current feed file.

• StoreView: The Magento store view the feed belongs to.
• Feed file:
  • File link: Opens the current JSON feed in a new tab for quick verification.
  • Copy File Location: Copies the absolute URL to share with your integrations.
• Action + Run:
  • Select an action from the dropdown (e.g. Generate), then click Run to execute it for that store view only.
  • Use this when you’ve changed catalog data, pricing, or attributes and need an immediate refresh.

Typical Use Cases

• Multi-language stores: Enable a separate feed per locale (e.g. English, Dutch) so ChatGPT can consume language-specific content.
• Staging vs Production: Disable feeds on staging store views to prevent external systems from indexing test data.
• File naming strategy: Append the store code to the filename, e.g. openai-commerce-feed-nl.json, for clarity.

Best Practices

• Validate the JSON output after the first run to ensure it complies with the OpenAI Commerce spec.
• Keep feed URLs stable; changing filenames may require updates in downstream integrations.
• After enabling/disabling or renaming a feed, flush Magento caches if your environment aggressively caches static assets.

Troubleshooting

• Feed not updating: Click Action → Generate and Run. If it still shows old data, clear full page cache/CDN and retry.
• 404 on feed URL: Ensure the store view is Enabled and the Filename matches what your table shows. Verify file permissions on the target directory.
• Invalid JSON: Open the file via the link and validate with a JSON linter. Check for custom attribute mappings that output unexpected data types.
• Wrong language/prices: Make sure you ran the feed for the correct Store View and that store-view specific settings (currency, locale, tax display) are configured.

Seller Configuration

The Seller Configuration section defines the basic seller information that will be included in your ChatGPT/OpenAI Commerce Product Feed. This ensures accurate identification of your store and provides essential links to your policies for transparency and compliance.

Seller Name

• Enter the name of your company or store as displayed to users (e.g. Magmodules BV).
• This field is required and will appear in the product feed as the seller name.

Privacy Policy

• Select the CMS page that contains your store’s Privacy Policy.
• This page link helps ChatGPT and other AI systems reference your data protection and customer privacy terms.

Terms of Service

• Select the CMS page that contains your Terms and Conditions or Customer Service information.
• It defines how customers can interact with your store and under which conditions purchases are handled.

Return Policy

• Optionally, select a CMS page with your Return Policy.
• This ensures that return and refund rules are communicated clearly in the product feed.

Return Window (days)

• Enter the number of days customers can return products (e.g. 30).
• This value will be added to the feed, helping AI systems understand your store’s return period.

Best Practices

• Keep all selected CMS pages public and accessible.
• Use consistent policy URLs across all store views to avoid broken links in the feed.
• Review your privacy and return policy texts regularly to stay compliant with GDPR and consumer laws.

Troubleshooting

• Missing seller name: Enter a valid name; this field cannot be empty.
• Broken policy links: Check if the selected CMS pages are active and visible on the frontend.
• Incorrect return period: Ensure the “Return Window” matches your actual store policy.

Product Attributes Configuration

The Product Name & Description section defines which Magento attributes are used to populate the ChatGPT/OpenAI Commerce Product Feed. These settings control how your products appear when ChatGPT or other AI systems reference your feed for product discovery and recommendations.

Product Identification

• ID (SKU): The unique product identifier. The suggested field is SKU. This ensures each item in your feed is distinct and traceable.
• Title: Select the Magento attribute used for the product title (default: Product Name).
• Description: Choose which attribute represents your product’s description. This text helps AI systems understand your product features and benefits.

Images & Videos

• Source: Select whether to include All Images or only specific types (e.g., Base Image).
• Main Image: Defines which image should be used as the primary one in the feed (default: First Image).
• Include Hidden Images: Set to Yes if you want to include gallery images that are not visible on the frontend.

Identifiers

• GTIN: Choose which attribute contains the Global Trade Item Number (e.g., SKU or EAN).
• Brand: Usually mapped to Manufacturer or another brand attribute.
• MPN: The Manufacturer Part Number. Typically identical to SKU if not separately defined.

Condition

• Condition Source: Choose between Static Values or a product attribute that defines condition.
• Default Value: Set the default product condition — supported values are New, Refurbished, and Used.

Category

• Include Category: Set to Yes to include the product’s category path in the feed. This helps ChatGPT group products more accurately by type.

Best Practices

• Always use clean, SEO-friendly product names and descriptions.
• Ensure each SKU is unique to avoid feed conflicts.
• Prefer high-quality product images and verify they are accessible via HTTPS URLs.
• Use consistent brand and GTIN data for better AI product matching.

Troubleshooting

• Products missing from feed: Check if the SKU is correctly mapped under ID and the product is enabled and visible in your Magento catalog.
• Broken images: Verify that the images exist in your media folder and that Include Hidden Images is set correctly.
• Wrong product condition: Ensure the condition attribute or static value matches one of the supported options: New, Used, or Refurbished.

Configurable, Bundle & Grouped Products Configuration

This section defines how configurable, bundle, and grouped products are exported to the ChatGPT/OpenAI Commerce Product Feed. These settings help ensure that your complex product structures are represented accurately and efficiently for AI-driven product discovery.

Configurable Products

For configurable products, we recommend adding only the linked simple products to the feed. This approach ensures accurate pricing, images, and stock data for each variation.

• Use Configurable/Simple Products: Choose Only Linked Simple Products (Recommended) to export child products instead of the parent configurable product.
• Use Parent URL for Simples: Set to Yes (recommended). Automatically links simple product URLs to the configurable product’s landing page.
• Use Parent Image for Simples: Choose Only if Empty (Recommended). Exports the parent image if the simple product has no image assigned.
• Use Parent Data for Simples: Select which attributes (e.g. Title, Description, Brand) should be inherited from the parent configurable product. Avoid selecting unique attributes such as GTIN or Color.
• Use Fallback only on Non Visible Simples: Set to Yes. Ensures fallback logic is used only for simples that are “Not Visible Individually.”

Bundle Products

• Use Bundle Products: Select Only Bundle Product (Recommended). This exports only the main bundle product, not the individual bundled items.
• Parent Price: Choose Minimum Price (Recommended) to represent the lowest possible price of the bundle in the feed.

Grouped Products

• Use Grouped Products: Select Only Grouped Product (Recommended). This exports the main grouped product as a single entity.
• Parent Price: Choose Minimum Price (Recommended) to display the lowest price available within the grouped product.

Best Practices

• For configurable products, always map simple products individually for maximum accuracy in AI recommendations.
• Ensure parent attributes like title and description are well-optimized, as they may be inherited by child products.
• Do not include both parent and child items in the same feed to avoid duplicates.
• Check that all linked products are visible and properly associated in Magento before generating the feed.

Troubleshooting

• Duplicate products in feed: Verify that both parent and child items are not included simultaneously.
• Missing images for simple products: Enable Use Parent Image for Simples set to “Only if Empty.”
• Incorrect product links: Ensure Use Parent URL for Simples is set to “Yes” to maintain correct navigation from AI-generated listings.

For more details, visit the ChatGPT Feed Configuration guide or the plugin page.

Additional Configuration

The Additional Configuration section provides extra control over how product details, analytics, and shipping information are included in your ChatGPT/OpenAI Commerce Product Feed. These options allow you to fine-tune your feed output for analytics tracking, product grouping, and AI enrichment.

Extra Options

• Include Product Ratings: Set to Yes to include customer review ratings from your Magento store in the feed. This improves product relevance and trust in AI-generated responses.
• Include Item Group ID: Enables a shared identifier for grouped or configurable products. This helps ChatGPT link variants or related items together.

Extra Fields

You can add custom fields to your product feed to include additional attributes or metadata.

• Click Add to define a new custom field.
• Set the Field Name (e.g. “material_type”) and map it to a Magento attribute.
• Ensure that added fields comply with the OpenAI Commerce JSON standard to avoid validation errors.

Shipping Settings

Define specific shipping costs to include directly in the product feed.

• Country: Select the applicable country for the rate.
• Service: Add a label or carrier name for clarity (e.g. “Standard Shipping”).
• From/To Price: Set the product price range where the rule applies.
• Shipping Costs: Define the cost that will appear in the feed.
• Use Add to create multiple rules for different regions or price tiers.

Google Analytics Tracking

If you use Google Analytics or other tracking tools, you can add a UTM tag to the feed URL. This allows you to track traffic and conversions coming from AI-powered product links.

• UTM Code: Example: utm_source=openai&utm_medium=feed&utm_campaign=product
• Ensure UTM tags follow your analytics structure for accurate reporting.

Weight

Include the product’s weight in the feed to help AI systems understand shipping and logistics data.

• Include Weight: Set to Yes to export the product’s weight attribute.
• This field is also useful when integrating with logistics-based AI systems or shipping APIs.

Best Practices

• Include ratings only if your store has consistent and verified reviews.
• Always verify that extra fields are correctly mapped to Magento attributes.
• When defining shipping rates, make sure they match your actual checkout pricing.
• Use UTM codes strategically to identify traffic from ChatGPT or OpenAI channels.

Troubleshooting

• Feed validation failed: Check if custom fields use valid JSON attribute names.
• Missing shipping data: Confirm that at least one shipping rule is defined and active.
• Analytics not tracking: Verify UTM parameters are properly formatted and your GA property is active.

Filter Options

The Filter Options section allows you to control which products are included in the ChatGPT/OpenAI Commerce Product Feed. These filters help ensure that only relevant, active, and visible products are exported, reducing unnecessary data and improving feed quality.

Filter on Visibility

• Enable: Set to Yes to include only products with specific visibility statuses (e.g., “Catalog”, “Search”, or both).
• By default, all visible products are included. Enabling this filter allows for tighter control over which product types appear in the feed.

Filter on Status

• Add Disabled Products: By default, only enabled products are exported. Set to Yes if you also want to include disabled products (not recommended).
• This setting helps ensure that your feed contains only products that are live and purchasable.

Filter by Category

• Enable: Choose Yes to limit the feed to specific product categories.
• This is useful for generating category-specific feeds — for instance, exporting only “Electronics” or “Accessories”.

Exclude Out of Stock

• Enable: Set to Yes to automatically exclude products that are currently out of stock.
• This prevents unavailable items from being displayed in ChatGPT recommendations or AI product listings.

Advanced Filters

• Enable: Turn this on to use Magento’s advanced filtering logic.
• Allows you to create complex filter rules using product attributes, conditions, and logic (e.g., export only products over a certain price or with a specific attribute value).
• Recommended for developers who need precise control over feed content.

Best Practices

• Keep “Exclude Out of Stock” enabled to ensure your feed only contains purchasable products.
• Do not include disabled or hidden products unless required for testing or staging feeds.
• Use category-based filtering if you plan to create multiple feeds for different AI campaigns or marketplaces.
• Test your advanced filters carefully before going live to avoid missing data.

Troubleshooting

• Missing products in feed: Check if category, visibility, or stock filters are too restrictive.
• Feed includes hidden products: Verify that Filter on Visibility is enabled and configured correctly.
• Advanced filter not applying: Clear Magento cache and regenerate the feed after changing filter conditions.

Cron Configuration

The Cron section allows you to automate the generation of your ChatGPT/OpenAI Commerce Product Feed. This ensures your feed stays up to date with the latest product data, pricing, and stock without manual intervention.

What is a Cronjob?

A Cronjob is a scheduled background task that runs automatically at set intervals. In Magento, cronjobs handle key operations such as indexing, emails, and feed generation.

The ChatGPT Product Feed plugin uses a cronjob to automatically regenerate your product feed based on your chosen schedule. This helps ensure that ChatGPT and AI systems always receive the most accurate and fresh data from your store.

Enable

• Yes: Enables automatic feed generation based on the schedule defined below.
• No: Disables cron-based feed generation. You can still run feeds manually from the admin panel.

Frequency

• Determines how often the feed should be regenerated automatically.
• Available options typically include:
  • Hourly – Ideal for frequently changing inventories or dynamic pricing.
  • Daily at 0:00 – The recommended default setting for most stores.
  • Weekly – Suitable for catalogs that rarely change.

Important Notes

• Ensure that your default Magento Cron service is properly configured and running on your server.
• If the cronjob fails or doesn’t trigger, contact your hosting provider or developer to verify your cron setup.
• To test your setup, you can manually run Magento’s cron with the command:

  php bin/magento cron:run

Best Practices

• Schedule the feed during low-traffic hours (e.g., midnight) to minimize performance impact.
• Use a monitoring tool or cron log to confirm successful executions.
• If your feed is large, consider using daily scheduling with caching to optimize performance.

Troubleshooting

• Feed not updating automatically: Verify that Magento’s cron is active and no cron errors appear in var/log/cron.log.
• Duplicate feeds: Check that multiple cron tasks aren’t scheduled for the same feed.
• Feed generation fails: Run php bin/magento cron:run manually and check your feed directory permissions.

Understanding the Feed Generation Overview in the OpenAI Plugin

The Feed Generation Overview page in the Magento 2 OpenAI Plugin provides a clear summary of all generated feeds for your store views. It helps you track when and how product data feeds were created, and by whom — ensuring transparency and easy troubleshooting.

Why This Overview Matters

• Quickly verify successful feed generation per store view.
• See how many products were included in each feed.
• Identify whether feeds were generated manually or via command line (cron).
• Monitor generation time and date for each feed run.

Overview Columns Explained

• ID: Unique identifier for each generated feed record.
• Store View: Indicates the Magento store view for which the feed was generated.
• Result: Displays the number of products included in the feed, generation time in seconds, and timestamp.
• Generated By: Shows whether the feed was created manually through the admin panel or automatically via the command line.
• Created At: Timestamp of when the feed was generated.
• Action: Option to view or manage feed details (e.g., download or inspect the JSON output).

How to Use the Generate Feeds Button

Click the Generate Feeds button in the top-right corner to manually trigger feed generation for all enabled store views. This is useful for testing or regenerating product data after updates.

Best Practices

• Use manual generation to test configuration changes or feed formatting.
• Schedule cron generation for daily or hourly updates depending on product data frequency.
• Regularly check generation times and results to ensure data completeness.

Troubleshooting

Feed Not Appearing?

Verify that feed generation is enabled for the store view under Stores > Configuration > Magmodules > OpenAI Feed.

Products Missing from Feed?

Check your product visibility and attribute mapping settings. Products that are disabled, out of stock, or missing required fields will be skipped.