Troubleshoot

Overview of WordPress multisite support on the Pantheon Platform.

Discuss in our Forum Discuss in Slack

WP-CLI Tips and Tricks

Managing Site Networks

The wp site * class of WP-CLI commands (full documentation) for managing the sites installed on your network. Here are some helpful ones:

  • wp site create - Create a new site on the network.
  • wp site list - See all available sites on the network.
  • wp site empty - Clear a site of its posts and comments, while retaining options, users and other configuration details.

Updating the Database

WordPress sometimes includes database schema changes in releases. When you update WordPress to the latest version, you might see a notification in the WordPress dashboard to run the database update process. Use wp core update-db --network (full documentation) to run the database upgrade procedure across all sites on your Site Network.

Adding and removing super admins

“Super admin” is a special designation for select users on a WordPress Site Network. While a user's role may vary between sites on the network, any user can be a super admin which gives them unrestricted access to every site on the network.

Use wp super-admin list to list current super admins, and wp super-admin add or wp super-admin remove to add or remove them, respectively.

Troubleshooting

Error: Cookies are blocked or not supported by your browser

See the related section in Basic Troubleshooting for more information.

Error: "Error establishing a database connection"

You may see this error when moving a WordPress Site Network database between environments. The most common cause is either using wp search-replace incorrectly (or having forgotten to use it at all).

Because it's a confusing error, it's helpful to understand how it's caused. This error can be reproduced by:

  1. Creating a new WordPress multisite instance with one site.
  2. Manually setting the domain value in the wp_blogs table to mstest.org.
  3. Manually editing the DOMAIN_CURRENT_SITE constant to mstest.dev.

When you visit mstest.dev in your browser, you'll see the “Error establishing database connection” message. Essentially, WordPress displays an error message because it couldn't find the requested site in the wp_blogs table.

Check out the open WordPress.org Trac ticket where this message is being discussed, and will hopefully be improved in the future.

Potential Wordpress Multisite with Composer Subdirectory Solution

We support WordPress multisites with subdirectories. However, if you are working with a composer-based Multisite ​setup, your sub sites might produce redirect errors. Your reference URLs might be incorrect if your WordPress core file path looks like this: /code/web/wp.

 Note

The solution outlined below has worked for select customers, and may not work for your specific configuration / environment.

Move your WordPress core files from /code/web/wp to the /code/web root by using the example WordPress Composer script.

Note that this script is only intended as an example to help you get started. You will most likely need to make changes to match your current configuration.