Troubleshoot Page Cache
Find out why a page is not cached, what each reason means and what to do, plus fixes for a full cache, an unwritable folder and a manual wp-config.php step.
If a page is not cached, UiChemy tells you why in plain words. Use Test a page on UiChemy → Performance → Page cache, the Cache menu in the admin bar, or ask your AI assistant. See Page Cache Settings.
Why a Page Is Not Cached
Most reasons need nothing from you. They protect visitors or follow a rule you set.
| Reason shown | What to do |
|---|---|
| you're logged in | Open the page in a private browser window to see what visitors get. |
| the visitor has a [cookie] cookie | Nothing. Visitors without this cookie get the cached page. |
| the address contains ?[param] | If the parameter is only for tracking, add it under Ignore tracking parameters. |
| it's a form submission | Nothing. |
| you excluded it | Remove it from Never cache these pages if it should be cached. |
| [plugin] needs it fresh | Nothing. This protects your visitors. |
| it contains a [component] | If it does not change between visitors, move it to its own page so the rest of the site stays cached. |
| a plugin asked not to cache it | Nothing. Contact the plugin's author if you think the page should be cached. |
| the page sets a cookie | Ask AI to find which plugin sets the cookie. |
| the page is marked private | Nothing, unless the page should be public. |
| the page returned an error ([status]) | Fix the error. The page is cached on the next visit. |
| it isn't a web page | Nothing. |
| it's password protected | Nothing. |
| it's a preview | Nothing. |
| it's a search results page | Nothing. |
| it's a WordPress system address | Nothing. Admin, login, REST API, AJAX and cron addresses are never cached. |
| it was requested with a different domain | If the site uses more than one domain, ask AI to check your settings. |
| the page cache is off | Turn it on in Performance → Page cache. |
| [host] handles caching | Nothing. |
| the cache folder isn't writable | Ask your host to make the folder writable by WordPress. |
| the cache is full | Ask AI to check whether unusual addresses are filling the cache. |
| it's being saved right now | Nothing. The next visit gets the cached copy. |
| this is a multisite network | Use your host's cache. |
| this isn't the page's own address | Nothing. Visitors who use the page's own address get the cached copy. |
| the page changes per visitor | If the page is the same for everyone, turn off the setting in your theme or plugin that sends this header. |
| the page changes on phones | Turn on Separate copy for mobile in Performance → Page cache. |
Common Problems
Check a Page in Your Browser
Open a page in a private window, open your browser's developer tools and look at the Network tab. UiChemy adds a response header called x-uichemy-cache to pages it handles. HIT means the saved copy was served, MISS means the page was built and saved, and BYPASS means it was skipped. If you are logged in, it always reads BYPASS, because logged-in users never get a cached page.