What is llms.ljson and why eCommerce needs it

AI assistants don’t read your website the way customers do. They need structured, machine-readable data — and that’s exactly what llms.ljson provides.

If you already know about llms.txt, think of llms.ljson as its structured, data-rich sibling — purpose-built for eCommerce product catalogs.

---

What Is llms.ljson?

llms.ljson stands for LLM-optimized Line-delimited JSON. It is a file format where each line contains a complete, self-contained JSON object representing a single entity — a product, a category, or a CMS page.

Unlike a regular JSON array (which wraps everything in brackets and requires loading the whole file at once), LJSON is:

• Streamable — AI agents can read it line by line
• Scalable — stores with 50,000 SKUs don’t need one giant file
• Parseable — each line is valid JSON independently

A Single Product Line in llms.ljson

{"type":"product","sku":"WB-004","name":"Alpine Hiking Jacket","price":189.99,"currency":"USD","url":"https://mystore.com/alpine-jacket","category":"Outerwear","short_description":"Waterproof 3-layer shell for alpine conditions","in_stock":true,"attributes":{"color":"Navy","size_options":["S","M","L","XL"],"material":"Gore-Tex"}}

Every product — one line. Every line — complete context for an AI to understand and recommend that product.

---

llms.txt vs llms.ljson — What Is the Difference?

Feature	llms.txt	llms.ljson
Format	Markdown (human-readable)	Line-delimited JSON (machine-readable)
Best for	Store overview, pages, categories	Full product catalog data
AI use case	Context & navigation	Product recommendations & queries
Scalability	Up to ~500 items	Unlimited (streamed line by line)
Attributes	Basic (name, URL, price)	Full (variants, stock, specs)
Updated by	Cron or manual	Cron or manual

Both files work together. llms.txt tells AI what your store is. llms.ljson tells AI what your store sells — in full detail.

---

Why Does eCommerce Specifically Need llms.ljson?

1. AI Agents Need Structured Product Data

When a user asks ChatGPT or Claude “recommend a waterproof jacket under $200,” the AI needs to access structured, queryable product data — not parse HTML product pages. llms.ljson provides exactly that: a clean feed of every product with its attributes, price, stock status, and URL.

2. HTML Product Pages Are Noise for AI

A typical Magento 2 product page contains navigation menus, cookie banners, review widgets, upsell carousels, and footer links. The actual product data — name, price, specs — is buried inside this noise. AI context windows are limited, and parsing messy HTML wastes them. llms.ljson gives AI only signal, zero noise.

3. Product Catalogs Are Too Large for llms.txt

A store with 5,000 SKUs cannot fit them all meaningfully into a single llms.txt file without making it unreadable. llms.ljson handles any catalog size because AI systems can stream and process it line by line — one product at a time.

4. Variants, Stock, and Pricing Change Daily

Unlike static blog content, product data changes constantly. A configurable product might have 12 size/color combinations. Stock goes in and out. Prices change with promotions. llms.ljson is generated fresh by cron and always reflects the current state of your catalog.

---

What Does a Full llms.ljson File Look Like?

Each line is an independent JSON object. Here is a multi-entity example showing products, a category, and a CMS page — all in one file:

{"type":"store","code":"angeo_en","name":"EN","url":"https://angeo.test/","currency":"USD","locale":en}
{"type":"category","store":"angeo_nl","id":"4","name":"Sale","parent_id":"2","url":"https://angeo.test/sale.html","description":"","embedding_text":"Sale "}
{"type":"product","store":"angeo_en","id":"4","sku":"product_sku","title":"product name","price":"123.00","currency":"USD","short_description":"","description":"test descriprtion","url":"https://angeo.test/product-name.html","embedding_text":"product name  test descriprtion"}

An AI agent processing this file can instantly answer:

• “What waterproof jackets do you have under $300?” → WB-001
• “Do you have merino base layers?” → WB-002
• “Is the 3-in-1 jacket in stock?” → No (in_stock: false)

---

How to Generate llms.ljson for Magento 2

The open-source module angeo/module-llms-txt generates both llms.txt and llms.ljson automatically for your Magento 2 store.

Install in 3 commands:

composer require angeo/module-llms-txt
bin/magento setup:upgrade
bin/magento cache:flush

After installation, navigate to:

Stores → Configuration → General → Angeo → LLMS

Generate manually or let cron handle scheduled updates. Both files are created at your store root:

• https://yourstore.com/llms.txt
• https://yourstore.com/llms.ljson

The module supports multi-store and multi-language Magento 2 setups, and includes unit tests for both file types. MIT licensed, free to use.

---

Where to Place llms.ljson

Like llms.txt, the llms.ljson file belongs in your store’s public root directory:

https://yourstore.com/llms.ljson

No server configuration required. AI systems that support structured feeds can discover and process it directly.

---

The Bigger Picture: AI Commerce Infrastructure

We are entering a phase where AI agents don’t just recommend products — they initiate purchase flows on behalf of users. For an AI agent to recommend your products, it must be able to:

1. Understand what you sell
2. Filter by price, attributes, stock status
3. Navigate to a product URL and initiate checkout

Steps 1 and 2 are solved by llms.ljson. Step 3 is the next frontier — but without steps 1 and 2, step 3 is impossible.

Stores that generate structured AI feeds today will be the ones AI agents recommend tomorrow.

---

Summary

• llms.ljson is a line-delimited JSON file that exposes your full product catalog to AI systems
• It complements llms.txt — together they give AI both context and structured data
• For Magento 2, the open-source angeo/module-llms-txt generates both files automatically
• Implementation takes under 5 minutes and requires no custom development

The AI commerce era is not coming — it is already here. Structured product feeds are the foundation that makes your store visible to the systems that are replacing traditional search.

---

Have questions about llms.ljson implementation for Magento 2? Leave a comment below or explore the open-source module on Packagist.