General Troubleshooting Guide For LSCWP

Here are a few common issues and how to deal with them. Please follow these steps first before logging any ticket with us since your issue might have been resolved.

Our LSWCP plugin has been developed at a very fast pace. Some compatibility issue with other plugins/or break message may have already been fixed in the latest version. You should always upgrade to the latest version and advice us which LSWCP you are using.

Please check out image optimization guide first to resove your issue.

This problem is caused when using multiple web applications under a single domain. You can find more information on this issue and how to resolve it in our Handling Logged-in Cookie Conflicts page.

Scheduled Posts are published in WordPress through a WP cron job. Normally, WordPress triggers the cron job each time a request hits the backend. The backend is rarely hit, however, when using a cache, which causes scheduled posts to publish late.

LSCWP will correctly purge the cache when a scheduled post is published in the cron job. All you need to do is make sure that you can reliably hit the backend. This can be done by scheduling a cron job to hit wp-cron.php at your ideal interval.

For Example, to update scheduled posts every 15 minutes:

*/15 * * * * wget http://your_wp_site/wp-cron.php

When using a server level cron job, WordPress suggests defining DISABLE_WP_CRON in your wp-config file to disable checking wp-cron on a backend hit.

define('DISABLE_WP_CRON', true);

This may be useful in reducing the number of calls made to wp-cron if that is desired.

For a more in-depth discussion of this issue, see our blog.

Most likely, this is not an LSCache issue, since LSCWP doesn't cache static files.

If your theme's CSS is not properly loaded after an update, check your browser cache. Does the reload work? Do you have a CDN or a reverse proxy in front of your webserver, such as CloudFlare? These caching mechanisms may need to be purged. See this forum post for more details.

If you generate a sitemap but notice that the crawler Size is still 1 or 2, you can try the following steps to debug the issue.

1. Verify that the sitemap URL works.
2. Verify that the URLs within the sitemap are available for public visit.
   1. If the URLs are only private, that can cause a sitemap generation issue.
3. Verify /wp-content/plugins/litespeed-cache/var/crawlermap*.data exists.
   1. If it doesn't exist, there may be a permission issue with one of the directories in the path.
4. Verify that the environment home_url is identical to the home URL in Step 2. Keep in mind that http://example.com/test.html and https://example.com/test.html are different!
   1. Fix by changing LiteSpeed Cache > Settings > General > Site Address (URL) to match the value in the sitemap.

If someday you encounter a problem that requires support, we may ask to see your Environment Report. The Environment Report tells us what settings you have enabled, what other plugins you have installed, and the contents of your .htaccess file, among other useful things.

To generate and share your Environment Report, navigate to LiteSpeed Cache > Environment Report. Press the “Send to LiteSpeed” button. Check here for details about such report.