How the page cache is working ?


This page is talking about the cache management of a page.

A page is composed of slot (a primary and one or more secondary) and each slot rendering goes into the cache until:

Expiration Date

You can set the expiration date of a page with two methods:

Expiration Frequency

If you need to delete the page cache at interval because your page contains time-based data, you can use the page cache expiration frequency.

Cache time interval

The cache time interval is a standard dokuwiki application configuration that sets a maximum age for the cache file.

If the interval has expired since the last creation date of the cache, the cache has expired and there is a cache miss.

You can read more on the Dokuwiki dedicated page.


In the cache viewer, you can see all cache hit or miss for the slots.

For each slot, you can see the cache:

  • for the parsing instructions (the parse tree)
  • for the html page
  • for the metadata

After 2 rendering, you should see only cache hits.

  • the first rendering will do the initial work
  • the second one should be only cache hit

If the second request does not hit the cache, this is because a metadata may have been set by a third party plugin.

Support and Configuration


The useheading dokuwiki configuration has an impact on cache management, you should set disable it and set the value never. More information on the dedicated page of this configuration

Powered by ComboStrap