Skip to main content
GEO AI provides a comprehensive settings panel in Settings → GEO AI with 10 configuration tabs. This guide covers all available options.

​
General Settings

Core configuration for API access and plugin behavior.

​
Google Gemini API Key

1

Enter Your API Key

Paste your Google Gemini API key obtained from Google AI Studio.
2

Test Connection

Click Test Connection to verify the key works before saving.
3

Save

Click Save Changes to encrypt and store the key.
API keys are encrypted using libsodium when available, with XOR obfuscation fallback on older systems.

​
Auto-run Audit

☐ Run AI audit automatically when publishing or updating posts
  • Enabled: Every post publish/update triggers an automatic audit
  • Disabled: Audits only run when manually triggered from editor sidebar
Auto-run may slow down post saves if you have very long content. Consider disabling for sites with 5,000+ word posts.

​
Compatibility Mode

○ Standalone (Full Control)
○ Coexist (Suppress Overlapping Outputs)
Standalone Mode:
  • GEO AI outputs all meta tags, schema, and SEO features
  • Use when GEO AI is your only SEO plugin
Coexist Mode:
  • GEO AI detects other SEO plugins (Yoast, Rank Math, SEOPress, All in One SEO)
  • Suppresses duplicate outputs to prevent conflicts
  • Allows GEO AI to run alongside existing SEO tools
If you see duplicate meta tags in your page source, switch to Coexist mode.

​
Titles & Meta

Configure title tag and meta description templates with dynamic variables.

​
Available Variables

%%title%%         Post/page title
%%excerpt%%       Post excerpt
%%primary_cat%%   Primary category name
%%category%%      First category name
%%tag%%           First tag name

​
Template Configuration

Default: %%title%% %%sep%% %%sitename%%Example Output: “How to Install WordPress | My Site”Best Practices:
  • Keep under 60 characters for full display in SERPs
  • Place most important keywords first
  • Include branding (%%sitename%%) at the end
Default: %%title%% %%sep%% %%sitename%%Example Output: “About Us | My Site”Best Practices:
  • Similar to posts, but pages often have shorter titles
  • Consider removing %%sitename%% for landing pages
Default: %%archive_title%% %%sep%% %%sitename%%Example Output: “WordPress Category | My Site”Variables Available:
  • %%archive_title%%: Auto-generates appropriate archive title
  • %%term_name%%: Taxonomy term name
  • %%author%%: Author name for author archives
Default: Search Results for "%%searchphrase%%" %%sep%% %%sitename%%Example Output: Search Results for "wordpress seo" | My Site
Default: Page not found %%sep%% %%sitename%%Best Practice: Keep this simple and include a helpful message
Default: %%sitename%% %%sep%% %%sitedesc%%Example Output: “My WordPress Site | Just another WordPress site”Tip: Customize this for better branding on your homepage

​
Meta Description Templates

Same variables available as title templates. Defaults:
  • Post: %%excerpt%%
  • Page: %%excerpt%%
  • Archive: First 160 characters of archive description
Meta descriptions should be 150-160 characters for optimal display in search results.

​
Social Settings

Configure OpenGraph (Facebook) and Twitter Card defaults.

​
OpenGraph Defaults

1

Default OG Image

Upload a default image (1200×630px recommended) for pages without featured images.
2

Default OG Title

Leave blank to use the page title, or set a custom default.
3

Default OG Description

Leave blank to use meta description, or set a custom default.

​
Twitter Card Defaults

Card Type:
○ Summary
○ Summary with Large Image (recommended)
Twitter Site: Your site’s Twitter handle (e.g., @yoursite)
Twitter Creator: Default author Twitter handle
These defaults apply when individual posts don’t have custom social meta configured.

​
Schema Settings

Enable and configure JSON-LD structured data types.

​
Available Schema Types

Default: EnabledAutomatically adds Article schema to all posts with:
  • Headline
  • Author
  • Date published/modified
  • Featured image
  • Publisher organization
Default: DisabledEnable for posts that contain FAQ content. GEO AI will look for:
  • Heading + paragraph pairs
  • HTML <dl> lists
  • FAQ blocks
Default: DisabledEnable for tutorial/how-to posts. GEO AI extracts steps from:
  • Ordered lists
  • Step blocks
  • Headings with numbered steps
Default: DisabledEnable for product pages. Requires WooCommerce or manual product data entry.
Default: DisabledEnable for local business sites. Configure:
  • Business name
  • Address
  • Phone number
  • Opening hours
  • Service area
Default: EnabledSitewide organization schema with:
  • Name
  • Logo
  • Social profile URLs
  • Contact point
Default: EnabledEnables sitewide WebSite schema with SearchAction for sitelinks search box in Google.

​
Schema Conflict Detection

GEO AI detects when other plugins output schema and displays a warning. Check Schema Conflicts section in this tab to avoid duplicate structured data.

​
Sitemap Settings

Configure XML sitemap generation.

​
Enable Sitemaps

☑ Generate XML sitemaps
When enabled, your sitemap index is available at: 
https://yoursite.com/sitemap.xml

​
Post Types to Include

Check which post types to include: 
☑ Posts
☑ Pages
☐ Custom Post Type 1
☐ Custom Post Type 2

​
Taxonomies to Include

☑ Categories
☑ Tags
☐ Custom Taxonomy 1

​
Additional Options

☑ Add image URLs to sitemap
Pinging is optional. Search engines typically discover sitemap updates automatically via Search Console submissions.

​
Crawlers & Robots

Control which AI bots can access your content.

​
Block AI Crawlers

Select which bots to block: 
☐ PerplexityBot (Perplexity AI)
☐ GPTBot (OpenAI/ChatGPT)
☐ CCBot (Common Crawl)
☐ anthropic-ai (Anthropic/Claude)

​
Generated robots.txt Rules

When you check a bot, GEO AI generates the appropriate rules:
robots.txt
User-agent: PerplexityBot
Disallow: /

User-agent: GPTBot  
Disallow: /

User-agent: CCBot
Disallow: /

User-agent: anthropic-ai
Disallow: /
Important Caveats:
  • GEO AI does not write server files - you must manually add these rules
  • AI bots may not respect robots.txt directives
  • Blocking may reduce your visibility in AI answer engines

​
HTTP Header Snippets

For server administrators, GEO AI also displays HTTP header equivalents:
.htaccess (Apache)
SetEnvIfNoCase User-Agent "PerplexityBot" bad_bot
SetEnvIfNoCase User-Agent "GPTBot" bad_bot
Order Allow,Deny
Allow from all
Deny from env=bad_bot
nginx.conf (Nginx)
if ($http_user_agent ~* (PerplexityBot|GPTBot|CCBot|anthropic-ai)) {
    return 403;
}

​
Redirects & 404

Manage URL redirects and monitor 404 errors.

​
Redirect Manager

1

Add New Redirect

Click Add New Redirect button.
2

Enter Source URL

The old/broken URL path (e.g., /old-page)
3

Enter Destination URL

The new URL to redirect to (e.g., /new-page)
4

Choose Redirect Type

  • 301 (Permanent): For permanent moves - passes SEO value
  • 302 (Temporary): For temporary redirects - does not pass full SEO value
5

Wildcard Support

Use * for wildcard matching:
  • /blog/* → /news/* redirects all blog paths to news

​
404 Monitor

☐ Enable 404 logging
Settings:
  • Retention: Days to keep logs (default: 30)
  • Max Logs: Maximum number of entries (default: 1,000)
404 logs are stored in a custom database table (wp_geoai_404_log) and include:
  • URL requested
  • Referrer
  • IP address
  • Timestamp
404 logging is opt-in. Only enable if you need it for diagnosing broken links.

​
Bulk Editor

Coming in v1.1 - this tab is currently a placeholder.
Planned features:
  • Inline edit titles and meta descriptions for all posts
  • Filter by post type, date, category
  • CSV import/export

​
Tools

Import, export, and migration utilities.

​
Import from Other SEO Plugins

1

Select Source Plugin

Choose from:
  • Yoast SEO
  • Rank Math
  • SEOPress
  • All in One SEO
2

Preview Import

GEO AI shows what will be imported (titles, meta, redirects, etc.)
3

Run Import

Click Import to pull settings and post meta from the other plugin.
Import does not delete data from the source plugin. You must manually deactivate the old plugin after verifying the import.

​
Export Settings

[Export All Settings]
Downloads a JSON file containing:
  • All GEO AI configuration
  • Title/meta templates
  • Social defaults
  • Schema settings
  • Sitemap configuration
  • Redirects
Export settings before major updates or when migrating to a new server.

​
Import Settings

[Choose File] [Import]
Restore settings from a previously exported JSON file.

​
Clear Cache

[Clear All GEO AI Cache]
Clears cached audit results and transients.

​
Advanced Settings

Advanced configuration and debugging options.

​
Debug Mode

☐ Enable debug mode
When enabled:
  • Logs API requests/responses
  • Shows detailed error messages in editor sidebar
  • Adds debug info to browser console
  • Logs saved to wp-content/debug.log (if WP_DEBUG_LOG is enabled)
Only enable debug mode when troubleshooting. It may expose sensitive data in logs.

​
Role Capabilities

Configure which user roles can:
  • Manage GEO AI Settings: Access settings page (manage_geoai)
  • Edit SEO Meta: Edit per-post SEO fields (edit_geoai_meta)
Default: Only Administrators have these capabilities.
1

Select Role

Choose user role (Editor, Author, Contributor, etc.)
2

Grant Capabilities

Check which capabilities to grant:
  • ☐ Manage GEO AI Settings
  • ☐ Edit GEO AI Meta
3

Save Changes

Capabilities are added to the role immediately.
manage_geoai grants access to API keys. Only grant to trusted users.

​
Settings Best Practices

After Initial Configuration:
  1. Run audits on 5-10 existing posts to test
  2. Check page source for duplicate meta tags
  3. Verify sitemap loads without errors
  4. Submit sitemap to Google Search Console
  5. Monitor 404 logs for the first week if enabled
Title Template Optimization:
  • Keep templates under 60 characters total
  • Put target keywords in %%title%%, not template
  • Use | separator for better readability than -
  • Test templates with long and short post titles
Schema Strategy:
  • Enable Article schema for blogs
  • Enable FAQ/HowTo only if you regularly publish that content type
  • Test schema with Google Rich Results Test
  • Monitor Search Console for schema errors

​
Configuration Checklist

After configuring GEO AI, verify:
  • API key saved and tested
  • Compatibility mode set correctly (Standalone vs Coexist)
  • Title templates configured for all post types
  • Social defaults set (OG image, Twitter card type)
  • Schema types enabled based on content
  • Sitemap enabled and accessible at /sitemap.xml
  • Permalinks flushed (Settings → Permalinks → Save)
  • Test audit run on at least one post
  • Page source checked for duplicate meta tags
  • Sitemap submitted to Google Search Console

​
Next Steps

SEO Dashboard

Monitor site-wide AI answerability scores

Answer Card Block

Optimize content with Answer Card blocks

Schema Guide

Deep dive into structured data configuration

WP-CLI Commands

Automate audits with WP-CLI

Build docs developers (and LLMs) love

Get started for freeTalk to us