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.
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_prefixvariable in the
- Update user metadata with
update wp_usermeta set meta_key = replace(meta_key, 'oldprefix_', 'wp_');, replacing
oldprefixwith the previously used prefix.
Table prefixes are not supported or recommended by Pantheon. For more details see Accessing MySQL Databases.
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:
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.
Since WordPress 4.5, a bug exists affecting the upload of large dimension images regardless of file size. This generally presents itself as an "HTTP error" when uploading. See this core issue for more information.