Skip to main content
Developer Docs

Widget SEO & AI visibility

Exactly how BlooTrue widgets are crawled by search engines and read by AI systems — how the reviews are rendered, where the schema.org markup lives, and the honest limits of review rich snippets.

How the widget renders

Your embed snippet is a <div> plus a <script>. The script (served from api.blootrue.com) mounts the widget inside a sandboxed iframe, which keeps the widget's CSS and JavaScript fully isolated from your page — zero style or script conflicts. That isolation is the reason review content and schema do not automatically appear in your page's own HTML, which is what the rest of this page is about.

What each plan gets

CapabilityFreePaid
Reviews displayed on your siteYesYes
schema.org JSON-LD injected into your page—Yes (automatic)
schema.json endpoint (place it yourself)—Yes
content.html for non-JS AI crawlers—Yes
“Free Reviews Widget” badge (backlink)Yes— (branding removed)

Review schema markup (and why no stars)

On paid plans (Starter $9/mo and up), the loader injects schema.org Review + AggregateRating + LocalBusiness JSON-LD straight into your page's <head> — so it lives in your own HTML and Google reads it when it renders your page (Googlebot runs JavaScript), and so do Bing and the AI crawlers that render pages.

What it does not do: put stars under your Google result. Google's review-snippet guidelines (updated July 2026) make a business's own pages ineligible for star results when the reviews about it come through an embedded third-party widget, and ask sites not to aggregate ratings from other websites. Our markup passes Google's Rich Results Test, which checks the markup, not eligibility. The rule and the pages that can still show stars are in review rich snippets in 2026.

Prefer to control placement (for example on a specific product or landing page)? Reference the standalone endpoint instead:

GET /api/widgets/embed/:embedId/schema.json

Returns the schema.org LocalBusiness + AggregateRating + Review payload as JSON-LD. Fetch it and inline it into your page head, or reference it directly. Paid plans.

AI crawlers & answer engines

Most AI crawlers — GPTBot, ClaudeBot, PerplexityBot — read your page's raw HTML and do not execute JavaScript. Because the reviews render in an iframe (and the schema is JS-injected), those crawlers do not see your review text on your page by default. To put the review text in your raw HTML where they can read it, inline the content.html endpoint server-side:

GET /api/widgets/embed/:embedId/content.html

Returns a clean, semantic HTML fragment of your reviews (business, aggregate rating, up to 20 reviews) with inline JSON-LD. Inline it server-side so it lands in your page's raw HTML. Paid plans.

// Inline BlooTrue reviews into your page HTML, server-side, so
// non-JS AI crawlers (and search engines) read them as your content.
const html = await fetch(
  'https://api.blootrue.com/api/widgets/embed/YOUR_EMBED_ID/content.html'
).then((r) => r.text());

// Render it into the page (server component, edge middleware, or build step):
<div dangerouslySetInnerHTML={{ __html: html }} />

This is a server-side step by design: a script-embed widget cannot put content into your raw HTML on its own, because the JavaScript has not run when a non-JS crawler reads the page.

If your site is behind Cloudflare

Cloudflare can stop AI crawlers before they reach your page, whatever the widget does. It sorts AI bots into three groups, Search, Agent and Training, and every plan, Free included, can allow or block each group. Domains added to Cloudflare since 15 September 2026 start with Training and Agent bots blocked on pages that show ads, and Search allowed.

  • Search crawlers stay allowed by default. These are the bots answer engines use to find and cite pages, such as OAI-SearchBot (ChatGPT search), Claude-SearchBot and PerplexityBot.
  • Training crawlers are what a block stops. GPTBot and ClaudeBot collect pages for model training. Cloudflare says blocking training-only crawlers like these does not affect search.
  • Check the Training setting. Cloudflare now applies “Block” and “Block on pages with ads” to mixed-use crawlers too, including Googlebot, Bingbot and Applebot, so either one also affects search. To refuse AI training and stay in Google, choose “Disallow AI Training”, which keeps those crawlers allowed for search.

To check yours, open your domain in the Cloudflare dashboard and go to Security settings, then the AI bot policies. None of this changes what visitors see in the widget. It only decides which crawlers can read the page it sits on, including review text you inline with content.html. Cloudflare's own guides: AI bot settings and mixed-use crawlers.

The “Powered by BlooTrue” backlink

Free widgets add one small, visible “Powered by BlooTrue” link into your page — a normal followed link that credits BlooTrue. Paid plans remove all BlooTrue branding, including this link. It never changes your embed code.

FAQ

Can AI crawlers read the review content directly from the widget?

The widget renders inside an iframe that our loader script injects. Crawlers that execute JavaScript and enter the iframe (or fetch the widget render URL directly) get clean semantic HTML plus schema.

If the widget is an iframe, does Google index the reviews as part of my page?

iframe content is attributed to the widget URL, which we serve noindex, indexifembedded — that keeps thousands of standalone widget URLs out of the index while letting Google index the review text as part of your page when Googlebot renders it.

Does the widget output schema.org / JSON-LD, and where is it rendered?

On paid plans, yes. The loader injects schema.org Review + AggregateRating + LocalBusiness JSON-LD directly into your page’s head, so it lives in your own HTML (not trapped in the iframe). You can also place it yourself via the standalone schema.json endpoint. Free plans display your reviews but include no schema — schema/SEO markup is a paid feature.

My site uses Cloudflare. Can AI answer engines still read my reviews?

Usually yes. Cloudflare keeps AI search crawlers such as OAI-SearchBot, Claude-SearchBot and PerplexityBot allowed by default, and its blocks aim at training bots like GPTBot and ClaudeBot. Check your Training setting: Cloudflare now applies Block to Googlebot, Bingbot and Applebot as well. Choose Disallow AI Training if you want to refuse training and stay in search.

Will my pages get star ratings in Google search results from the widget?

No. Google’s review-snippet guidelines (updated July 2026) make a business’s own pages ineligible for star results when the reviews about it come through an embedded third-party widget, and ask sites not to aggregate ratings from other websites. The markup still makes your rating and reviews readable to search engines and AI assistants, which is what we sell it for.