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.
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