WordPress Known Issues
Learn the recommended solutions for known issues on the Pantheon Website Management Platform for WordPress sites.
Discuss in our Forum Discuss in SlackThis 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 thewp-config.php
file, - Update user metadata with
update wp_usermeta set meta_key = replace(meta_key, 'oldprefix_', 'wp_');
, replacingoldprefix
with the previously used prefix.
Note
Table prefixes are not supported or recommended by Pantheon. For more details see Accessing MySQL Databases.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.
PHP Version Compatibility
WordPress is not fully compatible with PHP 8.0 or 8.1. The remaining known issues with PHP 8.1 are deprecation notices. A deprecation notice is not an error, but an indicator of the compatibility work that is needed before PHP 9 is released and notices become fatal errors. The PHP code will continue to work with the deprecation notices.
For more information, refer to the PHP Versions documentation.
WordPress Multisite
Pantheon supports designated use cases for WordPress Multisite.
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 WordPress Plugins and Themes 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. This generally presents itself as an "HTTP error" when uploading. See this core issue for more information.
Force WordPress to use GD Library instead of Imagick
WordPress uses both GD Library and Imagick when editing or uploading images/PDF files. For big files, there are times when uploading images inconsistently fails or succeeds. This is because WordPress tries to utilize either of the two libraries, depending on which resource is available at a given time.
We've seen that GD Library works reliably for large files, and you can insert the sample code below in your theme's function.php
to force use of GD Library:
function force_use_gdlib( $editors ) {
$default_editor = 'WP_Image_Editor_GD';
$editors = array_diff( $editors, array( $default_editor ) );
array_unshift( $editors, $default_editor );
return $editors;
}
add_filter( 'wp_image_editors', 'force_use_gdlib' );
See this core issue on WordPress.org for more information.
Language Packs
WordPress 4.7 introduced the ability for admins to add additional language packs to WordPress from the General Settings screen. On Pantheon, this is only possible on development environments in SFTP mode. This is because WordPress attempts to download the language packs for the requested language, and file writes are disabled in all environments other than development environments.
WordPress 6.2 extends this feature to user profiles. You can install language packs from your Edit Profile page. Note that this feature is still not available on Pantheon outside of a development environment in SFTP mode.