Documentation
Everything you need to set up and use CiteBoost GEO to get your WordPress site cited by AI search engines.
Getting Started
CiteBoost GEO helps your WordPress site get discovered and cited by AI search engines like ChatGPT, Claude, Gemini, and Perplexity.
- Install the plugin from the WordPress Plugin Directory or upload the ZIP file.
- Activate the plugin. You'll be redirected to the GEO Optimizer settings page.
- Access the plugin from WP Admin > CiteBoost GEO in the left sidebar.
- Click Run Full Scan to analyze all published posts and pages.
Guided UX (v1.8.0)
v1.8.0 added five layers of guidance so non-SEO users can understand what to do and why, without leaving the dashboard. Everything below is included in the Free tier.
Start Here Priority Card
At the very top of the Dashboard you'll see a colored card with one action — your single most-urgent thing to fix. The card answers four questions in plain language: what's the problem, why does it matter for AI search, how urgent it is, and what to click to fix it.
The card's priority cascade goes: blocked AI bots → zero schemas → weak content (with the worst fixable post named) → partial schema coverage → missing author bios → stale scan. Once you fix the top item, the card updates to show the next priority.
Boilerplate pages (Privacy Policy, Terms, Accessibility Statement, Contact, About) are excluded from “improve this post first” suggestions— those almost never deserve to be a site owner's #1 content priority. The card targets the fixable band (posts with content scores between 20-60%), so it never suggests posts that are too short to bother with or already in good shape.
Schema Verification Status
Every saved schema row in the Schema tab now shows a colored status badge:
- Active & Validated (green) — schema is being output on the page and passed validation
- Validation warning (yellow) — active but has non-critical issues
- Validation error (red) — active but has errors that AI engines may reject
- Inactive (gray) — saved but not output on the page
Each active row also shows a “View in page source” link that opens the live page and scrolls directly to your JSON-LD, plus a “Test in Google”link that pre-fills Google's Rich Results test with the post URL. You stop having to manually copy-paste to verify your schemas are working.
Page-Specific Recommendations
Content tips used to be generic (“use question-style headings”). In v1.8.0 they quote your actual content. Examples of what you might see when you expand a post:
- “Your intro starts with 'Whether you're a beginner or expert...'— that's a hedge, not a direct answer. Open with 2-3 sentences that directly answer the main question.”
- “Your headings ('Pricing', 'Features') are statements. Rephrase 2-3 of them as questions (e.g., 'What is X?' instead of 'X').”
- “This 250-word post is too short — aim for at least 300.”
- WooCommerce-specific: “This product has only 1 review — encourage customers to leave more so aggregateRating appears in AI shopping answers.”
All rule-based. No external API calls, no AI cost — just smart content inspection.
Inline Help on Every SEO Term
Hover or click the small ? icons next to terms like Schema, JSON-LD, robots.txt, AI Visibility Score, Schema Coverage, Bot Accessibility, Citations. Each one expands a plain-English explanation. The Dashboard metric cards also have “Why this matters” expanders that explain how each metric affects your AI citation chances.
Score Trend Interpretation
Above the Score Trend chart you now see a one-line summary like“+8 since last scan. Main contributor: schema coverage.” Numbers with context, not just lines. Green for improvements, red for drops, with the biggest contributing factor named so you know which area moved.
GEO 2026 Update (v1.9.0)
v1.9.0 brings CiteBoost GEO in line with how AI search works in 2026 — based on current research into what AI engines actually cite. Plus v1.8.2 expanded the tracked AI bot list.
AI Bot Access Strategy
AI vendors now run two kinds of crawler: search crawlers (OAI-SearchBot, PerplexityBot, Claude-SearchBot…) that fetch your pages at query time and drive live citations, and training crawlers (GPTBot, ClaudeBot, CCBot…) that absorb your content into AI models with no attribution. The Robots tab now lets you choose:
- Allow all — the simplest option (default)
- Allow search, block training — a 2026 best-practice preset that keeps the crawlers that cite you while blocking the ones that just train on you
- Custom — per-bot control (Pro)
Your AI bot access score now measures whether search crawlers can reach you — so deliberately blocking training crawlers never lowers your score. The plugin tracks 14 AI bots (as of v1.8.2): GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-SearchBot, Claude-User, PerplexityBot, Perplexity-User, Google-Extended, Applebot-Extended, Amazonbot, Bytespider, CCBot, and Meta-ExternalAgent.
Image Schema (Multimodal)
AI engines increasingly cite images alongside text. CiteBoost GEO can now generate ImageObject structured data from your featured images (Pro), and the manual editor accepts ImageObject and VideoObject too, so your visuals can be surfaced in AI answers — not just your prose.
Smarter Content Recommendations
The page-specific diagnoser gained new checks based on what AI engines extract best: it flags overly long sentences and walls of text (AI lifts short, scannable passages), and nudges you toward information gain— original data, first-hand experience, or unique analysis AI can't assemble from other sources.
llms.txt Generation
Optionally publish an llms.txtfile at your site root — a clean markdown index of your content for AI assistants that retrieve pages in real time. Enable it under Settings → Preferences. It's an emerging standard: no major AI engine has confirmed it uses the file for citation yet, so it's off by default, clearly labeled experimental, and does not affect your AI Visibility Score. Included free.
Dashboard
The dashboard shows four metric cards after scanning your site:
| Metric | What It Measures |
|---|---|
| AI Visibility Score | Overall readiness for AI search engines (0-100) |
| Schema Coverage | Percentage of posts with structured data (JSON-LD) |
| Bot Accessibility | Whether AI bots can crawl your site (robots.txt) |
| Content Readiness | Content structure quality (headings, word count, etc.) |
Below the metrics, individual check cards show pass/fail/warning status for each factor. Cards with issues include direct action links like “Fix now” or “Add schema” that take you to the relevant tab.
Pro-only checks appear as locked preview cards with an upgrade prompt.
Score Trend Chart
Right below the Re-Scan button, a line chart plots your site-wide AI Visibility Score over time. Toggle between 7 / 30 / 90 days using the range selector.
A green Goal line marks your target score. Configure it in Settings → Preferences → Score Goal (default: 80). Every scan adds a new data point — over time you'll see whether your content changes are moving the needle.
Below the chart: Last scan timestamp and Next auto-scan (if enabled).
Pro users get a second chart: per-post score historyinside each expanded post on the Schema tab — see exactly how each page's score changed week over week.
Robots.txt
AI bots need permission to crawl your site. This tab shows which bots are currently allowed or blocked.
- Click Allow All AI Bots to add the necessary rules.
- If you have a physical
robots.txtfile, the plugin edits it directly. - If WordPress generates your
robots.txtdynamically, the plugin uses a filter. - You can disable the fix at any time (with confirmation prompt).
Schema (Structured Data)
Schema markup (JSON-LD) helps AI engines understand your content. Switch between Posts and Pages tabs to see all published content.
Expand any post to view and manage its schemas. Found/missing schema types show as colored badges.
Adding Schemas
Free Users
Use the Paste JSON-LD tab to paste valid JSON-LD markup. The plugin validates it before saving.
Pro Users — Three Options
| Method | How It Works | Speed |
|---|---|---|
| Quick Generate | Builds schema from WordPress post data (title, author, dates, categories) | Instant |
| AI Generate | Sends content to Claude, GPT, or Gemini for optimized schema | 5–15 sec |
| Paste JSON-LD | Manual paste with validation | Instant |
Select the schema type (Article, BlogPosting, FAQPage, HowTo, BreadcrumbList, Product, and more) and click Generate. Preview the result, then save.
The Recommendations Checklist turns content tips into trackable checkboxes with a progress bar. Check each as you apply it — state is saved per post.
WooCommerce
When WooCommerce is active, a Products tab appears in the Schema panel alongside Posts and Pages. Every published product is listed and can be analyzed and scored.
For product pages, the scoring is context-aware: Product replaces Article/BlogPosting in the desired types list — a product without a Product schema is correctly flagged as missing.
Pro users get a dynamic Product schema builder that extracts every relevant field from WooCommerce automatically:
- Name, description, SKU, URL, category hierarchy
- Price & currency — from WC settings, including
priceValidUntilon sale - AggregateOffer for variable products — price range (lowPrice, highPrice) + offerCount
- AggregateRating from WooCommerce reviews
- Brand detection from product attributes, WooCommerce Brands plugin, or WC 9.4+ native brand taxonomy
- Images — featured + gallery, up to 5, as ImageObject with dimensions
- Weight & dimensions
AI Generate also works on products — the plugin injects a PRODUCT DATA block into the prompt so Claude/GPT/Gemini have structured facts to work with.
Templates Library (Pro)
Click Browse Templates inside any expanded post to open a gallery of pre-built schema recipes. Each template is a starter JSON-LD with placeholders that auto-fill from your post data.
Available templates:
- Article, BlogPosting — for blog posts and news
- Product — generic product schema
- WooCommerce Product — SKU, price, and currency auto-filled from WC
- Recipe — cooking/baking with ingredients and steps
- Event — conferences, webinars, meetups
- LocalBusiness — brick-and-mortar shops with address & phone
- Review — product/service/creative work reviews
- Course — educational courses
Fill in the fields, preview the JSON-LD, and click Apply. The schema is validated and saved to the post.
Bulk Operations (Pro)
For stores and blogs with many posts, Pro users can manage schemas for up to 50 posts at once. Checkbox column appears on the Schema tab for each row.
Bulk actions:
- Generate template — create Article, BlogPosting, Product (WooCommerce), or any other template type across all selected posts
- Delete all schemas — housekeeping across selection
- Activate all — turn on saved schemas in bulk
- Deactivate all — turn off without deleting
Rate-limited to 5 bulk operations per minute to protect your database.
Schema Backup
Available to all users in Settings → Schema Backup & Transfer:
- Export — download all saved schemas as a single JSON file (includes plugin version, export date, site domain for reference)
- Import — upload a JSON export from another site. Preview shows matched, unmatched, and invalid items before anything is written. Posts matched by slug + post type (stable across sites).
- Conflict strategy— choose “Replace existing” or “Skip if already saved”.
- Maintenance — one-click cleanup of orphaned schema rows (schemas attached to deleted posts).
Ideal for staging → production workflows: configure all schemas on staging, export the JSON, import to production.
Automation
Automatic Weekly Scan (Free) — enable in Settings → Preferences → Automatic Weekly Scan. Pick a day (Sunday – Saturday) and hour (00:00 – 23:00) in your site's timezone. Once per week, CiteBoost GEO re-analyzes every post and page so your Score Trend chart stays fresh without manual effort.
Dashboard shows Last scan timestamp and Next auto-scan time below the Re-Scan button.
Powered by WordPress Cron. No external services required.
Weekly Email Digest (Pro)
Receive a weekly summary email delivered to the inbox of your choice. The email includes:
- AI Visibility Score with week-over-week change
- Top 3 pages that improved
- Top 3 pages that dropped
- AI bot crawl activity (week-over-week)
- New citations detected via Perplexity (if configured)
Configure in Settings → Preferences → Weekly Email Digest: enable, set recipient, pick day of week and hour, optionally customize the From address. Click Send Test Email anytime to preview.
Analytics (Pro)
Bot Crawls
Tracks when AI bots visit your site. Shows bot name, pages crawled, and timestamps. Filter by date range (1–365 days).
Citations
Monitors whether AI engines cite your content in their responses. Add tracked queries in Settings to check specific search terms.
- Click Check Citations Now to run an on-demand check via the Perplexity API.
- Use Load More to page through historical citation data.
Settings
| Setting | Details |
|---|---|
| License | Managed by Freemius. Click “Upgrade to Pro” in the plugin to purchase and activate your license directly from WordPress — no external checkout needed. |
| API Keys (Pro) | Add keys for Anthropic (Claude), OpenAI (GPT), Google (Gemini), and Perplexity. Keys are encrypted at rest. |
| AI Model | Select which model to use for schema generation. Options load dynamically from the server. |
| Tracked Queries | Add search queries to monitor for citations (up to 500 characters each). |
Free vs Pro
| Feature | Free | Pro |
|---|---|---|
| AI Visibility Scan | Yes | Yes |
| Score Trend Chart (7/30/90 days) | Yes | Yes |
| Score Goal Line | Yes | Yes |
| Automatic Weekly Scan | Yes | Yes |
| Robots.txt Fix | Yes | Yes |
| Schema Detection & Analysis | Yes | Yes |
| Paste JSON-LD (manual save) | Yes | Yes |
| Per-Schema Activate/Deactivate/Delete | Yes | Yes |
| Recommendations Checklist | Yes | Yes |
| Schema Backup (Export/Import) | Yes | Yes |
| Bot Crawl Tracking (9 bots) | Yes | Yes |
| AI Referral Tracking | Yes | Yes |
| Multilingual (7 languages + RTL) | Yes | Yes |
| Quick Generate (templates) | — | Yes |
| AI Generate (Claude/GPT/Gemini) | — | Yes |
| Templates Library (Product, Recipe, Event, etc.) | — | Yes |
| WooCommerce Dynamic Product Schema | — | Yes |
| Bulk Operations (up to 50 posts) | — | Yes |
| Per-Post Score History Chart | — | Yes |
| Weekly Email Digest | — | Yes |
| Citation Monitoring (Perplexity) | — | Yes |
| Configurable AI Model | — | Yes |
| Priority Email Support | — | Yes |
Ready to unlock Pro features?
View Pricing