Deploy
Product FAQs
Product FAQs put a short list of questions and answers on each product page. You place the block once, and every product gets its own list, written from that product's page.
How the answers are written
The first time someone opens a product page, we read that page from your knowledge sources and write up to seven questions a shopper would ask before buying, each with a short answer. Answers only use what the page says. If the page doesn't cover something, that question is left out, so some products get fewer questions.
After that, the answers stay the same. They don't change on each visit or when we re-crawl your site. Search engines need the same text every time they visit, so you decide when anything changes.
Only pages in your knowledge sources get answers. If a product is missing, add or re-crawl the page first.
Set it up
In the dashboard, open Product FAQs under your agent.
- Questions per product. Pick 4 to 7. This is the most a page shows.
- Pinned questions. Add questions you want on every product page, such as shipping, returns or warranty. They come first and count toward the number above.
- Heading. The title above the list.
To have every product ready before anyone visits, click Write FAQs for all products. It works through the product pages in your knowledge sources.
Edit, hide or rewrite
Every product with FAQs is listed on the same page. Click Edit to change a question or answer, or hide one you don't want shown. Rewrite writes a new list from the page as it is now, which replaces your edits.
Ask a follow-up
Turn on Ask a follow-up in the Product FAQs settings to add a link under each answer. Clicking it opens the chat with About "Will it fit a 30 kg lab?": already typed, so the shopper only has to finish the question. The agent answers from your pages and catalog. On Shopify and WooCommerce it can show the product and add it to the cart. It's off until you turn it on, and works on Shopify, WordPress and any site using the embed code.
On Shopify, the link appears once your theme has the latest Agentmatica app version. On WordPress it needs the plugin update that adds it, and lists cached by the plugin pick it up within 12 hours.
Put it on your site
Shopify
In the theme editor, open your product template, click Add block and choose Product FAQs from Agentmatica. Shopify builds the list into the page itself, along with FAQPage structured data, so crawlers that don't run JavaScript still see the answers. Agentmatica Chat must be on in App embeds.
WordPress and WooCommerce
Update the Agentmatica plugin to 0.9.0 or later. In WordPress, open Settings → Agentmatica, paste your agent ID from Deploy under Product FAQs, and save. Then add the shortcode to a product description, page or post:
[agentmatica_faq]On WooCommerce you can skip the shortcode and tick Show FAQs on every WooCommerce product page instead. The list then appears below the product tabs. It's off until you turn it on.
Your WordPress server fetches the list and builds it into the page, with FAQPage structured data, the same way Shopify does. Crawlers that don't run JavaScript see the answers. The plugin keeps a copy for 12 hours, so an edit you make in the dashboard can take up to 12 hours to show. If Agentmatica can't be reached, the page shows without the list. Your site address must be your agent's website or one of its allowed embed domains.
Other sites
Paste this into your product page template, where the list should go. The chat widget has to be on the page.
<div data-agentmatica-faq></div>On these sites the list is added by JavaScript after the page loads. Google runs JavaScript and can read it. Most AI assistants' crawlers don't, so they may not see the answers.
What to expect from search
Since 2023, Google only shows FAQ rich results for well-known government and health sites, so the expandable questions under a search listing are unlikely for a store. The answers still sit on your page as plain text that search engines can read, and the structured data matches the visible text, as Google asks.
Related
- Starter questions: can also use per-product questions written in the same step.