Compatibility Mode

GEO AI can run alongside other SEO plugins without conflicts using Compatibility Mode. This prevents duplicate meta tags, schema markup, and sitemaps.

How It Works

The compatibility system automatically detects other SEO plugins and adjusts GEO AI’s behavior to prevent overlapping outputs. File: includes/class-geoai-compat.php

Supported Plugins

Yoast SEO

Detects WPSEO_VERSION constant or WPSEO_Options class

Rank Math

Detects RANK_MATH_VERSION constant or RankMath class

SEOPress

Detects SEOPRESS_VERSION constant or SEOPress class

All in One SEO

Detects AIOSEO_VERSION constant or All_in_One_SEO_Pack class

Detection Logic

The GeoAI_Compat class runs on initialization and checks for active SEO plugins:

public function detect_conflicts() {
    $conflicts = array();

    if ( defined( 'WPSEO_VERSION' ) || class_exists( 'WPSEO_Options' ) ) {
        $conflicts[] = 'Yoast SEO';
    }

    if ( defined( 'RANK_MATH_VERSION' ) || class_exists( 'RankMath' ) ) {
        $conflicts[] = 'Rank Math';
    }

    if ( defined( 'SEOPRESS_VERSION' ) || class_exists( 'SEOPress' ) ) {
        $conflicts[] = 'SEOPress';
    }

    if ( class_exists( 'All_in_One_SEO_Pack' ) || defined( 'AIOSEO_VERSION' ) ) {
        $conflicts[] = 'All in One SEO';
    }

    return apply_filters( 'geoai_detected_conflicts', $conflicts );
}

Use the geoai_detected_conflicts filter to add detection for custom SEO plugins.

Compatibility Modes

GEO AI supports two modes:

Standalone Mode (Default)
Coexist Mode

GEO AI outputs all meta tags, schema, and sitemaps as if it’s the only SEO plugin.Use when:

GEO AI is your primary SEO plugin
No other SEO plugins are active
You want full control over SEO outputs

update_option( 'geoai_compat_mode', 'standalone' );

GEO AI suppresses its meta tag and schema outputs when other SEO plugins are detected, allowing you to use GEO AI’s AI analysis features while letting another plugin handle meta/schema.Use when:

Running GEO AI alongside Yoast/Rank Math/etc.
You want GEO AI’s AI features but existing meta from other plugin
Migrating between SEO plugins

update_option( 'geoai_compat_mode', 'coexist' );

In coexist mode, GEO AI’s meta box still appears in the editor, but meta tags won’t output on the frontend.

Configure Mode

Via Settings:

Go to Settings → GEO AI → General
Find “Compatibility Mode” dropdown
Select Standalone or Coexist
Save changes

Via Code:

// Set to coexist mode
update_option( 'geoai_compat_mode', 'coexist' );

// Set to standalone mode
update_option( 'geoai_compat_mode', 'standalone' );

Suppression Mechanism

When coexist mode is active and conflicts are detected, GEO AI removes its output hooks:

public function init_compat_mode() {
    $compat_mode = get_option( 'geoai_compat_mode', 'standalone' );

    if ( 'coexist' === $compat_mode && ! empty( $this->detected_plugins ) ) {
        // Lower priority to let other plugins output first
        add_action( 'wp_head', array( $this, 'maybe_suppress_outputs' ), 999 );
    }
}

public function maybe_suppress_outputs() {
    if ( $this->has_existing_meta_tags() ) {
        // Remove GEO AI's meta output hooks
        remove_action( 'wp_head', 
            array( \GeoAI\Core\GeoAI_Meta::get_instance(), 'output_meta_tags' ), 1 );
        remove_action( 'wp_head', 
            array( \GeoAI\Core\GeoAI_Social::get_instance(), 'output_og_tags' ), 1 );
    }
}

Suppression happens at priority 999 on wp_head to ensure other plugins output first.

What Gets Suppressed

In coexist mode, GEO AI suppresses:

Meta Tags

<title> tag (if theme doesn’t support title-tag)
Meta description
Meta keywords
Canonical URL
Robots meta (noindex, nofollow, etc.)
Viewport and charset (if enabled)

Social Tags

Schema Markup

Not currently suppressed - you should disable schema in one plugin to avoid duplicates.

Go to Settings → GEO AI → Schema and disable schema types if using another plugin’s schema.

Sitemaps

Not currently suppressed - disable sitemaps in one plugin.Most plugins use different sitemap URLs:

GEO AI: /sitemap.xml
Yoast: /sitemap_index.xml
Rank Math: /sitemap_index.xml
SEOPress: /sitemaps/posts-post-1.xml

What Still Works

Even in coexist mode, these GEO AI features remain active:

AI Analysis

Google Gemini-powered audits continue to work

Editor Sidebar

Gutenberg panel shows scores and recommendations

Analyzers

All 5 analyzers (keyword, readability, etc.) function normally

WP-CLI

Command-line audits and reports

Dashboard

SEO health dashboard and statistics

Internal Linking

Suggestions for internal links

Migration Workflow

Migrating from another SEO plugin to GEO AI:

Install GEO AI

Install and activate GEO AI while keeping your existing SEO plugin active.

Enable Coexist Mode

Go to Settings → GEO AI → General and set compatibility mode to Coexist.This prevents duplicate meta tags during migration.

Import Settings (Optional)

Go to Settings → GEO AI → Tools → Import.

Import feature is planned for v1.1. Currently, you’ll need to manually recreate settings.

Run Audits

Use GEO AI’s AI audits on your content to identify optimization opportunities.

Switch to Standalone

Once you’re ready to switch completely:

Change compatibility mode to Standalone
Deactivate the old SEO plugin
Clear cache (if using caching plugin)
Test meta tags with view-source or SEO browser extension

Programmatic Access

Check compatibility status in your code:

$compat = \GeoAI\Core\GeoAI_Compat::get_instance();

// Get list of detected plugins
$conflicts = $compat->detect_conflicts();
// Returns: array( 'Yoast SEO', 'Rank Math' )

// Check if standalone mode
if ( $compat->is_standalone_mode() ) {
    // GEO AI is the primary SEO plugin
}

// Check if meta should be output
if ( $compat->should_output_meta() ) {
    // Safe to output meta tags
}

Custom Plugin Detection

Add support for custom or niche SEO plugins:

add_filter( 'geoai_detected_conflicts', function( $conflicts ) {
    // Detect Custom SEO Plugin
    if ( defined( 'CUSTOM_SEO_VERSION' ) ) {
        $conflicts[] = 'Custom SEO Plugin';
    }
    
    // Detect another plugin by class
    if ( class_exists( 'My_SEO_Class' ) ) {
        $conflicts[] = 'My SEO Plugin';
    }
    
    return $conflicts;
});

Troubleshooting

Duplicate meta tags appearing

Symptoms: Multiple description tags, multiple og:title tags, etc.Solution:

Verify coexist mode is enabled: get_option( 'geoai_compat_mode' )
Check if plugin was detected: GeoAI_Compat::get_instance()->detect_conflicts()
Clear all caches (page cache, object cache, CDN)
View page source (not inspector) to confirm duplicates

If still duplicated, manually disable meta output:

remove_action( 'wp_head', 
    array( GeoAI\Core\GeoAI_Meta::get_instance(), 'output_meta_tags' ), 1 );

GEO AI not detecting other plugin

Symptoms: Other plugin is active but not in conflicts arraySolution:

Check if plugin loads before GEO AI (use plugins_loaded priority)
Verify the constant/class the plugin defines
Add custom detection with geoai_detected_conflicts filter
Report unknown plugin to GEO AI support

Want to use GEO AI meta with other plugin's features

Symptoms: Yoast active but want GEO AI to handle meta tagsSolution:

Keep GEO AI in standalone mode
Disable meta output in the other plugin (Yoast, etc.)
Use other plugin’s features (redirects, breadcrumbs, etc.) without meta conflict

Known Limitations

Schema suppression: Currently manual - disable in one plugin’s settings
Sitemap suppression: Not automatic - configure sitemap URLs differently
Breadcrumbs: Not suppressed - only use one plugin’s breadcrumb output
Redirects: Both plugins’ redirects will work (may cause unexpected behavior)

Best Practices

Recommendations

Use coexist mode temporarily during migration, then switch to standalone
Don’t run multiple SEO plugins long-term - choose one as primary
Test meta tags after switching modes (view-source, not DevTools)
Clear all caches when changing compatibility settings
Monitor Search Console for duplicate title/description issues
Disable unused features in both plugins to reduce overhead

API Reference

Class: `GeoAI\Core\GeoAI_Compat`

Methods:

Method	Returns	Description
`get_instance()`	`GeoAI_Compat`	Singleton instance
`detect_conflicts()`	`array`	List of detected plugin names
`init_compat_mode()`	`void`	Initialize compatibility hooks
`maybe_suppress_outputs()`	`void`	Remove meta output hooks if needed
`is_standalone_mode()`	`bool`	Check if standalone mode active
`should_output_meta()`	`bool`	Check if safe to output meta

Hooks:

// Filter detected conflicts
apply_filters( 'geoai_detected_conflicts', array $conflicts )

Installation

Install GEO AI alongside existing plugins

Settings

Configure compatibility mode

Hooks & Filters

Customize compatibility behavior

Migration Guide

Step-by-step migration from other plugins

Get Started

Core Features

Advanced

Developer Guide

Compatibility Mode

How It Works

Supported Plugins

Yoast SEO

Rank Math

SEOPress

All in One SEO

Detection Logic

Compatibility Modes

Configure Mode

Suppression Mechanism

What Gets Suppressed

What Still Works

AI Analysis

Editor Sidebar

Analyzers

WP-CLI

Dashboard

Internal Linking

Migration Workflow

Programmatic Access

Custom Plugin Detection

Troubleshooting

Known Limitations

Best Practices

Recommendations

API Reference

Class: `GeoAI\Core\GeoAI_Compat`

Installation

Settings

Hooks & Filters

Migration Guide

Build docs developers (and LLMs) love

Get Started

Core Features

Advanced

Developer Guide

​How It Works

​Supported Plugins

Yoast SEO

Rank Math

SEOPress

All in One SEO

​Detection Logic

​Compatibility Modes

​Configure Mode

​Suppression Mechanism

​What Gets Suppressed

​What Still Works

AI Analysis

Editor Sidebar

Analyzers

WP-CLI

Dashboard

Internal Linking

​Migration Workflow

​Programmatic Access

​Custom Plugin Detection

​Troubleshooting

​Known Limitations

​Best Practices

Recommendations

​API Reference

​Class: GeoAI\Core\GeoAI_Compat

​Related Resources

Installation

Settings

Hooks & Filters

Migration Guide

Build docs developers (and LLMs) love

How It Works

Supported Plugins

Detection Logic

Compatibility Modes

Configure Mode

Suppression Mechanism

What Gets Suppressed

What Still Works

Migration Workflow

Programmatic Access

Custom Plugin Detection

Troubleshooting

Known Limitations

Best Practices

API Reference

Class: `GeoAI\Core\GeoAI_Compat`

Related Resources