🚀 WP Super Cache Configuration Guide

Professional NGINX Server Configuration & Optimization

📑 Table of Contents

1. Introduction to WP Super Cache

WP Super Cache is a powerful, free WordPress plugin that significantly improves website performance through advanced page caching mechanisms. It generates static HTML files from dynamic WordPress pages and serves these pre-generated files to visitors, dramatically reducing server load and improving response times.

🎯 Key Benefits:
  • Reduces server processing load by up to 90%
  • Improves page load times significantly
  • Handles high traffic volumes efficiently
  • Free and actively maintained
  • Compatible with most WordPress configurations

WP Super Cache Architecture

User Request
→
NGINX Server
→
Check Cache
→
Serve Static HTML
(or generate if missing)

2. How WP Super Cache Works

WP Super Cache operates by leveraging NGINX's try_files directive to optimize content delivery. The system follows a sophisticated request processing flow:

Request Processing Flow

1. NGINX receives request
↓
2. Check cache exclusion rules
↓
3. If cacheable: Look for static HTML file
↓
4a. File exists → Serve immediately
4b. File missing → Process via PHP-FPM

Caching Mechanism Details

Component Function Purpose
Static HTML Generation Creates HTML files from PHP Eliminates PHP processing overhead
Try Files Directive Checks for cached files first Serves cached content instantly
Cache Exclusions Defines non-cacheable content Ensures dynamic content remains fresh
Garbage Collection Removes expired cache files Manages disk space and content freshness

3. Prerequisites

⚠️ Important: Before proceeding with WP Super Cache installation, ensure your system meets the following requirements:
  • NGINX web server properly configured and running
  • PHP-FPM (PHP 8.1 or higher recommended)
  • WordPress installation with admin access
  • Root or sudo access to the server
  • Basic understanding of Linux commands and NGINX configuration
📝 Recommended Actions Before Installation:
  • Update all WordPress plugins and themes
  • Create a full backup of your website
  • Document your current NGINX configuration
  • Test your site functionality in a staging environment if possible

4. Server Configuration

Server-side configuration is crucial for WP Super Cache to function correctly. This involves creating cache exclusion rules and modifying NGINX configuration files.

Step 1: Create Cache Exclusions File

1 Navigate to NGINX includes directory
cd /etc/nginx/includes/
2 Create the exclusions configuration file
sudo nano wp_super_cache_excludes.conf
3 Add the following configuration
# WP Super Cache NGINX Cache Exclusions Rules set $cache_uri $request_uri; # POST requests and urls with a query string should always go to PHP if ($request_method = POST) { set $cache_uri 'null cache'; } if ($query_string != "") { set $cache_uri 'null cache'; } # Don't cache uris containing the following segments if ($request_uri ~* "(/wp-admin/|/xmlrpc.php|/wp-(app|cron|login|register|mail).php|wp-.*.php|/feed/|index.php|wp-comments-popup.php|wp-links-opml.php|wp-locations.php|sitemap(_index)?.xml|[a-z0-9_-]+-sitemap([0-9]+)?.xml)") { set $cache_uri 'null cache'; } # Don't use the cache for logged in users or recent commenters if ($http_cookie ~* "comment_author|wordpress_[a-f0-9]+|wp-postpass|wordpress_logged_in") { set $cache_uri 'null cache'; } # Use cached or actual file if they exists, otherwise pass request to WordPress location / { try_files /wp-content/cache/supercache/$http_host/$cache_uri/index-https.html $uri $uri/ /index.php?$args; }
💡 Understanding Cache Exclusions:
  • POST requests: Always processed dynamically (form submissions, etc.)
  • Query strings: URLs with parameters bypass cache for dynamic content
  • Admin areas: WordPress admin panel never cached
  • Logged-in users: Personalized content isn't cached
  • Feeds and special pages: XML feeds and sitemaps handled specially

Step 2: Verify File Path

readlink -f wp_super_cache_excludes.conf

Copy the full path for use in the next step. This ensures you reference the correct file location in your NGINX configuration.

Step 3: Modify Site Server Block

1 Navigate to sites-available directory
cd /etc/nginx/sites-available/
2 Open your site's configuration file (replace example.com with your domain)
sudo nano example.com.conf
3 Add the include directive above the PHP processing block
include /etc/nginx/includes/wp_super_cache_excludes.conf;
⚠️ Critical Configuration Note: You must comment out or remove the existing location / block in your server configuration to avoid conflicts. NGINX does not allow duplicate location contexts in the same server block. The cache exclusions file already contains the necessary location block.
4 Comment out the existing location / block
# location / { # try_files $uri $uri/ /index.php$is_args$args; # }

Step 4: Test and Reload NGINX

1 Test NGINX configuration syntax
sudo nginx -t
✅ Expected Output:
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
2 Reload NGINX to apply changes
sudo systemctl reload nginx

Server Configuration Workflow

Create Exclusions File
→
Include in Server Block
→
Remove Duplicate Directives
→
Test Configuration
→
Reload NGINX

5. Plugin Installation & Setup

With the server configuration complete, you can now install and configure the WP Super Cache plugin through the WordPress dashboard.

Installation Process

1 Access WordPress Dashboard

Log in to your WordPress admin panel at https://example.com/wp-admin

2 Navigate to Plugins → Add New
3 Search for "WP Super Cache"
4 Click "Install Now" and then "Activate"

Basic Configuration

1 Navigate to Settings → WP Super Cache
2 Enable Caching
  • Select "Caching On (Recommended)"
  • Click "Update Status"
⚠️ Expected Warning: You may see a warning that "The WordPress cron job system is disabled." This is normal if you've configured server-side cron jobs (recommended). The garbage collection will still function properly through your server cron.
3 Test Cache Functionality

Scroll down and click "Test Cache" button. You should see:

✅ Success Message: "The timestamps on both pages match! Your cache is working properly."

6. Advanced Settings Configuration

Advanced Tab Settings

1 Navigate to the Advanced tab

Cache Delivery Method

Set cache delivery method to "Expert". This mode uses mod_rewrite (or in our case, NGINX rewrite rules) to serve cached files with maximum efficiency.

Miscellaneous Settings

Setting Recommendation Purpose
Don't cache pages with GET parameters ✅ Enable Pages with query strings contain dynamic content and should not be cached
Compress pages ✅ Enable Serves compressed pages to reduce bandwidth and improve load times
304 browser caching ✅ Enable Leverages browser caching by sending 304 Not Modified responses when appropriate
Clear all cache files when post/page updated ✅ Enable Ensures visitors see the latest content after updates
💡 Understanding 304 Browser Caching:

The 304 Not Modified status code is part of HTTP caching mechanisms. When enabled, the server checks if the page has changed since the browser last requested it. If unchanged, a 304 response is sent, allowing the browser to use its cached version, significantly reducing data transfer and improving performance.

2 Click "Update Status" to save changes

Expiry Time & Garbage Collection

Garbage collection is an essential process that cleans up old and expired cache files, preventing the cache directory from growing indefinitely and ensuring visitors receive up-to-date content.

📊 Garbage Collection Parameters:
  • Cache Timeout: Duration for which a cached file remains valid before regeneration
  • Scheduler: Automates cache regeneration and deletion on a predefined schedule
  • Timer: Sets frequency for garbage collection runs

Default Settings: The default expiry and garbage collection settings are suitable for most websites. Only customize these values if your site has specific requirements.

Rejected URL Strings

Use this section to specify URLs that should never be cached. Common examples include:

  • E-commerce checkout pages
  • User account pages
  • Shopping cart pages
  • Dynamic API endpoints

Preload Configuration

1 Navigate to the Preload tab

Preload mode is a powerful feature that pre-caches all published posts and pages, ensuring even first-time visitors and search engine bots receive fast-loading pages.

2 Enable Preload Mode
  • Check "Enable preload mode"
  • Check "Preload tags, categories and other taxonomies"
  • Set refresh interval (600 minutes recommended)
  • Click "Save Settings"
✅ Preload Benefits:
  • All pages cached before user requests
  • Consistent performance for all visitors
  • Better SEO as search engines encounter fast pages
  • Reduced server load during traffic spikes

Debug Tab

1 Navigate to Debug tab
2 Enable "Cache Status Messages"

This adds HTML comments to page source showing cache status, generation time, and compression method—useful for verification and troubleshooting.

3 Click "Save Settings"

7. Verification & Testing

After configuration, it's important to verify that WP Super Cache is functioning correctly.

Test Method 1: View Page Source

1 Open your website in an incognito/private browser window

This ensures you're not logged in, as cached pages are not served to authenticated users.

2 Right-click on the page and select "View Page Source"
3 Scroll to the bottom of the source code
✅ Expected Comments (indicating successful caching):

Test Method 2: Logged-In User Check

1 Open your site in a normal browser window (while logged in)
2 View page source
💡 Expected Behavior: The page should NOT show caching comments. This confirms that logged-in users receive dynamic, uncached content with personalized features.

Performance Verification

You can measure the performance improvement using tools such as:

Tool URL Focus
GTmetrix gtmetrix.com Overall performance, page speed metrics
Google PageSpeed Insights pagespeed.web.dev Core Web Vitals, mobile/desktop performance
WebPageTest webpagetest.org Detailed waterfall analysis, TTFB
Pingdom tools.pingdom.com Load time from multiple locations

8. Complete Uninstallation Process

If WP Super Cache doesn't meet your requirements or you want to try a different caching solution, follow this complete uninstallation procedure to ensure no residual configuration remains.

⚠️ Important: Follow these steps in order to avoid configuration conflicts or site errors.

Step 1: Disable Caching in WordPress

1 Navigate to Settings → WP Super Cache
2 Select "Caching Off"
3 Click "Update Status"

Step 2: Clear All Cache Files

1 Click "Delete Cache" button

This removes all cached HTML files from your server, ensuring a clean slate.

Step 3: Deactivate and Delete Plugin

1 Navigate to Plugins → Installed Plugins
2 Deactivate WP Super Cache
3 (Optional) Delete the plugin completely

Step 4: Server Configuration Cleanup

1 Navigate to sites-available directory
cd /etc/nginx/sites-available/
2 Open your site's configuration file
sudo nano example.com.conf
3 Remove the WP Super Cache include directive

Delete or comment out this line:

# include /etc/nginx/includes/wp_super_cache_excludes.conf;
4 Uncomment the default location block
location / { try_files $uri $uri/ /index.php$is_args$args; }
5 Save and exit nano (Ctrl+X, then Y, then Enter)

Step 5: (Optional) Remove Exclusions File

1 Navigate to includes directory
cd /etc/nginx/includes/
2 Delete the exclusions file (or keep for future use)
sudo rm wp_super_cache_excludes.conf
💡 Tip: Consider keeping the exclusions file if you plan to use WP Super Cache with other sites on the same server. You can always delete it later if not needed.

Step 6: Test and Reload NGINX

1 Test NGINX configuration
sudo nginx -t
2 Reload NGINX to apply changes
sudo systemctl reload nginx
✅ Uninstallation Complete! Your site is now running without WP Super Cache. All server configurations have been reverted to their original state.

Uninstallation Workflow

1. Disable caching in WordPress
↓
2. Clear all cache files
↓
3. Deactivate/delete plugin
↓
4. Remove NGINX include directive
↓
5. Restore default location block
↓
6. Test and reload NGINX

9. Best Practices & Recommendations

Maintenance Schedule

Frequency Task Purpose
Daily Monitor error logs Identify caching issues early
Weekly Check cache statistics Verify optimal cache hit ratio
Monthly Review cache exclusions Ensure appropriate pages are cached
After major updates Clear cache completely Prevent serving outdated cached content

Performance Optimization Tips

🚀 Pro Tips:
  • Combine with CDN: Use WP Super Cache alongside a CDN for optimal global performance
  • Image optimization: Use separate plugins for image compression and lazy loading
  • Minification: Consider additional plugins for CSS/JS minification
  • Database optimization: Regularly clean and optimize your WordPress database
  • Monitor server resources: Ensure adequate memory and CPU for PHP-FPM

Troubleshooting Common Issues

Issue Cause Solution
Cache not working Configuration mismatch Verify NGINX configuration and reload
Stale content Cache not clearing Manually clear cache and check garbage collection
500 Internal Server Error Duplicate location blocks Check for duplicate directives in NGINX config
Logged-in users see cached pages Cookie exclusion not working Verify cache exclusions configuration

When to Use WP Super Cache

✅ Ideal for:
  • Content-heavy blogs and news sites
  • Static WordPress sites with minimal user interaction
  • Sites with high traffic but mostly anonymous visitors
  • Shared hosting environments with limited resources
⚠️ Consider alternatives for:
  • E-commerce sites with dynamic pricing
  • Membership sites with personalized content
  • Sites requiring real-time updates
  • Complex web applications

10. Conclusion

WP Super Cache is a powerful, free caching solution that can dramatically improve WordPress site performance through efficient static HTML generation and NGINX-based delivery. When properly configured with NGINX, it provides excellent performance benefits for static and content-focused WordPress sites.

The key to success with WP Super Cache lies in proper server configuration, appropriate cache exclusions, and regular maintenance. By following this guide, you've established a solid foundation for high-performance WordPress hosting.

📚 Remember:
  • Always test configuration changes before deploying to production
  • Monitor cache performance regularly
  • Clear cache after significant content updates
  • Keep WordPress, plugins, and themes updated
  • Consider your site's specific needs when configuring cache settings

As WP Super Cache focuses solely on page caching, you may need additional plugins for comprehensive optimization covering CSS/JavaScript minification, image optimization, and database cleanup. However, for its primary purpose—delivering cached pages efficiently—WP Super Cache excels as a lightweight, reliable solution.