Themeisle Docs

Appearance

How to verify your PHP version ​

PHP is the programming language that powers WordPress, themes, and plugins. Running an outdated PHP version can cause compatibility issues, broken layouts, or fatal errors. This guide explains how to find the minimum PHP version a theme or plugin requires and how to verify the PHP version your web server is actually running.

Check the minimum PHP version required by a theme or plugin ​

Every theme and plugin hosted on WordPress.org lists its minimum requirements in the right sidebar of its product page. To find the required PHP version:

  1. Go to the product's page on WordPress.org — for example, the Neve theme page.
  2. Look at the right-hand sidebar under the product version number.
  3. Find the Requires PHP field — this shows the minimum PHP version needed to run that theme or plugin.

📝 Note: If a theme or plugin is not hosted on WordPress.org (for example, a premium product), check the product's official documentation or the developer's website for its PHP requirements.

Verify your web server's PHP version ​

The most reliable way to check your site's actual PHP version is through the WordPress Site Health tool. This reads the PHP version your web server uses to run WordPress — which is the version that matters for compatibility.

  1. Log in to your WordPress Dashboard.
  2. Navigate to Tools > Site Health.
  3. Click the Info tab.
  4. Expand the Server section.
  5. Find the PHP version entry — this is the version your server is running for WordPress.

⚠️ Important: The PHP version shown in Site Health is the correct one to use when checking compatibility. Do not rely on other methods such as running php -v in a terminal (see the section below for why).

Why php -v may show a different version ​

If you use a terminal (command line) to check your PHP version with php -v, you may see a different version than what WordPress actually uses. This is because servers often have multiple PHP versions installed:

  • The CLI (command-line) version is used by terminal commands and scripts.
  • The web server version is the one used by WordPress and your browser requests.

These two versions can differ. For example, your terminal might report PHP 8.4, while your web server is still running PHP 7.4. Only the web server PHP version affects how your themes and plugins behave — so always use Site Health to confirm the version in use.

What to do if your PHP version is outdated ​

If your PHP version is lower than required by your theme or plugin:

  1. Contact your hosting provider. Most hosting providers allow you to upgrade PHP from your account's control panel (such as cPanel or Plesk), or can do it for you on request. Check your host's documentation or support for instructions specific to your plan.
  2. Upgrade to the required PHP version. As a general rule, use the latest PHP version your host supports that meets the theme or plugin's minimum requirement.
  3. Clear your site's cache after upgrading, so WordPress serves fresh content with the new PHP version.
  4. Verify the upgrade in Site Health. Go to Tools > Site Health > Info > Server again and confirm the PHP version now shows the updated version.

💡 Tip: After a PHP upgrade, check your site's front end and admin area to make sure everything is working correctly. If you notice any issues, contact your hosting provider or the theme/plugin support team.