Skip to content

Cache Plugin Configuration

CastConductor's REST API endpoints must be excluded from WordPress caching plugins to ensure real-time content updates.

Critical: Cache Exclusions Required

If you're using a caching plugin, you must add CastConductor API exclusions or:

  • Content Blocks won't update in the Canvas editor
  • Scenes and Containers won't reflect changes on Stage
  • Roku devices will display stale or missing content

Exclusion Patterns

Add these URL patterns to your cache plugin's exclusion list:

/castconductor/v5/
/castconductor/v5/*

Or as regex patterns:

/castconductor/v5/.*
^/castconductor/v5/$

Plugin-Specific Instructions

LiteSpeed Cache

  1. Go to LiteSpeed Cache → Cache → Excludes
  2. In the Do Not Cache URIs field, add: 
    /castconductor/v5/
  3. Click Save Changes
  4. Go to LiteSpeed Cache → Toolbox → Purge and click Purge All

LiteSpeed Exclusion

WP Super Cache

  1. Go to Settings → WP Super Cache → Advanced
  2. Scroll to Accepted Filenames & Rejected URIs
  3. In the Rejected URIs section, add: 
    castconductor
  4. Click Save Rules

W3 Total Cache

  1. Go to Performance → Page Cache
  2. Scroll to Advanced section
  3. In Never cache the following pages, add: 
    /castconductor/v5/.*
  4. Click Save all settings
  5. Go to Performance → Dashboard and click Empty All Caches

WP Rocket

  1. Go to Settings → WP Rocket → Advanced Rules
  2. In the Never Cache URLs field, add: 
    /castconductor/v5/(.*)
  3. Click Save Changes
  4. Clear the cache

Cloudflare

If using Cloudflare's caching:

  1. Log into your Cloudflare dashboard
  2. Go to Rules → Page Rules
  3. Create a new rule:
  4. URL: yourdomain.com/castconductor/v5/*
  5. Setting: Cache Level = Bypass
  6. Save and deploy

Redis Object Cache / Memcached

Object caching plugins generally don't interfere with REST API responses, but if you experience issues:

  1. Ensure your object cache plugin is up to date
  2. Check that transients are being stored correctly
  3. Consider adding CASTCONDUCTOR_DISABLE_CACHE to wp-config.php: 
    define('CASTCONDUCTOR_DISABLE_CACHE', true);

Verifying Exclusions Work

After configuring exclusions:

  1. Go to CastConductor → Content Blocks
  2. Edit any Content Block and make a visible change
  3. Save and check the Canvas preview
  4. Verify the change appears immediately

If changes are delayed or not appearing:

  • Clear all caches manually
  • Check browser cache (try incognito mode)
  • Verify exclusion patterns are saved correctly
  • Check server-level caching (Varnish, nginx fastcgi_cache)

Server-Level Caching

If you have server-level caching (common on managed WordPress hosts like WP Engine, Kinsta, Flywheel):

Nginx FastCGI Cache

Add to your nginx configuration:

# Exclude CastConductor API from cache
location ~ ^/castconductor/v5/ {
    fastcgi_cache_bypass 1;
    fastcgi_no_cache 1;
}

Varnish

Add to your VCL:

if (req.url ~ "^/castconductor/v5/") {
    return (pass);
}

Still Having Issues?

Contact [email protected] with:

  • Your caching plugin name and version
  • WordPress version
  • Screenshots of your exclusion settings
  • Browser network tab showing the API request/response