How to write product descriptions an AI agent can answer from: one product per block, facts before adjectives, and the questions customers actually ask

Your website's product page says "luxuriously soft, crafted for modern living". A customer asks "is it machine washable and does it come in grey?". The agent, answering from that page, cannot say. Product information for an agent is a different document from marketing copy: one block per product, facts first, written the way customers ask.

By Ritchie, ReplyKit · Published 5 September 2026 · 6 min read

Quick answer

Write one block per product with a fixed order of lines: name and variants, price per variant, availability and lead time, key specifications with units, who or what it is for, what is included, care or usage, warranty and returns, and the three questions customers ask most with their answers. Use the customer's words ("machine washable", "fits a queen bed"), keep marketing adjectives out, and update the availability line when stock changes. The agent quotes the block exactly and never has to guess.

The product block Why this format works Adapting the block Mistakes that make agents guess Keeping it current FAQ

The product block

Product: Linen duvet cover, queen
Variants: grey, white, sand. Queen (210 x 210 cm) and king (240 x 220 cm).
Price: RM 289 queen, RM 329 king.
Availability: in stock (updated 5 Sep). King in sand sold out, back mid-September.
Specs: 100% stone-washed linen, 165 gsm, hidden button closure.
For: queen and king beds; fits mattresses up to 30 cm deep with our fitted sheet.
Includes: duvet cover only. Pillowcases sold separately at RM 79 a pair.
Care: machine washable at 40C, tumble dry low, no bleach. Softens with washing.
Warranty and returns: 30-day exchange for unused items; colour differences from screen are not a defect.
Common questions:
- Does it pill? No; linen does not pill, though it creases.
- Is it cooling? Yes; linen breathes better than cotton, which is why it suits our climate.
- Can I buy a set? Yes; the set with two pillowcases is RM 349 queen.

Why this format works

An agent retrieves passages that match the question and writes from them. "Machine washable at 40C" in a block labelled with the product name matches "can I wash the linen duvet?" directly. A paragraph of adjectives matches nothing useful. The mechanism is in how retrieval works; the general principle for lists is in the price list guide.

Adapting the block

Food. Name, size or portion, price, ingredients and allergens, halal status, shelf life, storage, lead time for orders, minimum order.
Services. Name, duration, price, what is included, who it suits, preparation, aftercare, cancellation terms. See the salon guide for a service menu.
Equipment and electronics. Name, model, price, key specs with units, compatibility, what is in the box, warranty, installation.
Courses. Name, level, age, schedule, duration, fee, what is included, prerequisites, certificate.

Mistakes that make agents guess

Specs in an image or a PDF table with no text.
Prices on one page and variants on another.
"Contact us for price" on the page and a real price in your head.
Stale availability with no date.
Superlatives in place of facts ("premium quality" instead of "165 gsm").
Ten similar products with no distinguishing line, so the agent cannot tell which the customer means.

Keeping it current

Put the availability line at the top of the update habit: when a variant sells out, change the line. Once a month, read the unanswered-questions list and add the questions customers asked to the relevant block. That is the whole maintenance plan; see the teach loop.

Frequently asked questions

Why does my AI agent give vague answers about products?

Because it is answering from marketing copy. Give it one factual block per product with variants, price, availability, specs, care and policy lines.

What should a product description for an AI agent include?

Name and variants, price, availability with a date, specs with units, who it is for, what is included, care, warranty and returns, and common questions.

Can the agent read product specs from images?

No. Specs must be text.

How do I handle many similar products?

Give each block a distinguishing line so the agent can tell which one the customer means, and ask a clarifying question when ambiguous.

How often should I update it?

Availability whenever stock changes; common questions monthly from the unanswered list.

Exact answers, from exact blocks

Load your products and the agent quotes them right. 7-day free trial.

Start free

Written by Ritchie, ReplyKitPart of the small team in Malaysia that builds and runs ReplyKit. Writes about WhatsApp automation, AI customer service and small business lead response.

How we know this. The product block below is the format ReplyKit customers converge on after their first week, once they see which questions the agent answered well and which it fumbled. Product figures in this article (limits, prices, per-reply costs) are taken from ReplyKit as it runs today and are re-checked when we update the page. Where we cite outside research, the source is linked below. We sell ReplyKit, so read our product claims with that in mind; we say where a different tool or no tool is the better choice. About ReplyKit.

Sources and further reading

WhatsApp Business Messaging Policy · opt-in, opt-out and prohibited-use rules every business must follow
Harvard Business Review, The Short Life of Online Sales Leads (Oldroyd, McElheran, Elkington, 2011) · firms that responded within an hour were about seven times more likely to qualify the lead

ReplyKit is an independent product and is not affiliated with or endorsed by Meta or WhatsApp. This article is general guidance for running a small business, not legal, financial or regulatory advice.