Cache Plugin Compatibility Notices

SEOVault AI detects active WordPress cache plugins and displays compatibility notices to help you understand when cached pages might delay SEO changes from appearing on your site.

How cache detection works

The plugin automatically detects known WordPress page-cache plugins:

WP Rocket
W3 Total Cache
WP Super Cache
LiteSpeed Cache
WP Fastest Cache
Autoptimize
Hyper Cache
Cachify
Comet Cache
Swift Performance
SG Optimizer
Breeze
Hummingbird
WP-Optimize
Flying Press

Detection runs on:

Admin screens
SEO metabox screens
Sitemap screens

Notice display

When a cache plugin is detected, SEOvault AI displays a dismissible notice:

Full notice (admin screens)

Title: Cache plugin detected

Message: A cache plugin is active on your site. Cached pages may delay SEO meta and sitemap updates. If you do not see your latest changes, purge your cache (or exclude SEO/sitemap URLs from caching).

Includes: List of detected cache plugins

Compact notice (metabox screens)

Message: A cache plugin may delay when your SEO changes go live. If updates do not appear, purge your cache.

Includes: List of detected cache plugins in parentheses

Dismissal behavior

Notices are dismissible using localStorage:

Click the dismiss button (X) to hide the notice
Dismissal persists across browser sessions
Dismissal is per-user (stored in browser localStorage)
Notice reappears if a different cache plugin becomes active
Notice reappears if localStorage is cleared

Why cache plugins matter

Cache plugins store static copies of your pages to improve performance. This can cause issues with SEO changes:

Delayed SEO meta updates

When you update SEO settings:

Changes are saved to the database
Cached pages still show old meta tags
Search engines may not see updated meta until cache is purged

Delayed sitemap updates

When you update content:

Sitemap is regenerated
Cached sitemap may still show old data
Search engines may crawl outdated sitemap

Schema markup delays

When schema changes:

New schema is generated
Cached pages show old schema
Rich results may not reflect changes

Best practices

Purge cache after SEO changes

After making SEO changes, purge your cache:

WP Rocket:

Go to WP Rocket > Dashboard
Click Clear Cache

W3 Total Cache:

Go to Performance > Purge All Caches

WP Super Cache:

Go to Settings > WP Super Cache
Click Delete Cache

LiteSpeed Cache:

Go to LiteSpeed Cache > Purge
Click Purge All

Exclude SEO URLs from caching

Configure your cache plugin to exclude SEO-related URLs:

Exclude from caching:

Sitemap URLs (e.g., /sitemap.xml)
SEOvault AI API endpoints
Schema validation endpoints
Any custom SEO endpoints

WP Rocket example:

Go to WP Rocket > File Optimization
Add URLs to Never cache the following pages

W3 Total Cache example:

Go to Performance > Page Cache
Add URLs to Never cache the following pages

Enable cache purging on content updates

Configure your cache plugin to automatically purge when content changes:

WP Rocket:

Automatically purges on post updates
Enable Purge on post modification

W3 Total Cache:

Go to Performance > Page Cache
Enable Automatically purge the page cache on publish

Use cache exclusion for sitemaps

Sitemaps should never be cached:

Sitemaps change frequently
Search engines need current data
Cached sitemaps cause crawling issues

Configure exclusion:

Add /sitemap.xml to cache exclusion
Add /sitemap_index.xml to cache exclusion
Add all sitemap sub-pages to exclusion

Troubleshooting

Notice not appearing

If the notice is not showing when a cache plugin is active:

Verify the cache plugin is actually active
Check that the plugin is in the known plugins list
Clear browser localStorage
Refresh the admin page
Check for JavaScript errors in browser console

Notice not dismissing

If the notice keeps reappearing after dismissal:

Check that localStorage is enabled in your browser
Verify you’re not using private/incognito mode
Clear browser cache and cookies
Try a different browser
Check for browser extensions blocking localStorage

SEO changes not appearing

If SEO changes are not visible on the frontend:

Purge your cache
Verify the changes were saved
Check the page source for updated meta
Clear browser cache
Check for multiple cache plugins

Sitemap not updating

If the sitemap is not showing recent changes:

Purge your cache
Manually regenerate the sitemap
Verify sitemap URL is excluded from caching
Check sitemap settings
Review sitemap generation logs

Cache plugin recommendations

Choose a cache plugin with smart purging

Look for cache plugins that:

Automatically purge on content updates
Support URL-based exclusion
Provide manual purge options
Integrate with SEO plugins

Configure cache properly

Set appropriate cache expiration
Enable cache purging on updates
Exclude dynamic content from caching
Monitor cache hit rates

Test cache behavior

After configuring cache:

Test SEO updates
Verify sitemap updates
Check schema markup
Monitor search engine crawling

Known cache plugins

The following cache plugins are detected by SEOvault AI:

Plugin	Plugin File
WP Rocket	wp-rocket/wp-rocket.php
W3 Total Cache	w3-total-cache/w3-total-cache.php
WP Super Cache	wp-super-cache/wp-cache.php
LiteSpeed Cache	litespeed-cache/litespeed-cache.php
WP Fastest Cache	wp-fastest-cache/wpFastestCache.php
Autoptimize	autoptimize/autoptimize.php
Hyper Cache	hyper-cache/hyper-cache.php
Cachify	cachify/cachify.php
Comet Cache	comet-cache/comet-cache.php
Swift Performance	swift-performance/swift-performance.php
SG Optimizer	sg-cachepress/sg-cachepress.php
Breeze	breeze/breeze.php
Hummingbird	wpmu-dev-seo/wpmu-dev-seo.php
WP-Optimize	wp-optimize/wp-optimize.php
Flying Press	flying-press/flying-press.php

Adding custom cache plugins

If you use a cache plugin not in the known list, you can add it via filter:

add_filter( 'seovaultseo_known_cache_plugins', function( $plugins ) {
    $plugins['your-cache-plugin/your-cache-plugin.php'] = 'Your Cache Plugin';
    return $plugins;
} );