Docs WordPress Plugin

WordPress Plugin

Your all-in-one AI SEO suite directly inside WordPress. 45+ checks across 13 categories, AI Co-Pilot, Content Suite, Monitoring Dashboard, and automated optimization — all in one plugin.

Quick Start

Requirements

WordPress5.0 or higher
PHP7.4 or higher
License KeyRequired for Pro features

Installation

1

Install the Plugin

Go to Plugins → Add New in your WordPress admin. Search for "GAISEO" and click Install Now, then Activate. Alternatively, upload the ZIP file via Plugins → Add New → Upload.

2

Activate your License

Navigate to GAISEO → Activate License. Enter your license key and click Activate. Your license tier will be displayed.

3

Run your first scan

Go to GAISEO → Dashboard and click Scan to analyze your site's AI-SEO readiness across 45+ checks.

4

Follow the Onboarding Wizard

The Home page guides you through 10 setup steps: Organization Data, AI Features, Freshness, Meta Output, AI Traffic Tracking, and more.

Features Overview

Core Features (included with license)

FeatureDescription
SEO Scanner45+ checks across 13 categories with hybrid scoring
AI Co-PilotAlt-Text Generator, FAQ Creator, Header Creator in the post editor
Content SuiteGlossary Creator (CPT + AI), Interlinking Manager, Schema Manager
SEO ToolsSERP Preview, Social Preview, Robots.txt Editor, IndexNow
MonitoringContent Freshness, Score Alerts, AI Traffic Analytics
LLMs.txt GeneratorMachine-readable site description for AI systems
Meta OutputFrontend meta tags (OG, Twitter, Canonical) — for sites without another SEO plugin
GTM IntegrationGoogle Tag Manager with GDPR-compliant Consent Mode v2
Conversion TrackingPrivacy-first attribution by AI traffic source
Team ManagementAssign tasks to team members
Migration WizardMigrate from other SEO plugins

AI-Powered Features (require OpenAI or Anthropic API key)

FeatureDescription
AI Alt-Text GeneratorVision AI-powered image descriptions, 40+ languages, WCAG 2.1 compliant
AI FAQ CreatorGenerate 3–7 FAQs with Schema.org markup, multiple styles
AI Header CreatorGenerate <head> section with Organization Schema, sameAs, preconnect
AI Glossary GenerationAI-suggested terms with definitions, auto-linking
AI Link SuggestionsAI-powered internal linking recommendations
💡
AI Configuration AI features can use either the managed Azure proxy (no API key needed) or your own OpenAI/Anthropic API key. Configure in Settings → API. The default model is GPT-4o-mini.

Onboarding Wizard

The Home page guides you through 10 setup steps. Steps auto-detect your configuration so already-completed items are marked as done.

#StepRequired
1Run your first scan — Analyze your siteYes
2Add Organization Data — Company name, logo, social linksYes
3Enable AI Features — Connect API or use managed serviceOptional
4Configure Freshness Signals — Auto-update datesOptional
5Set up Meta Output — OG, Twitter, Canonical tagsOptional
6Enable AI Traffic Tracking — Track ChatGPT, Perplexity, Claude visitsOptional
7Create FAQ Content — Generate FAQs with SchemaOptional
8Create SEO Header — Organization Schema in <head>Optional
9Set Up Internal Linking — AI link suggestionsOptional
10Set Up Google Tag Manager — GTM with GDPR consentOptional

Dashboard

The main Dashboard shows your AI-SEO scores, category breakdowns, and actionable tasks for every scanned page.

What You See

  • Overall Score (0–100%) with grade and description
  • Category breakdown — score per check category with status labels
  • Task list — failed checks as prioritized, actionable tasks
  • Quick Actions — buttons that link directly to the tool that fixes each issue

Score Grades

ScoreDescription
≥ 95Outstanding
≥ 85Excellent
≥ 75Strong
≥ 65Good Foundation
≥ 50Room for Growth
≥ 35Needs Attention
< 35Critical Issues

Post Editor: AI Content Assistant

A meta box appears on every post/page editor with 4 tabs:

  • Scorecard — run a page-level scan and see your score
  • Action Plan — failed checks as actionable tasks with Quick Fix buttons
  • AI Co-Pilot — Alt-Text Generator, FAQ Creator, Header Creator
  • SEO — SEO-specific tools and recommendations

SEO Checks (45+)

The scanner runs 45+ checks across 13 categories. Each check has a priority (high, medium, low) and some are flagged as AI-SEO specific — meaning they directly impact how AI systems like ChatGPT, Perplexity, and Gemini understand your content.

Headings (2 checks)

CheckPriorityWhat it does
Single H1 TagHighEnsures exactly one H1 per page
Logical Heading HierarchyHighH2–H6 follow sequential order without skipping levels

Images (4 checks)

CheckPriorityWhat it does
Alt Text PresenceHighScans images for missing alt attributes
WebP Image FormatMediumVerifies images use WebP for optimal compression
Responsive Images (srcset)MediumChecks for srcset attributes for multiple sizes
Images for ContentMediumIdentifies info conveyed via CSS background-image

Structured Data (6 checks)

CheckPriorityAI-SEOWhat it does
JSON-LD PresenceHighVerifies JSON-LD script blocks are present
Speakable SchemaMediumSpeakableSpecification for voice search
Article Schema with dateModifiedMediumArticle/BlogPosting schema with date fields
Key Field PopulationMediumDetects incomplete Schema.org blocks
Open Graph Meta TagsMediumEssential OG tags (title, type, image, url)
sameAs PropertyMediumsameAs links for entity disambiguation

E-E-A-T & Trust (9 checks)

CheckPriorityAI-SEOWhat it does
Showcase ExpertiseHighAuthor bylines, Person schema, credentials
Demonstrate ExperienceHighTestimonials, case studies, client logos
Footer TransparencyMediumContact info & legal pages in footer
Link to AuthorityMediumOutbound links to authoritative sources
About Us & Contact PagesMediumLinks to core transparency pages
Robots.txt AI BotsMediumChecks if AI bots are blocked in robots.txt
Author SchemaMediumPerson or Author schema markup
E-E-A-T Schema PropertiesMediumE-E-A-T related schema properties
First Person DensityLowFirst person pronoun usage as experience signal

Content Quality & Relevance (8 checks)

CheckPriorityAI-SEOWhat it does
Topic Coverage (Word Count)HighContent depth based on word count
Table of ContentsMediumJump links to headings in long articles
Call to ActionHighClear next step guidance for users
Key Entity PresenceMediumBrand name in title/H1
Keyphrase PresenceMediumPrimary target keyphrase detection
Entity MentionsMediumKey entities mentioned early in content
URL StructureMediumClean, descriptive URLs
Definitive Answer PatternMediumDirect answers for featured snippets

FAQ (3 checks)

CheckPriorityAI-SEOWhat it does
FAQ HeuristicMediumDetects FAQ-style content patterns
FAQ PairsMediumQuestion-answer pair structure
FAQ SchemaMediumFAQPage Schema.org markup

More Categories

The scanner also checks:

  • Internationalization (3 checks) — lang attribute, hreflang tags, x-default
  • Freshness (4 checks) — display dates, time tags, sitemap lastmod, last-modified meta
  • HTML Semantic Structure (8 checks) — proper tags, semantic grouping, nav, lists, tables, emphasis, cite usage
  • Header & Footer (2 checks) — semantic header/footer tags, named entities in header
  • Internal Linking (1 check) — descriptive anchor text
  • Technical AI SEO (2 checks) — performance hints, code-to-content ratio
  • Technical SEO (2 checks) — ARIA roles, AI control signals
16 AI-SEO Specific Checks Checks marked with "AI-SEO" directly impact how AI systems understand and cite your content. These cover speakable schema, freshness signals, E-E-A-T signals, FAQ patterns, answer patterns, and AI control signals.

Score Calculation

GAISEO uses a hybrid scoring algorithm that combines individual check results with Signal Groups for nuanced evaluation.

Priority Weights

PriorityWeight
High
Medium
Low

Signal Groups

Signal Groups combine related checks into logical signals. For example, the Freshness Signal considers Article Schema dates (preferred), visible dates + time tags (alternative), and sitemap lastmod (fallback). If you have the preferred option, you score higher even if alternatives are missing.

The four Signal Groups are:

  • Page Summary — JSON-LD (preferred), Open Graph, or H1 + meta description
  • FAQ Signal — FAQ Schema (preferred), FAQ heuristic, or FAQ pairs
  • Freshness Signal — Article Schema dates (preferred), display dates + time tags, or sitemap lastmod
  • Brand Entity — Organization JSON-LD + sameAs (preferred), footer transparency, or header entity

AI Co-Pilot

The AI Co-Pilot lives in the post editor meta box (Tab 3). It requires AI to be enabled in Settings and a valid license.

Alt-Text Generator

Generates SEO-optimized, WCAG 2.1 compliant alt text using Vision AI.

  • Auto-detects page language (or select from 40+ languages manually)
  • Batch processing for all images on a page
  • Image optimization options: dimensions, lazy loading, srcset, async decoding
  • Alt text kept under 125 characters
  • Individual "Apply" button per image

FAQ Creator

Generate FAQ sections with Schema.org FAQPage markup.

  1. Select a page and optionally enter a topic focus
  2. Choose number of questions: 3, 5, or 7
  3. Select language (auto-detect or 40+ languages)
  4. Customize style: Default, Accordion, Minimal, or Card
  5. Choose font, size, and color scheme
  6. Drag & drop to reorder, inline editing, add/delete
  7. Copy HTML, Copy Schema, or Insert into Page

Header Creator

Generate an optimized <head> section with Organization Schema.

  • Header styles: Detailed or Minimal
  • Organization Schema.org JSON-LD with sameAs links (Wikidata, Wikipedia, LinkedIn, Crunchbase, Google Business, social profiles)
  • Preconnect and preload tag generation
  • Include logo, contact info, social media
  • Uses organization data from Settings → Organization

Content Suite

Glossary Creator

A full Custom Post Type for building SEO-optimized glossaries.

  • AI-powered term generation — suggest terms for any topic/niche
  • AI-powered definitions — generate entries with related terms, examples
  • TSV import/export — bulk import glossary entries
  • Schema.org DefinitionSet markup
  • A–Z alphabetical archive with taxonomy
  • Auto-linking — automatically link glossary terms in your content
  • WPML integration — bilingual glossaries
  • 40+ supported languages

Interlinking Manager

  • Orphan page detection — find pages with 0 internal links
  • Link count analysis per page
  • AI-powered suggestions — get recommended internal links
  • Anchor text analysis

Schema Manager

Manage structured data across your entire site:

  • Global schemas: Organization, WebSite, LocalBusiness
  • Post-level schemas: Auto-detect, Article, BlogPosting, FAQPage, HowTo, Product, Recipe, Event, Custom JSON-LD
  • Schema validation and preview
  • Meta box integration on the post editor

SEO Tools

SERP Preview

Preview how any page appears in Google search results. See title, description, URL, and character counts.

Social Preview

Simulate how your pages look when shared on Facebook, Twitter/X, and LinkedIn — using your Open Graph and Twitter Card tags.

Robots.txt Editor

Edit your robots.txt with user-agent management and AI bot rules. Control which crawlers can access your site, including AI-specific bots like GPTBot, ClaudeBot, and PerplexityBot.

IndexNow

Submit URLs to IndexNow for fast re-indexing by Bing, Yandex, and other supporting search engines.

LLMs.txt Generator

Generate a machine-readable llms.txt file based on the llmstxt.org specification.

  1. Set your site title for AI models
  2. Add an AI-generated site description
  3. Select key pages (posts + pages)
  4. Auto-generate at your site root

Meta Output (Beta)

Frontend meta tag injection for sites without another SEO plugin (e.g., Yoast, RankMath).

FeatureTags
Open Graphog:title, og:description, og:image, og:url, og:type, og:locale
Twitter Cardstwitter:card, twitter:title, twitter:description, twitter:image
Canonicallink rel="canonical"
Robotsmeta robots
Authormeta author
⚠️
Conflict Detection GAISEO auto-detects Yoast, RankMath, and AIOSEO. If another SEO plugin is active, Meta Output is disabled to avoid duplicate tags. You can force override, but this may cause duplicates.

Monitoring

Content Freshness

Track content age and identify outdated pages:

StatusAge
🟢 FreshLess than 6 months
🟡 Aging6–12 months
🟠 Stale12–24 months
🔴 CriticalMore than 24 months

Features: update queue, batch "mark as fresh", last update tracking, configurable thresholds and reminders.

Score Alerts

Get notified when SEO scores change:

  • Score drop threshold — alert when score drops by X points (default: 10)
  • Minimum score warning — alert when score falls below X (default: 60)
  • Scan frequency: immediate, daily, weekly, or monthly
  • Alert frequency: immediate, daily, or weekly email digests
  • Select which post types to monitor
  • Score history tracking over time

AI Traffic Analytics

Track visitors coming from AI systems — GDPR compliant (no IP, no User-Agent, no full referrer stored).

Tracked AI Platforms

ChatGPT, Perplexity, Claude, Gemini, Microsoft Copilot, You.com, Phind, Poe, Meta AI, DeepSeek

Tracked AI Crawlers

GPTBot, ClaudeBot, Google-Extended, PerplexityBot, OAI-SearchBot, Cohere, YouBot, Meta-ExternalAgent, DeepSeekBot

Dashboard

  • KPI cards: total visits, top source, trend
  • Per-source colored trend chart
  • Visit log with filters
  • CSV export

Conversion Tracking

Privacy-first conversion attribution by AI traffic source.

  • Session tracking: cookie-free (sessionStorage) or cookies with CMP integration
  • Auto-detection of CMP: Borlabs Cookie, Complianz, Real Cookie Banner, CookieYes
  • Configurable data retention (default: 180 days)

Settings

The Settings page has 7 tabs:

TabWhat you configure
APIAI model selection, API key (OpenAI/Anthropic), managed service toggle
LicensingLicense key, activation status, plan details
TeamTeam members (name, email, avatar), task assignment
OrganizationCompany info, address, social profiles, sameAs links, preconnect/preload
IntegrationsGTM, AI Traffic Tracker settings, Score Alert settings, CMP selection
LLMs.txtSite title, description, contact, key pages for AI systems
SupportBug reports, feature requests, contact

Organization Data (Settings → Organization)

This data powers your Organization Schema, Header Creator, and sameAs links. Fill in as much as possible:

  • Company name, URL, logo, industry, description, founded year, employees
  • Address, phone, email
  • Entity links: Wikidata, Wikipedia, LinkedIn, Crunchbase, Google Business
  • Social profiles: Twitter/X, Facebook, Instagram, YouTube, GitHub, TikTok, Pinterest
  • Performance: preconnect domains, preload CSS/JS/images

Troubleshooting

License not activating

  • Check your license key for typos
  • Verify your subscription at gaiseo.com
  • License validation is cached for 12 hours — wait and retry
  • Make sure your site can reach the license server (no firewall blocking)

AI features not working

  • Go to Settings → API and verify your API key
  • Or enable the managed service (no API key needed)
  • Check if AI is enabled: the toggle must be ON
  • Default model is GPT-4o-mini — ensure your API key supports it

Scanner shows no results

  • The page must be published and publicly accessible
  • Drafts, password-protected, or private pages cannot be scanned
  • Check if your site is behind a maintenance mode plugin

Meta Output conflicts

  • GAISEO detects Yoast, RankMath, and AIOSEO automatically
  • If another SEO plugin is active, Meta Output is disabled
  • Use "Force Override" only if you know what you're doing

Glossary auto-linking issues

  • Auto-linking can be disabled in Glossary settings
  • Check for conflicts with other auto-linking plugins
  • WPML users: ensure glossary terms exist in both languages
💬
Need help? Contact us at gaiseo.com/support or use the built-in Settings → Support page.