Documentation

Getting started

Installing AEO FAQ Generator takes under 5 minutes. There are two parts: the Shopify app (where you manage FAQs) and the Theme App Extension block (which displays FAQs on your storefront).

1. Install the app

Click Add to Shopify on the landing page or App Store listing. You'll be redirected to Shopify's OAuth flow. The app requests these scopes: read_products, write_products, read_metaobjects, write_metaobjects.

2. Add the Theme block

Go to your Shopify Admin → Online Store → Themes → Customize. Navigate to a product page template. In the left sidebar, click Add block and search for AEO FAQ. Drag it to your preferred position and save.

3. Generate your first FAQ

In the app, click Products in the sidebar. Select any product and click Generate FAQs. The AI will return 5–8 FAQs in a few seconds.

Product detail page

Every product has a dedicated FAQ detail page — accessible by clicking a product name in the Products list. The page uses a two-column layout:

Left sidebar — product info

A sticky sidebar shows the product's featured image (or a placeholder if none), title, status badge (Active / Draft / Archived), vendor, product type, price range, and a collapsible product description. If the product is published, a View on store ↗ link appears at the bottom of the sidebar.

The sidebar keeps you in context while reviewing or editing FAQs on the right — you can cross-reference the product details without leaving the page.

Right column — FAQ editor

The right column contains:

• FAQ cards — each FAQ shows a confidence badge (High / Medium), numbered position, question, answer, and the source fields the AI used. Click Edit to inline-edit or Delete to remove.
• Add FAQ manually — a collapsible form to write a custom FAQ. Saved FAQs sync to Shopify metaobjects instantly.
• Skipped topics — shown after generation: topics the AI couldn't ground in your product data, with a note on what information to add.

Action buttons

• Generate FAQs / Regenerate FAQs — generate a new set. Regenerating existing FAQs never costs a plan slot.
• Sync with Shopify — push the current FAQ set to the product's Shopify metaobject (happens automatically after generate/edit, but available manually).
• Clear FAQs — removes all FAQs for this product from Shopify. Does not free up your plan slot.

Generating FAQs

Single product

Navigate to Products → [product name]. Click Generate FAQs. The AI reads your product's title, description, variants, tags, and available metafields to produce grounded, conversational Q&As.

Regenerating after product updates

When you update a product in Shopify, the app marks its FAQs as stale. You'll see a Regenerate prompt on the product card. If your product content hasn't meaningfully changed, the app skips re-generation automatically (it hashes the inputs).

The skipped list

After generation, the app shows a Skipped topics section in the right column. These are FAQ topics the AI could not ground in your product data. The message tells you exactly what information to add to your listing to unlock that FAQ.

Category templates

The app auto-detects a category from your product type field and applies the matching template (e.g., Apparel → sizing, care instructions, materials). Templates determine which topics the AI prioritises — they don't limit what it can generate.

Bulk management

The Products list supports bulk actions across multiple products at once.

Bulk generate FAQs

Select products using the checkboxes, then click Generate FAQs (N). The app calls the generation API once per product sequentially, showing a progress count as each completes. Up to 5 requests run in parallel per shop.

Bulk clear FAQs

Select products and click Clear FAQs (N). This removes the FAQ metaobjects from Shopify for each selected product. Note: clearing FAQs does not free up your plan quota — the slot remains consumed. This is by design to prevent gaming the limit by repeatedly clearing and regenerating.

Filtering

Use the Has FAQs / No FAQs filter at the top of the Products list to quickly find products that still need FAQ generation.

Global FAQs

Global FAQs are shop-wide Q&As that appear on every product page automatically. They're ideal for questions about shipping, returns, payment methods, and your company.

Adding global FAQs

Click Global FAQs in the sidebar. Click Add FAQ, enter a question and answer, and choose a category (Shipping, Returns, Payment, Company, Contact, Other). Click Save — the FAQ syncs to Shopify instantly as a metaobject.

Display order

Global FAQs appear after per-product FAQs in the theme block. They're included in the FAQPage JSON-LD schema on every page.

Plan limits

Global FAQs have their own per-plan limits, separate from the product FAQ quota:

• Free — up to 10 global FAQs
• Starter — up to 100 global FAQs
• Growth — unlimited global FAQs
• Pro — unlimited global FAQs

Global FAQs never consume your product FAQ slots.

Theme block

The AEO FAQ block is a Theme App Extension — it runs inside your Shopify theme without modifying theme files. If you uninstall the app, the block disappears cleanly.

Block settings

• Heading text: Override the default "Frequently Asked Questions" heading shown above the accordion
• Include store-wide FAQs: Toggle global FAQs on/off for this block instance
• Maximum FAQs to display: Cap the number of product FAQs shown (1–20)
• Color scheme: Inherits your theme's color scheme variables for a native look

JSON-LD schema

The block automatically outputs a <script type="application/ld+json"> with a valid FAQPage schema. The schema is generated from the same metaobject data as the visible accordion — they cannot drift. Run Google's Rich Results Test on any product page to verify.

Styling

The block inherits your theme's CSS variables (--color-foreground, --color-background, etc.) so it looks native in any Dawn-compatible theme. No custom CSS is required.

Billing & plans

Plan overview

What counts as a "product with active FAQs"?

Any product that has at least one FAQ metaobject linked to it. If you generate FAQs for 10 products, that's 10 slots. Regenerating FAQs for those same products never burns an additional slot. Clearing FAQs from a product also does not free its slot.

Upgrading

Go to Plan & Pricing in the app sidebar. Click Upgrade to [plan]. You'll be redirected to Shopify's billing confirmation page. After approving, you return to the app and your new plan is active immediately. The Pro plan shows "∞" in all quota displays.

Downgrading

Downgrading to a lower paid plan replaces your current subscription — Shopify handles the billing adjustment. Your existing FAQs remain active; you just can't add FAQs to new products above the lower plan's limit.

Cancelling to Free

Click Switch to Free (cancel) on the billing page. Your subscription stops at the end of the current billing period. Existing FAQs stay on your storefront until you manually delete them.

AEO writing tips

These rules drive the AI prompt. If you edit generated FAQs manually, keep them in mind.

Question phrasing

• Phrase questions the way a customer would ask ChatGPT — conversational, specific, 8–15 words.
• "Will this jacket keep me warm in 20°F weather?" beats "What is the temperature rating?"
• Avoid keyword stuffing. AI engines penalise obvious SEO patterns.

Answer construction

• Lead with the direct answer in the first sentence. AI engines extract first-sentence content most reliably.
• Keep answers 30–80 words — useful enough to cite, short enough to extract.
• Every claim must be grounded in your product data. The AI will skip topics it can't ground.
• Reference specific attributes (materials, dimensions, ingredients), not generic claims ("premium quality").

What to add to product listings

The more detail in your product listing, the more FAQs the AI can generate. High-value fields:

• Description: Include materials, dimensions, care instructions, compatibility notes.
• Tags: Add care, material, and feature tags (e.g. machine-washable, merino-wool).
• Variants: Name variants descriptively (e.g. "XS / Black / Merino" not just "Option 1").
• Metafields: Any custom metafields with structured product data are included in the AI context.

Common questions