WordPress Known Issues

Learn the recommended solutions for known issues on the Pantheon Website Management Platform for WordPress sites.


This page tracks known issues and the recommended solution (if any) for running WordPress on the Pantheon website platform. Most sites work fine, but there are some common gotchas we are tracking and working to address.

Table Prefixes

If you are importing a site and the database has custom prefixes for your DB tables (e.g. anything other than wp_), Pantheon will try to detect this on import. However, if you do a multi-step import, or upload a database manually, you may need to update the $table_prefix variable in the wp-config.php file Pantheon bundles with your site for the application to correctly see those tables.

Automatic Updates

WordPress's automatic update functionality will not work on Pantheon site environments. We disable all automatic updates by default with the Pantheon Updates plugin, found within the mu-plugins directory of our WordPress upstream. This plugin disables core, theme, and plugin updates on all Pantheon environments. Attempting to override this functionality by editing or removing this file will break your Test and Live environments. The codebase for these environments is not writeable, and WordPress will continually attempt to download and unpack core updates, which it cannot do on these environments. For more information, see the following:

PHP Sessions

If you see this error:

Warning: session_start(): user session functions not defined

It means you have some code (plugin or theme) that's using PHP Sessions, which require a plugin to work on Pantheon. Read more about WordPress and PHP Sessions.

Site Networks / Multisite

Pantheon supports designated use cases for WordPress Site Networks created by WordPress' Multisite feature.

It's especially ill-advised to use Multisite to set up many distinct/separate sites — e.g. running different plugins, for different customers — on a single code installation.

Plugins with Known Issues

See Modules and Plugins with Known Issues for a list of WordPress plugins that are not supported and/or require workarounds.

Image uploads

Since WordPress 4.5, a bug exists affecting the upload of large dimension images regardless of file size. See this core issue for more information.