-
-
Notifications
You must be signed in to change notification settings - Fork 6
Home
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.
- Install the plugin from WordPress.org or GitHub
- Activate — the plugin works automatically with most setups
- 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.
| 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 |
| Topic | Description |
|---|---|
| Custom Filters | PHP filters to customize purge behavior, add URLs, change schemas, and hook custom events |
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) |
A comprehensive 7-step test that verifies both caching AND purging work correctly — no more guessing based on header detection.
Optional tag-based purging for more efficient cache invalidation on complex sites. Learn more →
When DISABLE_WP_CRON is enabled, purge requests are queued and processed via WP-Cron instead of during page loads. Learn more →
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 statusThis 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
- Accelerate WordPress with Varnish Cache — Tutorial from GetPageSpeed
- Varnish Cache Official Documentation
- Plugin on WordPress.org
- GitHub Repository
- Run the End-to-End Cache Test — Proxy Cache → Check Caching → Run Full Cache Test
- Check Troubleshooting — solutions to common problems
- Open a GitHub Issue — include test results and server details
💚 Maintained by GetPageSpeed
This plugin is actively maintained. Contributions welcome!
📖 Documentation · 🔧 Troubleshooting · 🐛 Report Issue · 💚 GetPageSpeed