How to Set Up the AI Page Ready AEO Audit Widget

Before you start

If you are new to this type of tool, start with what an AEO audit widget is and how agencies use it, or watch the 60-second demo.

You will need:

• An AI Page Ready agency account. If you do not have one, create an account on the Free plan.
• A page where you want the audit widget to appear, such as your homepage, an AEO service page, or a campaign landing page.
• Access to edit that page, or someone who can add the embed code for you.

The widget is installed with a short JavaScript embed code and works with website builders as well as custom-coded websites.

1. Create a campaign

Log in to AI Page Ready. From the Apps tab of Your Agency Dashboard, find AEO Audit Lead Generation and select Open App.

Select Create New Campaign.

Enter two details:

1. Campaign Name — Use an internal name you will recognize, such as Homepage AEO Audit. Visitors will not see it.
2. Leads Email Recipients — Enter each person who should receive new leads. After every address, type a comma or press Enter.

2. Match the widget to your brand

Use the Appearance section to control how the widget and reports look.

• Theme — Choose a dark or white background for the embedded form and web report.
• Language — Choose from 24 supported languages for the form, web report, PDF, and report email.
• Button Color — Match your website's primary action color using the HEX color picker. You can switch the picker to RGB if needed.
• Button Text Color — Choose a contrasting color that remains easy to read. This picker also opens in HEX mode.

You can also remove AI Page Ready branding. When you finish setting up the campaign, use the Preview tab to check the form, web report, and PDF.

3. Choose the lead form fields

Use the Form Heading to make a clear promise about what visitors will receive. For example:

• Get your free AI search readiness report
• Is your business visible in ChatGPT and Gemini? Find out now.
• See what may be holding your website back in AI search.

The page URL is always shown and required because AI Page Ready needs it to run the audit. You can show or hide the following lead fields and make each one optional or required:

• Name — Identify the lead and personalize your follow-up.
• Email — Send the report and follow up by email.
• Phone — Call or message leads when that is part of your process.
• Company name — Identify the business associated with the audit.

For most lead-generation campaigns, ask for name and email. If leads should receive their report by email, make the email field required.

4. Configure the reports

The AI Search Readiness Audit is included in every campaign. It checks structured data, LLM-friendly formatting, accessibility, content quality, discoverability, and readability.

You can also enable AI Search Visibility for a campaign. This checks whether ChatGPT and Gemini recommend the lead's brand for relevant searches.

If you enable it:

1. Choose ChatGPT, Gemini, or both.
2. Choose the report tab visitors should see first.

Use AI Readiness Audit as the default when you want leads to first see what may be limiting their website's readiness. Use AI Search Visibility when you want them to first see whether their brand appears in relevant AI responses.

Add a branded PDF

AI Page Ready generates a PDF for every completed lead report. Visitors can open it from the web report, receive it in the report email when enabled, and you can download it from the campaign's Leads section.

Turn on Branded PDF Report to add your logo, agency name, website, contact details, cover title, and introductory message.

5. Choose how leads receive their report

Turn on Send an email to your leads with the report link if you want AI Page Ready to email completed reports automatically.

• Sender Name — The name leads see as the sender.
• Reply-To Email — The address that receives replies.
• Email Subject — Write your own subject or use the default in the campaign's language.
• Campaign Page URL — Enter the public URL of the page where the widget is embedded if you want the email to return the lead to that page. If you leave it blank, the email opens the hosted report directly—on your configured report domain when available, or on the standard AI Page Ready domain when no report domain is configured. See how to set up an AI Page Ready subdomain or your own report domain.
• Send Report PDF — Attach a PDF copy to the email.

Customize the report email

Turn on Use a custom email body when you want the message to sound like your agency, explain the report, or guide the lead towards replying or booking a call.

In the custom email editor, you can:

• Write and format the message in Simple mode or edit the source in HTML mode.
• Use Add variable to insert the lead's name, report link, or your agency name.
• Use Add Report Link to insert a link to the completed report.
• Preview the email with sample information or reset the starting template.

Make sure a custom email includes the report link so the lead can open their results.

6. Track conversions with custom JavaScript

The Advanced Settings section lets you run JavaScript when the embedded form or completed report loads. This Scale plan feature helps agencies measure the widget as part of a marketing funnel.

• JavaScript (Form Page) — Runs after the audit form loads.
• JavaScript (Report Page) — Runs after the completed report loads inside the widget.

Your analytics or advertising tool should already be installed on your website. Paste JavaScript only, without opening or closing <script> tags.

If your website uses the Google tag (gtag.js), this example sends a form-view event:

if (typeof gtag === 'function') {
    gtag('event', 'apr_audit_form_view')
}

For the report page, use a different event name:

if (typeof gtag === 'function') {
    gtag('event', 'apr_audit_report_view')
}

This is a Google tag API example, not specifically a Google Tag Manager example. If you use Google Tag Manager, Meta Pixel, or another platform, add the event snippet recommended for that platform.

Some website builders isolate custom embeds inside another iframe. In that situation, tracking functions installed on the main website—such as gtag() or Meta Pixel's fbq()—may not be available inside the isolated embed.

7. Choose report content

After reviewing the campaign settings, select Create. The campaign opens on Configure Report, where you can choose the summary content, audit categories, and individual checks included in its reports.

The first three switches control the report's summary sections:

• Recommendations — Gives the lead a practical list of actions they can take to improve the audited webpage.
• Top Strengths & Areas for Improvement — Summarizes what the webpage already does well and the most important opportunities to address.
• Section Scores — Shows category-level scores so the lead can quickly compare performance across the main areas of the audit.

Recommendations is off by default. The other two summary sections are on by default.

You can then enable or disable each audit category and select the individual checks that run inside it:

• Structured Data — JSON-LD, Meta tags, Entity Linking, Date Markup, and Media Semantics.
• LLM-Friendly Formatting — Headings Structure, Tables & Lists, and Q&A Structure.
• Accessibility — Critical DOM and Core Web Vitals.
• LLM as a Judge — Embedding Overlap and LLM Content Clarity Analysis.
• Discoverability — Robots.txt Rules, Sitemap.xml Analysis, HTTP Status & Hygiene, Open Graph Tags, Twitter Card Tags, LLMs.txt Analysis, and MCP.json Check.
• Readability — Readability Score and Content Density.

Disabled checks are not run or shown, and the report's scores reflect the checks you selected. If a category is enabled, keep at least one of its checks selected.

Select Save after you finish choosing the report content.

8. Copy the embedding code

1. Open the Embedding Code tab.
2. Select the copy icon beside the code.
3. Paste the complete snippet into your website.

9. Add the widget to your website

Choose your platform below. In every case, paste the complete snippet on the page where the widget should appear.

If you selected Top Bar, the bar appears at the top of the page and moves the page content down, regardless of where you paste the snippet. Its button opens the audit in a popup; the bar stays in place behind the popup. By default, the bar scrolls away with the page. Turn on Always visible while scrolling to keep it at the top, or use the desktop and mobile switches to limit where it appears.

Check the published page on desktop and mobile. A website with a fixed or sticky header may need its header offset or stacking order adjusted when the bar stays visible. If your website builder runs custom code inside a separate iframe, the bar can only reach the top of that iframe; add the snippet through site-wide custom code when the builder offers that option.

10. Preview and test the widget

Open the campaign's Preview tab and check:

• Form Preview — Confirm the heading, fields, theme, language, and button colors.
• Report Preview — Confirm the web report, the tab shown first, and the report sections and checks you selected.
• PDF Preview — Confirm the logo, agency details, cover content, and report-section configuration.

For a Top Bar campaign, Preview shows the bar styling only. Check its button, popup, scroll behavior, and page spacing on the published website.

Then submit a test lead through the form on your published website:

1. Open the page in a private or incognito window.
2. Enter a page URL and complete the lead form using an email address you control.
3. Wait for the audit to finish and open the report.
4. Confirm that disabled categories and checks are absent and that the summary sections match your settings.
5. Confirm that the lead reached every notification address.
6. Confirm that the lead received the report email, if enabled.
7. If you added tracking code, confirm that the events appeared in your analytics platform.
8. Repeat the test on a phone.

11. Go live

Once the published test works, your widget is ready to receive traffic. Monitor new submissions in the campaign's Leads tab and adjust the campaign settings whenever you want to refine the experience.

If you also want to generate reports for businesses you select for outbound outreach, continue with the Prospector setup guide.

Set up a custom domain or subdomain

On a paid plan, your reports can use an AI Page Ready subdomain or a subdomain of your own domain. In the Agency Dashboard, go to Settings → Domain Settings.

Use an AI Page Ready subdomain

Open the Subdomain tab and enter the name you want before .aipageready.com, such as future-rank.

1. Enter a name using lowercase letters, numbers, and hyphens.
2. Wait for AI Page Ready to confirm that it is available.
3. Review the preview URL, then select Save.
4. Confirm the report domain.

Choose the AI Page Ready subdomain carefully. After you save it, you cannot change or remove it yourself, but support can help you replace it. If you later connect your own domain, that address is used for new direct report links instead.

Use your own domain

Open the Domain tab to use an address on a domain you already own, such as reports.agency.com.

1. Enter the prefix in Subdomain, such as reports.
2. Enter your existing domain without https:// or www, such as agency.com.
3. Select Save.

Add the DNS record

After you save the address, AI Page Ready shows the CNAME record you need to add. Your DNS provider is the company that manages your domain's DNS records—commonly Cloudflare, GoDaddy, Namecheap, or your website host.

The CNAME points your report subdomain to AI Page Ready so reports can load there securely.

4. At your DNS provider, add the CNAME record shown by AI Page Ready. It points to domains.aipageready.com.
5. Return to AI Page Ready and select I've added this DNS record.
6. Wait for the status to change from Awaiting DNS to Activating HTTPS, then Active.

You can revise an unverified domain. Once verification and activation begin, contact support if it needs to be changed.

After the domain is active, open a direct report link and confirm that it uses the expected hostname and HTTPS.

Troubleshooting

The widget does not appear

• Confirm that you pasted the complete snippet and that its campaign ID is present.
• Make sure the editor did not remove the <script> tag.
• Test the published page; some builders do not run scripts inside the editor.
• Ask a developer to check the browser console for blocked-script or Content Security Policy errors.

The widget is cut off

The widget adjusts its own iframe height. If it is still cut off, the website builder is usually constraining the surrounding embed element or section.

• Set the embed element to fill the available width.
• Increase the surrounding element or section height, or remove a fixed height that clips its contents.
• Check desktop and mobile separately.
• In Wix, resize both the HTML embed element and its section.

Lead or report emails are missing

• Check Leads Email Recipients in the campaign Overview.
• Confirm that report emails are enabled and that the form collects an email address.
• Check spam or junk folders.
• Open the campaign's Leads tab to confirm that the submission was captured.

The custom report domain is not active

• Confirm that the CNAME host matches the subdomain shown in AI Page Ready.
• Confirm that the CNAME value is domains.aipageready.com.
• Allow time for DNS changes to propagate, then select Check status.
• If the status says Needs attention, check the DNS record and try verification again.

FAQs