WordPress Pantheon Cache Plugin Configuration

Optimize WordPress and Varnish caching to maximize your site's performance.

Discuss in our Forum Discuss in Slack

Pantheon maintains an optimized version of WordPress that includes a plugin to control cache expiration. By default, pages will expire from the Varnish Edge Cache after 10 minutes (600 seconds). The plugin sets a default HTTP header: Cache-Control: public, max-age=600

You can clear the site cache using the Clear Cache button. If you want to automatically clear cached pages when content is updated, refer to the Pantheon Advanced Page Cache.

To increase the chances that a visitor will request a cached page, you can increase the default time to live value, which will reduce page load times.

You can also enable maintenance mode for others while working on your site.

Pantheon Page Cache Plugin Configuration

  1. Log in to your WordPress site as an administrator.

  2. Click Settings.

  3. Click Pantheon Cache. You'll end up at: /wp-admin/options-general.php?page=pantheon-cache

  4. Modify the Default Cache Time. You'll want to strike a balance between freshness of content and speed. We recommend a minimum of 600 seconds. If you can increase the setting to 30 minutes (1800 seconds) or 1 hour (3600 seconds), many more requests will hit the Edge Cache. Every page served from the Edge Cache won't hit your application container's PHP workers or MySQL database, which means faster page load times and a better user experience for site visitors.

  5. Modify the Maintenance Mode. A simple notice will be displayed to users who request a page that is not already cached. Briefly unavailable for scheduled maintenance. Check back in a minute.

  6. Click Save Changes.

WordPress Pantheon Cache Plugin settings

Programmatically Using Pantheon Cache Functions

Within the pantheon-cache.php file that houses the Pantheon Cache plugin code, there are three functions that are useful to developers. You can call them from within your own custom code using various WordPress hooks, such as save_post(). Currently, the limit on the number of paths that can be cleared in a single call is 10.


This function flushes the site cache for the entire site. This achieves the same result as the Clear Site Cache button on the Pantheon Cache administration page.

 * Clear the cache for the entire site.
 * @return void
public function flush_site()


This function flushes the cache for an individual post, which is identified by the $post_id. The optional $include_homepage argument can also be passed, but if not the default value is "true".

 * Clear the cache for a post.
 * @param  int $post_id A post ID to clean.
 * @return void
public function clean_post_cache( $post_id, $include_homepage = true )


This function flushes the cache for an individual term or terms which are passed in an array, or for a complete taxonomy passed via a single taxonomy ID.

 * Clear the cache for a given term or terms and taxonomy.
 * @param int|array $ids Single or list of Term IDs.
 * @param string $taxonomy Can be empty and will assume tt_ids, else will use for context.
 * @return void
public function clean_term_cache( $term_ids, $taxonomy )

See Also