Is this really the version you are looking for? Kentico 8 documentation is no longer updated. Use the switch in the header to choose your Kentico version.

Configuring caching

Cache is a storage space that duplicates previously requested data, and allows faster access to the data in the future. Correctly using caching can significantly improve the performance of your website.

Caching the content of web pages provides two primary benefits:

  • Quicker loading of data (retrieving data from the cache avoids communication with slower storage spaces, such as the website's SQL database and file system)
  • Reduction of unnecessary page processing on repeated requests

The built-in caching mechanisms of Kentico work primarily on the server side, and utilize the application's memory to store data. The system saves data into the cache in the form of cache keys. Cache keys have unique names that exactly identify the cached content. Each key stores the cached data itself (depending on the type of the cache), as well as other information such as the expiration time or dependencies.

Cache types

Kentico provides the following types of caching:

  • Output cache (full page) - caches the full HTML output of pages.
  • Content cache - stores structured data loaded by web parts and controls (for data sources, repeaters, etc.).
  • Page info cache - stores basic information about pages (documents).
  • Custom code cache - allows developers to cache data used in custom code.

You can also configure IIS Output caching for your web application. IIS Output caching is completely separate from the caching mechanisms in Kentico. When clients request a page whose valid output is cached on the IIS level, the server returns the response without requiring any processing from the Kentico application.

Note: Kentico only supports the User-mode policy for IIS output caching. You cannot use Kernel-mode caching.

The following diagram shows the order in which the cache types are checked when handling requests (from top to bottom). If the required content is found in one of the cache layers, the system stops processing the request and sends the response without executing the page code or accessing the database. The cache types shown at the top of the diagram provide the best performance — the page response time and processing costs increase as the request progresses through the cache layers.

Cache types available in Kentico

On this page

In this section

Page info caching

When a visitor requests an uncached page, the system queries the database for basic information about the page, including the following:

  • alias path
  • ID and name
  • document metadata and other properties
  • SKU information (for products)
  • workflow information

The Page info cache stores the retrieved information in the application's memory, which allows quicker access on subsequent requests. The system reuses the information multiple times during the processing of a single page, so page info caching is an important factor in the website's performance. Page info caching cannot cause sites to display outdated information. The system automatically clears the cache for pages that are modified.

You can change the expiration time of the page info cache:

  1. Open the Settings application.
  2. Expand the System -> Performance category.
  3. Type a number of minutes into the Cache page info (minutes) setting. Do NOT set the value lower than 10 minutes.
  4. Save the settings.

When a user requests a page, the basic information stays in the cache for the specified number of minutes, or until someone modifies the related document.

Tip: You can view the cache keys that store page info through the cache debugging interface. The names of page info cache keys begin with pageinfo or pageinfobyurl.

Clearing the cache

To delete all data from the application's cache:

  1. Open the System application.
  2. On the General tab, click Clear cache.

The system removes all cached content managed by Kentico.