Skip to content
Danila Vershinin edited this page Dec 20, 2025 · 7 revisions

Proxy Cache Purge

Automatically purge cached content when your WordPress site is modified.

Proxy Cache Purge sends PURGE requests to your caching layer (Varnish, Nginx, etc.) whenever content changes — whether you're editing posts, publishing new content, moderating comments, or updating themes and plugins.


🚀 Quick Start

  1. Install the plugin from WordPress.org or GitHub
  2. Activate — the plugin works automatically with most setups
  3. Verify it works — go to Proxy Cache → Check Caching and run the End-to-End Cache Test

That's it! For most configurations, no additional setup is required.


📖 Documentation

Getting Started

Topic Description
Troubleshooting Common issues and solutions, including the End-to-End Cache Test
Varnish Configuration Varnish-specific setup, Cache Tags, background purging, and debugging

Customization

Topic Description
Custom Filters PHP filters to customize purge behavior, add URLs, change schemas, and hook custom events

Sample VCL Configurations

Ready-to-use VCL snippets for Varnish (provided as-is, unsupported):

VCL File Purpose
Sample VCLs Overview Index of all sample configurations
default.vcl Main Varnish configuration file
purge.vcl PURGE request handling
cloudflare.vcl Cloudflare integration
xforward.vcl X-Forwarded-For header handling
static.vcl Static file caching rules
bigfiles_pipe.vcl Large file handling (pipe mode)

✨ Key Features

End-to-End Cache Test (New in 5.5.3)

A comprehensive 7-step test that verifies both caching AND purging work correctly — no more guessing based on header detection.

Cache Tags / Surrogate Keys (Beta)

Optional tag-based purging for more efficient cache invalidation on complex sites. Learn more →

Background Purging

When DISABLE_WP_CRON is enabled, purge requests are queued and processed via WP-Cron instead of during page loads. Learn more →

WP-CLI Support

Full command-line control over purging:

wp varnish purge                    # Purge entire cache
wp varnish purge https://site.com/  # Purge specific URL
wp varnish purge --tag=p-123        # Purge by cache tag
wp varnish status                   # Check plugin status

🔧 Tested Configurations

This plugin has been tested with:

  • ✅ Varnish 3.x, 6.x, 7.x
  • ✅ Nginx FastCGI Cache
  • ✅ Varnish + Nginx (as TLS terminator)
  • ✅ Varnish + Hitch (as TLS terminator)
  • ✅ All of the above behind Cloudflare

📚 External Resources


🆘 Getting Help

  1. Run the End-to-End Cache Test — Proxy Cache → Check Caching → Run Full Cache Test
  2. Check Troubleshooting — solutions to common problems
  3. Open a GitHub Issue — include test results and server details

💚 Maintained by GetPageSpeed

This plugin is actively maintained. Contributions welcome!

Clone this wiki locally