Skip to content

Changing the PHP version

Each CloudPress site runs on a specific version of PHP. You can switch a site to a different available PHP version from the dashboard whenever you need to — for example, to move to a newer release for better performance and security, or to stay on an older release while you test plugin and theme compatibility.

Before you start

  • Access to the site in your CloudPress dashboard.
  • A sense of which PHP version your WordPress theme and plugins support. Major version jumps (for example, PHP 7.x to PHP 8.x) can break older plugins, so check compatibility first.
  • Ideally, a recent backup of the site in case you need to revert after testing.

Steps

  1. Open the site. In the left sidebar, open My Sites and select the site you want to change.

  2. Go to the site's settings. In the site's left sidebar, click Settings.

  3. Pick the new PHP version. On the Settings page, find the PHP Version field. It's a dropdown listing the PHP versions available for your site. Choose the version you want.

  4. Apply the change. Click Update.

After you submit, CloudPress confirms that the change was submitted. It runs in the background and appears under the site's Activity. Once it finishes, the new value appears in the PHP VERSION card on the site overview page. Re-check your site once it completes.

If you select the version the site is already on, CloudPress reports that there's no change in PHP version.

Test compatibility before switching production

A newer PHP version can stop older plugins or themes from working, and a downgrade can break code that relies on newer language features. Confirm your plugins and theme support the target version before changing a live site, and keep a recent backup so you can restore if something breaks.

If a version causes problems, repeat these steps to switch back to a version you know works.

Reading the PHP version over the API

To read a site's current PHP version through the API, see Sites.

Next steps

  • Re-test your site's key pages and admin after the change completes.
  • Review what else you can configure on a site — see the platform overview.
  • If a plugin breaks, restore from a backup and switch back to a known-good PHP version.