Please Note: This wiki is valid for v2.9.x and below of the LiteSpeed Cache Plugin for WordPress. If you are using v3.0 or above, please see the new documentation.

Installing & Enabling The LSCache Plugin For WordPress

There are two ways to use LSCWP:

  1. Without a LiteSpeed server, and with limited functionality (optimization features only, no cache)
  2. With a LiteSpeed Web Server + LSCache license, and with full functionality (optimization and cache features)

If you are not currently running a LiteSpeed Web Server with LSCache enabled, but you would like to use the caching features of the WordPress plugin, please contact your hosting provider. Ask them to switch you to LiteSpeed Web Server!

  • Simply install and activate the plugin through the WordPress Admin interface.
  • Navigate to LiteSpeed Cache > Settings and click Advanced View to see all the tabs.
  • Have fun playing with the options! Tab-by-tab instructions are here, if you need them.

Pre-Installation Requirements

  • LiteSpeed Web Server Enterprise Edition 5.0.10+.
  • LSCache Module. (Included with a Free Starter, Site Owner, and Web Host license, as well as an 8-CPU legacy license. Can be purchased as an add-on for VPS, Ultra VPS, and 1-CPU legacy licenses.)
  • Disable other full-page caches plugin if used (such as WP Super Cache, W3 Total Cache, WP Rocket, WP Fastest Cache etc.)


  1. Configure server-level and/or virtual-host-level cache root and cache policy by selecting your setup in the Web Server Configuration section of the LiteSpeed Web Cache Common Installation Guide.
  2. Disable any other page caches as these will interfere with LSCWP.*
  3. Download the LSCWP plugin from our WordPress Plugin Directory page.
  4. Log in to your WordPress Dashboard, navigate to Plugins > Add New and click on Upload Plugin.
  5. Select the LSCWP zip file and click Install Now. Activate the plugin.
  6. Navigate to LiteSpeed Cache > Settings > General and set Enable LiteSpeed Cache to Enable.

You may also install the plugin directly from the Plugins > Add New screen. Replace steps 3-5 above with:

  • Search for LiteSpeed Cache in the search box. Our plugin should be the first search result to come up.
  • Press Install Now. Activate the plugin.

* Please see this wiki article for assistance using multiple optimization plugins at once.


You can verify a page is being served from LSCWP through the following steps:

  1. Open the developer tools on a non-logged-in browser and navigate to your site. Open the Network tab.
  2. Refresh the page.
  3. Click the first resource (this should be an HTML file and the resource's headers should appear as in the image below). For example, if your page is, your first resource should either be something like or wordpress/.
  4. In a different, logged-in browser, in your WordPress Dashboard, navigate to LiteSpeed Cache > Manage and click the Purge All button.
  5. Reload the page in the first (non-logged-in) browser and select the same resource again. If you see headings similar to
    X-LiteSpeed-Cache: miss

    (for example), this means the page had not yet been cached, but that LiteSpeed has now stored it for future use.

  6. Reload the page a second time and you should see X-LiteSpeed-Cache: hit in the response header. This means the page is being served by the cache and LSCWP is configured correctly.

Note: If your first refresh after purging returns X-LiteSpeed-Cache: hit in the response header, this may be because someone else visited the page after you purged but before you refreshed it yourself. Try again from step 4.

Good to Know

Here are a few other things that may may be useful for your installation.

Turning On the WordPress Debug Log

To enable the WordPress debug log, modify wp-config.php under WordPress' root directory as follows:

  1. Set WP_DEBUG to true.

  2. Add the following:


A debug.log file will be generated under the wp-content directory, and will log information whenever WordPress hits the backend.

You can monitor this log during debugging using the following command:

tail -f wp-content/debug.log

Multiple LiteSpeed Cache Plugins

If you are using any of our other LiteSpeed Cache plugins for other web apps (like Magento, PrestaShop, XenForo, etc), or you are running multiple instances of WordPress, please see this article for some important information about avoiding conflicts between the different apps' caches.

WordPress Lacks Permissions

If WordPress doesn't have access to create tables in your database, please run these SQL queries manually after installation:

CREATE TABLE IF NOT EXISTS wp_litespeed_optimizer (
hash_name VARCHAR(60) NOT NULL COMMENT “hash.filetype”,
src text NOT NULL COMMENT “FULL url array SET,
dateline INT(11) NOT NULL,
refer VARCHAR(255) NOT NULL COMMENT “The container page url”,
UNIQUE KEY hash_name (hash_name),
KEY dateline (dateline)


CREATE TABLE IF NOT EXISTS `wp_litespeed_img_optm` (
  `optm_status` VARCHAR(64) NOT NULL DEFAULT '',
  `src` VARCHAR(1000) NOT NULL DEFAULT '',
  `srcpath_md5` VARCHAR(128) NOT NULL DEFAULT '',
  `src_md5` VARCHAR(128) NOT NULL DEFAULT '',
  `server` VARCHAR(255) NOT NULL DEFAULT '',
  `root_id` INT(11) NOT NULL DEFAULT '0',
  `src_filesize` INT(11) NOT NULL DEFAULT '0',
  `target_filesize` INT(11) NOT NULL DEFAULT '0',
  `target_saved` INT(11) NOT NULL DEFAULT '0',
  `webp_filesize` INT(11) NOT NULL DEFAULT '0',
  `webp_saved` INT(11) NOT NULL DEFAULT '0',
  PRIMARY KEY (`id`),
  UNIQUE KEY `post_id_2` (`post_id`,`srcpath_md5`),
  KEY `post_id` (`post_id`),
  KEY `optm_status` (`optm_status`),
  KEY `root_id` (`root_id`),
  KEY `src_md5` (`src_md5`),
  KEY `srcpath_md5` (`srcpath_md5`)

Note: If your site uses a table prefix other than wp_, please replace the wp_ in wp_litespeed_optimizer with your site's prefix.

  • Admin
  • Last modified: 2020/05/04 13:33
  • by Shivam Saluja