The Store FAQs widget puts a store-wide FAQ section on your storefront — the questions shoppers ask before they buy that aren't about one specific product, like shipping times, returns, sizing, materials, and care instructions.
You get two kinds of FAQ, side by side in the same widget:
AI FAQs — Judge.me drafts a starting set for you by reading your product descriptions. You review them and choose what to publish. Nothing goes live without you.
Your FAQs — FAQs you write yourself. Full control, and they go live as soon as you save.
Shoppers see one list. A single short line appears under the heading whenever any published FAQ was AI-generated.
How it works
The Store FAQs widget displays your FAQs on any page where you place the block — most stores use the home page. The answers are written into your page's HTML from the moment it loads, not fetched when a shopper clicks a question. This matters for two audiences:
AI shopping assistants — Most don't run JavaScript, so they only read the initial HTML. Because your answers are already there, they can be read and quoted.
Search engines — The widget also adds FAQPage structured data, which helps search engines understand that the page contains questions and answers.
You don't have to configure any of this. It's how the widget works.
How to set it up
To set up Store FAQs:
From your Judge.me admin, go to Settings > Widgets.
Find the Store FAQs card, and click Install.
Judge.me starts drafting your AI FAQs straight away, click Go to theme editor → so you can place the widget.
In the theme editor, drop the Store FAQs block wherever you want it and click Save.
When the first draft is ready, Judge.me emails you. Click through to review it.
Note: You need the Judge.me app embed switched on in your theme. Without it the widget can't load. It's the same embed the rest of the Judge.me widgets use, so if your other widgets show, you're fine.
Reviewing and publishing your AI FAQs
AI FAQs arrive unpublished — drafted, but not visible to shoppers. To check your AI FAQs:
From your Judge.me admin, go to Settings > Widgets.
Find the Store FAQs card, and click Manage FAQs.
On the FAQs management page you can:
Read each one and check it against how your store actually works.
Edit any answer. Once you edit an AI FAQ it becomes yours and moves to Your FAQs section.
Publish all when you're happy, or publish them individually.
Unpublish anything at any time — it disappears from the storefront immediately, including from the structured data.
Always read your AI FAQs before publishing. They're drafted from your product descriptions, so if a description is vague or out of date, the answer will be too.
Writing your own FAQs
To write your own FAQs:
From your Judge.me admin, go to Settings > Widgets.
Find the Store FAQs card, and click Manage FAQs.
Click Create FAQ.
Write the question and the answer.
(Optional) You can click Improve, to enhance your answer using AI.
Click Save FAQ. Your own FAQs go live right away — they don't need a publishing step.
You can have up to 50 of your own FAQs and up to 10 AI FAQs.
Generating more AI FAQs
To generate more AI FAQs:
From your Judge.me admin, go to Settings > Widgets.
Find the Store FAQs card, and click Manage FAQs.
In AI-generated store FAQs section, click Generate more.
(Optional) Before you generate, you can add generation guidance — a short note about what to emphasize or avoid. For example: "Focus on sustainability and shipping times. Don't mention wholesale."
New FAQs are added to what you already have — nothing is replaced — and duplicates of existing questions are skipped.
The first Generate more runs immediately.
After that there's a 30-day wait between runs. The page shows the next date you can generate.
Guidance helps the AI focus on or skip certain topics, but only ones already covered in your product descriptions — it won't add information that isn't there. If you ask it to both emphasize and avoid something that overlaps, the "avoid" instruction takes priority.
Customizing the widget appearance
All of the styling is in your Shopify theme editor — to customize your Store FAQs widget:
From your Shopify admin, go to Online store > Edit theme.
Find and click the Store FAQs block.
This will open the widget settings inside the Shopify theme editor
You can customize:
Widget type — Accordion (a stacked list you click to expand) or Badges (the questions as tappable chips, with the answer opening underneath).
Expand all FAQs by default (accordion only) — start with every answer open.
Container style and Card color — whether the accordion sits on a filled card, and what color that card is.
Chevron button shape — round or square.
Question and answer text size — small, medium, or large.
Corner styling — square, soft, rounded, or extra round.
Text color and Lighter text color.
Badge color, Active badge color, and Badge text color (badges layout only).
Maximum width — from 320px to 900px.
Heading — the text shown above the FAQ list (default: "Frequently asked questions").
If you downgrade
Your FAQs are kept. Both the AI FAQs and the ones you wrote stay in your account, along with your generation guidance — nothing is deleted. However, the widget stops showing on your storefront and you lose access to the Store FAQs management page until you upgrade again. Once you upgrade, everything is exactly as you left it.
Considerations
Storefront text is English in this version. Translation support is planned for a later release.
No dates are shown to shoppers. You can see when an AI FAQ was generated in the app; shoppers can't.
The widget hides itself when empty — no blank section on your storefront.
The Judge.me app embed must be enabled in your theme for the widget to load.
Troubleshooting
My FAQs aren't showing on my storefront
My FAQs aren't showing on my storefront
Issue:
The Store FAQs widget isn't visible on your storefront.
Why it happens:
There are several common causes. Work down this list to find the one that applies.
How to fix:
Check if the block is on your live theme. If it isn't, the Store FAQs page shows a warning banner with a button straight into the theme editor. This is the most common cause — for example after switching themes, since the block doesn't carry across.
Check if anything is published. AI FAQs start unpublished. If nothing is published, the widget hides itself entirely rather than showing an empty box.
Check if the Judge.me app embed is on in your theme.
Check your plan. Store FAQs is an Awesome feature. If you're on the Free plan, the widget won't display.
AI FAQs say "there isn't enough detail to generate from"
AI FAQs say "there isn't enough detail to generate from"
Issue:
When you try to generate AI FAQs, Judge.me tells you there isn't enough detail.
Why it happens:
AI FAQs are generated from your product descriptions. If your product descriptions are very short or mostly just product names, there isn't enough information to draft meaningful FAQs.
How to fix:
Add more detail to your product descriptions in Shopify, then try generating again. Note that generation reads your product descriptions, not your reviews — having many reviews won't help if your descriptions are thin.
My generation guidance isn't working as expected
My generation guidance isn't working as expected
Issue:
You added generation guidance but the AI FAQs don't reflect what you asked for.
Why it happens:
Generation guidance can only steer within what your product descriptions already say — it won't add information that isn't there. For example, if your descriptions never mention a return policy, asking the AI to "include return policy info" won't produce a return FAQ. Additionally, if your guidance asks the AI to both focus on and avoid topics that overlap, the "avoid" instruction always takes priority.
How to fix:
Check that the topics you want to emphasize are actually covered in your product descriptions in Shopify. If they aren't, add that detail to your descriptions first, then try generating again. To exclude a topic, use "avoid" or "don't mention" — this will always override any emphasis on overlapping content.
Resources
Get your free trial:
🤖 Unlock AI-generated store FAQs to boost SEO, help AI shopping assistants discover your store, and answer shopper questions before they ask — with a 15-day free trial of the Awesome plan.
See our latest updates:
➡️ Check our Unboxed page to discover newly launched features and improvements from Judge.me. See what's new and start using the latest updates to grow your store.