Performance Optimisation Documentation

Everything about running the Bolt performance plugin — setup, features, configuration and troubleshooting.

Performance Optimisation is an engineering-first WordPress speed plugin: an advanced-cache.php page-cache drop-in with preload and targeted purge, an optional Redis object-cache.php drop-in, stream-read minifiers for CSS, JS, and HTML, script defer/delay, used-CSS generation, WebP/AVIF conversion, and scheduled database cleanup. Every layer reports its effect — Server-Timing headers, a RUM beacon, and a PageSpeed Insights screen.

Requirements

ComponentVersion
WordPress6.2 or newer (tested up to 7.1)
PHP8.2 or newer
RedisOptional — required only for the object-cache drop-in

Quick start

  1. Download the release ZIP from GitHub and activate the plugin under Plugins.
  2. Enable page caching in the plugin settings.
  3. If you run Redis, verify the connection with wp wppo object_cache ping.
  4. Enable CSS/JS minification and script delay.
  5. Warm the static cache with wp wppo cache preload.

Docs target

These pages document Performance Optimisation 1.9.0.

Where to go next

  • Installation — requirements, upload steps, and what activation writes to disk.
  • Features — what each module does and when to switch it on.
  • Configuration — settings storage, filter hooks, and the WP-CLI command set.
  • FAQ — purge behavior, broken styles, Redis questions, and reporting bugs.