> For the complete documentation index, see [llms.txt](https://help.pagefly.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.pagefly.io/page-structure-and-elements/optimization/how-to-use-aeo-in-pagefly.md). # How to use AEO in PageFly ### What is AEO? AEO (Answer Engine Optimization) is the practice of making a page easy for AI assistants to read, cite, and recommend. It applies to any page - but PageFly's **AEO tool** focuses on where it matters most for selling: your product pages. Shoppers increasingly discover products **inside AI assistants** - they ask ChatGPT, Google AI, Perplexity, or Copilot "what's the best insulated water bottle for the gym?" and the assistant recommends specific products. An AI assistant can only recommend and cite a page it can actually **read**. When AI can't read your page, it recommends someone else's. The **AEO tool** checks how ready each of your product pages is to be read, cited, and recommended by AI, and applies one-click fixes for the parts PageFly controls. With the AEO tool you can: * **Run a free readiness check** that scores a product page from 0 to 100. * **Apply one-click fixes**: add the structured product data AI needs, and add an on-page Q\&A section. * **Follow plain-language tips** for the things you edit yourself (product details, headings, image descriptions). * **Test your page in real AI engines** and see whether you show up. {% hint style="info" %} You don't need a perfect score to get cited by AI. Even a few fixes make your page more likely to be surfaced and cited. {% endhint %} ### Before you start * **The AEO tool works on product pages.** Open a PageFly product page (a page with a Shopify product assigned to it). If no product is assigned, the tool will ask you to assign one first. * **Running the check is free.** See Credits and plans for what costs credits. #### Where to find the AEO tool Two ways in: 1. **From the page editor** - open the **CRO Center**, go to the **Optimize** section, and click the **"AEO - Agentic commerce"** card. This opens the AEO panel for the page you're editing. 2. **From the AEO dashboard** - the **CRO Center → OPptimize → AEO** page lists all your product pages under **"Page AI-readiness"**, with each page's score, status (**Good** / **Needs work** / **Not checked yet**), and when it was last checked. Click **Open** or **Check** on any row to jump into the editor for that page. ### Your AEO score When you open the AEO tool for a page, PageFly analyzes it and shows an **AEO score** on a 0-100 gauge. The score is grouped into four bands: | Band | Score | Meaning | | ------------------- | ------ | ----------------------------------------------------- | | Not ready for AI | 0-39 | AI engines can't reliably read or cite this page yet. | | Partly ready for AI | 40-69 | Some signals are in place; key fixes still missing. | | Good | 70-89 | Most of what AI needs is present. | | Excellent | 90-100 | The page is highly readable and citable by AI. | The color reflects the band: green (Good/Excellent), amber (Partly ready), red (Not ready). Below the gauge you'll see **One-click fixes** and **Tips** for this page. #### Re-checking your score After you make changes, click **"Re-check"** to recalculate the score. Two rules decide when a change counts toward your score: * **Product schema fixes go live when you Publish.** After you apply a schema fix, PageFly shows: *"Publish your page to make these fixes live on your store, then re-check.".* Re-check still works before publishing, but the score reflects what's live. * **Q\&A changes count when you Save.** After you insert, edit, or remove a Q\&A section, save the page and Re-check re-enables. ### One-click fixes The **One-click fixes** section lists the improvements PageFly can apply for you. Each fix shows a priority badge (**High** / **Medium** / **Low**), the points it's worth, and whether it's invisible to shoppers or changes your live page. The two fixes PageFly applies directly are **Product schema** and **On-page Q\&A**. #### Product schema - "Help AI read your price and rating" **What it is:** Structured data (called Product JSON-LD) is a hidden, machine-readable summary of your product - name, price, availability, brand, rating - that AI engines and Google read to understand and cite your page. Shoppers never see it; AI does. **How to apply it:** 1. On the **"Help AI read your price and rating"** fix, click **"Fix now"**. 2. **Publish your page** to make it live. The card badge changes from **Not published** to **Published**. 3. Click **"Re-check"** to update your score. **If your theme or another app already adds product data.** PageFly detects existing product schema and won't create a duplicate by default (two competing blocks can confuse search engines). Depending on what it finds, you'll see: * **"You're covered"** - your theme or an app already provides product data. You can **Keep theme's** or choose **Use PageFly's anyway**. * A note that a provider *"already provides complete Product data - no action needed."* **To undo.** Click **"Revert"** on an applied fix, then publish. #### On-page Q\&A - "Answer shoppers' buying questions" **What it is:** PageFly reads your page and writes a set of shopper-style questions and answers, adds them to your page as a Q\&A section, and attaches FAQ structured data so AI engines can cite the answers. Q\&A is one of the strongest signals for getting cited. **Before you generate:** your page needs at least **50 words** of content. If it has less, PageFly shows *"Add more text content to your page (minimum 50 words)"* instead of the generate button. **How to generate and add Q\&A:** 1. On the **"Answer shoppers' buying questions"** fix, click **"Generate Q\&A"**. PageFly analyzes your page and generates the pairs. 2. **Review the pairs.** Each pair has a checkbox. Fully answered pairs are pre-selected; **draft** pairs (common questions your page doesn't answer yet) start unchecked with an **"Add your answer"** link. * Click a pair to expand its **Question** and **Answer** fields and edit them. * Fill in a draft's answer and it selects itself automatically. * Keep answers concise. 3. Click **"Insert answered pairs"** to add the selected Q\&A to your page. You'll see *"FAQ section added. Schema will be active on publish."* 4. **Save**, then **Re-check** to update your score. **Publish** to make the FAQ schema live. **Language:** PageFly detects your page's language automatically and writes the Q\&A in that language, grounded in the product bound to the page. **To regenerate:** Click **"Regenerate"** to get a fresh set **To edit later:** Re-open the AEO tool on the page; the inserted pairs show under *"Inserted to page. Edit or regenerate below."* Use **"Update FAQ section"** after edits. **To remove:** Click **"Remove Q\&A from page"** to delete the inserted section. ### Tips Below the one-click fixes, the **Tips** section lists improvements you make yourself. PageFly detects the gap and tells you what to do; it doesn't change the content for you. Common tips: * **"Add concrete product details"** - pages with specific facts (materials, dimensions, use cases) give AI more to cite. * **"List your specs in a table"** - a spec table is easy for AI to parse. * **"Describe your product images"** - add alt text so AI understands your images. * **"Give the page clear headings"** - a clear heading structure helps AI find answers. * **"Let AI crawlers read your page"** - make sure AI crawlers aren't blocked. * **"Price & stock load fine for AI"** - shown with a green check when your page already loads price and stock in a way AI can read. Once your product schema is live, you'll also see an **IndexNow** tip - a one-click way to *"Tell Bing and other engines to re-crawl after changes."* This helps Bing-powered assistants (ChatGPT Search, Copilot) pick up your changes faster. It does not affect Google. ### Test your page in AI The **"Test your page in AI"** card lets you search the way a real shopper would and check whether you show up. 1. If your page has more than one product, pick one under **"Preview for product"**. 2. Type a shopper question in **"What would a shopper ask?"** (PageFly seeds a realistic query for you), or use the quick-fill chips **Your product name** and **A need or use case**. 3. Under **"Open this search in:"**, click **ChatGPT**, **Google AI Mode**, or **Perplexity** to run the search in a new tab. {% hint style="info" %} Each AI answers differently, so try a few. Use an incognito tab for a more honest result. Not showing up right away is normal - many things affect when AI picks up your page. {% endhint %} ### Agentic Commerce The **Agentic Commerce** section is about getting your products **listed for AI shopping agents** through Shopify (ChatGPT, Copilot, Gemini). This is set up in **Shopify**, but PageFly can show you the status and hands you off to the right settings. * If PageFly needs permission to read your store policies and channels, click **"Grant access"**. * The **"Shopify Catalog readiness"** card shows **Active** when your products are listed for AI shopping, or a to-do list and an **"Open Agentic settings"** button when there's setup left to do in Shopify. **Give AI more store context.** The Q\&A you add covers a single page. To help AI answer broader questions - policies, brand, general store info - add those details in **Shopify's Knowledge Base** aopp so AI has more of your store to draw on. ### Credits and plans | Action | Cost | | -------------------------------------------- | ------------------ | | Run the readiness check / score / Re-check | **Free** | | Product schema fix ("Fix now") and Revert | **Free** | | Generate or Regenerate Q\&A | **5 credits** each | | Test in AI, Agentic hand-off, Knowledge Base | **Free** | **Free and Builder plans** get a one-time **AEO trial of 10 credits, valid for 7 days**. The trial starts when you first open the AEO tool, and each Q\&A generation uses 5 credits from it (enough for two generations). When your trial credits run out or the 7 days end, the AEO panel is replaced by an upgrade screen: * **"Upgrade to keep using AEO"** with an **"Upgrade plan"** button. * The message tells you why - trial ended, trial credits used up, or a higher plan is required. **Optimize plan and higher** don't use the trial pool - Q\&A generation draws 5 credits from your main AI credit balance, and the AEO tool is never gated. Running the readiness check and applying the free Product schema fix stay free on every plan. ### FAQ and troubleshooting #### **Why is "Re-check" greyed out?** Only when you have an unsaved Q\&A change. PageFly shows *"Save your page, then Re-check to update your score."* Save the page and Re-check re-enables. #### **I applied a Product schema fix but my score didn't move.** The fix goes live only when you **Publish**. Until then the card reads **Not published** and you'll see *"Publish your page to make these fixes live on your store, then re-check."* Publish, then Re-check. #### **My page has several products. Which one gets checked?** The score is for the page, not a single product. However, structured data isn't locked to one product, though - it automatically fills in the details of whichever product the page is showing, so each product still gets accurate data for AI and Google. To preview this, use the product picker in Test in AI and the "What AI & Google read" preview to switch between products. #### **I published everything but I still don't show up in ChatGPT / Google.** AI re-reads pages on its own schedule (days to weeks), personalizes answers, and varies between sessions. The AEO tool improves your odds; it's not instant or guaranteed. Make sure the page is published and publicly readable, and use the **IndexNow** tip to prompt a faster re-crawl on Bing-powered assistants. #### **What's the difference between the AEO tool and Agentic Commerce?** PageFly's AEO tool scores and fixes how readable your page is for AI on the open web. Agentic Commerce is a hand-off to Shopify's own settings for listing products with AI shopping agents - PageFly doesn't score or change that, it points you to the right place. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.pagefly.io/page-structure-and-elements/optimization/how-to-use-aeo-in-pagefly.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.