TurboCache documentation
Page cache, critical CSS, delayed JavaScript, WebP/AVIF and lazy loading for WordPress and Divi, served before WordPress loads.
TurboCache is a speed plugin for WordPress, built with Divi in mind. It stores every page as a ready-made, pre-compressed file and serves it from a small drop-in before WordPress even starts. In Full functionality mode it also optimises the page in the background: critical CSS, deferred and delayed scripts, WebP and AVIF images, lazy loading, YouTube and Vimeo facades and HTML minification.
Inside WordPress the plugin is listed as TurboCache and its menu item is TurboCache.
Where to start
- Install TurboCache and check your server meets the requirements.
- Activate your paid licence key: it unlocks the admin screens and turns the optimisation on (without an active licence TurboCache does not optimise the site).
- Run the setup wizard and watch the first optimisation on the Manage screen.
Find your way around
- TurboCache → Manage — status, statistics, cache operations, the processing queue, self-diagnostics and the HTML checker. See The Manage screen.
- TurboCache → Settings — seven tabs, each explained under Settings.
- Something not working? Start with Cache not clearing or the FAQ.
- Developers: Hooks and filters.
Getting started
- Install TurboCacheRequirements, installation and exactly what TurboCache changes in wp-config.php, wp-content and .htaccess when you activate it.
- Activate your licenceTurboCache is a premium WordPress performance plugin. What its licence unlocks, where to get a key and how to activate it.
- Setup wizard and recommended settingsWalk through the six-step TurboCache setup wizard, what each answer changes, and sensible settings for Divi, shops and shared hosting.
Settings
- The Manage screenStatus, cache statistics, revalidate and delete operations, the processing queue, self-diagnostics and the HTML checker on TurboCache → Manage.
- Basic tabThe Basic tab of TurboCache settings: functionality mode, page cache switch, setup wizard, and settings export, import and reset.
- Cache and revalidation tabCache lifetime, lazy invalidation, what updates when you edit a post, scheduled revalidation, workers, browser cache, Cloudflare and object cache.
- Exclusions and views tabExclude URLs, query arguments, cookies and user agents from the cache, and keep separate copies for mobile, old browsers, languages, countries and users.
- Scripts and styles tabDefer and delay JavaScript, critical scripts, click replay, critical CSS (automatic or manual), CSS minify and combine, and font loading in TurboCache.
- Content tabHTML minify and markup fixes, WebP/AVIF images, lazy loading, adaptive image sizes, YouTube and Vimeo facades, compatibility shims and database cleanup.
- Content groups tabOverride TurboCache settings for chosen URLs, the front page or post types, such as no delayed scripts on landing pages or no cache for a section.
- CDN and advanced tabBackground mode, test mode, debug log, Divi Visual Builder guard and conflict fix, CDN URL rewriting and the environment report in TurboCache.
Troubleshooting
- Cache not clearing or showing old contentWhy visitors still see an old page after an edit with TurboCache, how lazy invalidation works, and how to force a refresh.
- Logged-in users and adminsWhy logged-in users and administrators never see cached pages in TurboCache, and when to cache for members with per-user cache.
- WooCommerce cart and checkoutHow TurboCache keeps WooCommerce cart, checkout, account pages and mini carts working, and what to check when a cart count looks wrong.
- Conflicts with other cache plugins and hostsWhich plugins conflict with TurboCache, what to do when advanced-cache.php belongs to another plugin, and how host caches are purged.
- Layout or scripts broken after optimisationA menu, slider, form or layout misbehaves after TurboCache optimises it: test mode, critical scripts, skip lists and critical CSS fixes.
- Deactivate, uninstall and clean upWhat TurboCache removes on deactivation and on deletion: drop-ins, WP_CACHE line, .htaccess rules, cache folder, options and cron events.
- Frequently asked questionsAnswers to common TurboCache questions: pricing, licensing, cache verification, Divi, WooCommerce, CDNs, Nginx and test mode.
Developers
- Hooks and filtersEvery TurboCache action and filter with its arguments: cache bypass, dependency URLs, critical scripts, final HTML, server cache purges and more.
Guides
- UTM links and the page cacheLinks with utm_source, gclid or fbclid often skip the WordPress page cache. Why it happens, how to test it, and how to fix it without losing tracking.
- Divi mobile menu needs two tapsDelaying JavaScript boosts Divi PageSpeed scores but can make the mobile menu need two taps. Why it happens and how to fix it without losing the gain.
- YouTube facade for Divi videosA YouTube embed loads hundreds of kilobytes before anyone presses play. Use a click-to-play facade in Divi, by hand or automatically.
Did this answer the question? No — open a support request