The AI JSON Feed is a new feature in version 3.6.0. It provides a structured, machine-readable representation of your product catalog optimised for AI-powered search engines, large language models (LLMs), and discovery platforms that power the next generation of search.
To understand why this matters, see [AI Feed — The Future of SEO].
AI Feed Settings
| Setting | Default | Description |
|---|---|---|
| Enable AI JSON Feed | Off | Master switch. When enabled, the feed index is accessible at /ai_feed_index.json (with .htaccess) or via the route URL. |
| AI Feed Limit per Page | 1000 | Products per feed page. The AI feed includes full product data, so lower limits = smaller, faster response files. Recommended: 500–1000. |
AI Feed URL Structure
The AI feed uses a two-level URL structure:
Feed Index URL — A single JSON file listing all feed pages for all languages. This is the entry point for crawlers.
With .htaccess: https://yourstore.com/ai_feed_index.json
Without .htaccess: https://yourstore.com/index.php?route=extension/hbseo/ai_feedFeed Page URLs — Individual paginated JSON files, one per language per page.
With .htaccess: https://yourstore.com/ai-feed/en/ai_product_feed_1.json
Without .htaccess: https://yourstore.com/index.php?route=extension/hbseo/ai_feed/feed&page=1What Each Feed Page Contains
Each feed page is a JSON object with:
Metadata fields:
store_id— OpenCart store IDstore_url— Store base URLlanguage_code— Language of this feed page (e.g.,en,fr)total_products— Total product count across all pagespage— Current page numberlimit— Products per pagetotal_pages— Total number of feed pagesgenerated_at— ISO 8601 timestamp of generation
products array — one entry per product:
| Field | Description |
|---|---|
product_id | Internal OpenCart product ID |
url | Full canonical product page URL |
name | Product name (HTML entities decoded) |
description | Plain-text description (HTML stripped, truncated to 320 characters) |
price | Regular price as a float |
special | Special/sale price as a float (null if no sale) |
currency | Store currency code (e.g., USD, EUR) |
manufacturer | Brand/manufacturer name |
category_hierarchy | Array of category paths from root to product |
stock_status | "In Stock" / "Out Of Stock" or custom stock status label |
last_updated | ISO 8601 timestamp of last product modification |
importance_score | (Smart SEO Mode only) Float 0.7–1.0 representing product importance |
robots.txt Recommendations
Add these lines to your robots.txt to help AI crawlers discover both feeds:
Sitemap: https://www.yourstore.com/sitemap_index.xml
Sitemap: https://www.yourstore.com/ai_feed_index.jsonAdding AI Feed to Custom Links Sitemap
For maximum discoverability, add your AI feed index URL to the Custom Links section so it appears in your XML sitemap index. This ensures legacy crawlers that only follow sitemap.xml files can also find the AI feed.
Multi-Language Support
If your store has multiple languages, the AI feed automatically generates separate feed pages for each active language. The feed index lists all languages with their page URLs.
To request a single language, append ?hbxmllang={code} to the feed index URL:
https://yourstore.com/ai_feed_index.json?hbxmllang=frAdmin Panel — Feed Links Display
The Dashboard tab shows:
- AI feed pagination summary — total products, products per page, total feed pages
- Language-wise AI feed URLs — links to the first few feed pages per language
The admin panel reads the live feed index to display these links, so you can verify the feed is working without leaving the admin.