FAIR

Federated and Independent Repositories

OptAEO – AI Visibility for WooCommerce

Plugin Banner

OptAEO – AI Visibility for WooCommerce

by optaeo

Download
Description

AI assistants are becoming a real shopping channel: ChatGPT, Google AI, Gemini and Perplexity read your store’s structured data to decide whether to recommend your products. Most stores expose thin or conflicting product schema — this plugin fixes that.

OptAEO – AI Visibility for WooCommerce renders one authoritative schema.org Product node per product page, served from your OptAEO account where your product data has been scanned, scored and remediated. It also:

  • Suppresses the competing/thin Product schema that WooCommerce core, Yoast SEO and Rank Math emit on product pages — AI engines see exactly one authoritative source instead of conflicting nodes.
  • Renders your remediated SEO meta title and meta description on product pages (WooCommerce core has no native fields for these).
  • Serves the AI-agent discovery files at your store root — /llms.txt, /llms-full.txt, /agents.md and /agents.txt — a curated, always-current catalogue AI crawlers read first, with your crawl/citation/training policy.

This plugin requires a free or paid account at optaeo.ai. The OptAEO platform is where your products are scanned, scored against a 16-factor AI-visibility model, and fixed; this plugin is the delivery layer that puts the results on your live storefront. Without a connected account the plugin stays inactive (it renders nothing and contacts no external service).

External services

This plugin connects to the OptAEO API (https://optaeo.ai), the service that computes the structured data and discovery files it renders. It is required for every feature of this plugin — nothing is rendered without it.

What is sent, and when:

  • GET https://optaeo.ai/api/plugin/product — requested when a product page is viewed (cached for 5 minutes). Sends: your OptAEO site token (in a request header) and the WooCommerce product ID being viewed. Returns the schema.org JSON-LD, meta title and meta description for that product.
  • GET https://optaeo.ai/api/plugin/protocol — requested when /llms.txt, /llms-full.txt, /agents.md or /agents.txt is fetched on your store (cached for 5 minutes). Sends: your OptAEO site token (in a request header) and the file type requested. Returns the discovery/policy file content.

No customer data, order data, visitor IPs, or analytics are ever sent to OptAEO by this plugin. The site token identifies your store to your own OptAEO account. The plugin also exposes one inbound REST route (optaeo/v1/flush, token-authenticated) that OptAEO calls after you apply a fix, so your storefront updates immediately instead of after the cache window.

Service terms: Terms of Service · Privacy Policy

  1. Install and activate the plugin (WooCommerce must be active).
  2. Create or sign in to your account at optaeo.ai and connect your store.
  3. Copy the site token from your OptAEO dashboard Settings.
  4. In WordPress admin, go to Settings OptAEO, paste the token, and Save.
  5. That’s it — product pages now carry the authoritative schema, and the discovery files are live at your store root for any protocol you’ve enabled in OptAEO.
Does this plugin work without an OptAEO account?

No. The plugin is the delivery layer for the OptAEO platform — it renders the structured data and discovery files your account computes. Without a token it stays inactive and contacts no external service.

Will it conflict with Yoast SEO or Rank Math?

No — that conflict is exactly what it prevents. On product pages it suppresses the Product/Offer schema those plugins (and WooCommerce core) emit, so there is exactly one authoritative Product node instead of several conflicting ones. All other Yoast/Rank Math output (titles elsewhere, sitemaps, breadcrumbs) is untouched.

What are llms.txt and agents.md?

Discovery files AI assistants and crawlers read at a site’s root to understand what a store sells and how they may use it — a curated product catalogue plus your crawl/citation/training policy. The plugin serves them at your store root, kept current automatically as your catalogue changes.

What happens when I uninstall?

The stored token and every cached value are deleted. Nothing else is touched.

0.5.1

  • Declare WooCommerce version support (WC requires at least 8.0, WC tested up to 10.8) and HPOS (High-Performance Order Storage) compatibility – the plugin never touches orders.

0.5.0

  • Security hardening for WordPress.org review: site token now travels in a request header (never a URL); JSON-LD output can no longer be broken out of by data content; document title escaped; REST flush auth moved into the permission callback; protocol files served with nosniff.
  • Uninstall now also removes cached protocol files.
  • Declares the WooCommerce dependency (Requires Plugins).

0.4.0

  • Serve the AI-agent discovery files at the store root: /llms.txt, /llms-full.txt, /agents.md, /agents.txt (token-authed, cached, absent when disabled in OptAEO).

0.3.0

  • Cache-bust REST route (optaeo/v1/flush) so applied fixes appear on the storefront immediately.
  • Suppress WooCommerce core’s own Product structured data (not just Yoast / Rank Math).

0.2.0

  • SEO meta title + meta description rendering on product pages.

0.1.0

  • Initial release: authoritative schema.org Product JSON-LD on WooCommerce product pages; suppresses Yoast / Rank Math product schema.
Back to top