How To Check For Plugin Conflicts

Your WordPress installation consists of WordPress Core, a theme, and usually one or more plugins. Unfortunately sometimes these aspects conflict with each other, therefore we want you to test if your problem still exists in a controlled environment. This will help you identify the correct team of experts to report the issue. Having the right teams working on the issue is a benefit to you.

We highly recommend using the Health Check plugin as it allows you to run a conflict check without affecting normal visitors to your site. However, if you cannot install plugins, please use the alternative option.

Step by Step Guides

Questions

How to check for conflicts using a plugin

The fastest way to rule out conflicts is to deactivate all non-Yoast plugins and switch to a standard theme like Twenty Seventeen. If this resolves the issue, you have a conflict and should activate one plugin at a time until you locate the conflict. Finally, after all plugins are active, switch to your theme. This will narrow down the conflict to a specific plugin or a theme conflict. The steps below will walk you through the process using the Health Check & Troubleshooting plugin.

  1. Log in to your WordPress website.

    When you’re logged in, you will be in your ‘Dashboard’.

  2. Click on ‘Plugins’.

    On the left-hand side, you will see a menu. In that menu, click on ‘Plugins’.

  3. Click on ‘Add New’.

    The ‘Plugins’ settings will expand providing you additional options. Click on ‘Add New’.

  4. Type ‘Health Check & Troubleshooting’ in the search bar, as shown below.

    add new search plugins

  5. Click the ‘Install Now’ button.

    This will give you a page of search results. The Health Check & Troubleshooting plugin should be visible now. Click the ‘Install Now’ button.

  6. Click the ‘Activate’ button.

    Click the ‘Activate’ button that appeared where the ‘Install Now’ button was previously located.

  7. Click on ‘Tools’.

    ‘Tools’ is located in the sidebar menu.

    Note: If you are using WordPress version 5.1 or older, please click on ‘Dashboard’.

  8. Click on ‘Site Health’.

    The ‘Tools’ menu will expand providing you additional options. Click on ‘Site Health’.

    Note: If you are using WordPress version 5.1 or older, please click on ‘Health Check’ under ‘Dashboard’.

    There are multiple tabs which provide a lot of information about your website and server setup. If you see errors on the ‘Status’ or ‘Info’ tabs, please resolve the issues before continuing.
    WordPress Tools Site Health

  9. Click on the ‘Troubleshooting’ tab, read the warning information, and click ‘Enter Troubleshooting Mode’.

    Troubleshooting mode automatically disables all plugins and switches to a default theme. Troubleshooting mode does not affect normal visitors to your site.

  10.  Reproduce the issue you were experiencing in the default environment with no active plugins and a default theme.

    If the issue occurs, this means our plugin is not causing the unexpected behavior.

  11. Click on ‘Plugins’.

    ‘Plugins’ is located in the sidebar menu.

  12. Click on ‘Installed Plugins’.

    The ‘Plugins’ menu will expand providing you additional options. Click on ‘Installed Plugins’.

  13. Click ‘Enable while troubleshooting’ next to Yoast SEO or Yoast SEO Premium.

  14. Reproduce the issue you were experiencing with only Yoast SEO (free or premium) active and a default theme.

    If the issue occurs, the issue is caused by our plugin. Please hover over ‘Troubleshooting Mode’, click ‘Disable troubleshooting mode’ and click here for advice.

    If not, continue.

  15. Click on ‘Plugins’.

    ‘Plugins’ is located in the sidebar menu.

  16. Click on ‘Installed Plugins’.

    The ‘Plugins’ menu will expand providing you additional options. Click on ‘Installed Plugins’.

  17. Click ‘Enable while troubleshooting’ on the first disabled plugin.

    If the issue is related to a Yoast add-on or a specific plugin, please enable this plugin before other plugins.

  18. Reproduce the issue you were experiencing.

    If the issue occurs, Yoast SEO conflicts with the plugin you just activated. Please hover over ‘Troubleshooting Mode’, click ‘Disable troubleshooting mode’ and click here for advice.

    If not, repeat the steps to activate the next disabled plugin until are plugins are active and then continue.

  19. Click on ‘Dashboard’.

    On the left-hand side, click on ‘Dashboard’ at the top.

  20. Click on ‘Home’.

    The ‘Dashboard’ menu will expand providing you additional options. Click on ‘Home’.

  21. Under ‘Available themes’, click ‘Switch to this theme’ on your preferred theme (or the parent theme, if using a child theme).

  22. Reproduce the issue you were experiencing.

    If the issue occurs, Yoast SEO conflicts with your preferred theme. Please hover over ‘Troubleshooting Mode’, click ‘Disable troubleshooting mode’ and click here for advice.

    If not and you have a child theme, repeat the steps to enable and test the child theme.

How to Manually Check for Conflicts

The fastest way to rule out conflicts is to deactivate all non-Yoast plugins and switch to a standard theme like Twenty Nineteen. If this resolves the issue, you have a conflict and should activate one plugin at a time until you locate the conflict. Finally, after all plugins are active, switch to your theme. This will narrow down the conflict to a specific plugin or a theme conflict. The steps below will walk you through the process.

  1. Deactivate all plugins.
  2. Switch to an unaltered default WordPress theme like Twenty Nineteen.
  3. Reproduce the issue you were experiencing.
    If the issue occurs, this means our plugin is not causing the unexpected behavior. Click here for advice.

  4. If the issue does not occur, continue to the next step.
  5. Activate only Yoast SEO or Yoast SEO Premium.
  6. Reproduce the issue you were experiencing.
    If the issue occurs, the issue is caused by our plugin. Click here for advice.
    If not, continue.
  7. Activate one of the previously active plugins.
    If the issue is related to a Yoast add-on, please enable Yoast plugins before other plugins. If the issue is related to specific plugin feature, activate this plugin before other plugins.
  8. Reproduce the issue you were experiencing.
    If the issue occurs, Yoast SEO conflicts with the plugin you just activated. Click here for advice.
    If not, repeat the steps to activate the next inactive plugin until are plugins are active and then continue.
  9. Activate your preferred theme (or the parent theme, if using a child theme).
  10. Reproduce the issue you were experiencing.
    If the issue occurs, Yoast SEO conflicts with your preferred theme. Click here for advice.
    If not and you have a child theme, repeat the steps to enable and test the child theme.

Issue Happens With No Plugins & Default Theme

As much as we’d love to help, the issue is not caused by our plugin. This may be a WordPress issue, a conflict with your specific setup or something related to your server or webhost. Opening a topic in the WordPress support forums may help point you in the right direction.

If you were using the Health Check plugin, please hover over ‘Troubleshooting Mode’ and click ‘Disable troubleshooting mode’. This will, also, automatically disable when you log out of your WordPress admin account.

Issue When Only Yoast Plugin Is Active

Please file a bug report for our development team.

If you were using the Health Check plugin, please hover over ‘Troubleshooting Mode’ and click ‘Disable troubleshooting mode’. This will, also, automatically disable when you log out of your WordPress admin account.

Plugin or Theme Conflict

Once you have identified a possible conflict, please hover over ‘Troubleshooting Mode’ and click ‘Disable troubleshooting mode’. Then repeat the conflict check steps activating the conflicting plugin or theme without Yoast SEO (free or premium) active. If the issue happens while Yoast SEO (free or premium) is not active, please report the issue to the author of the plugin or theme.

If the issue happens while Yoast SEO (free or premium) is active alongside another plugin or theme, please file a bug report for our development team. As the issue is a conflict with another plugin or theme, we highly recommend reporting the issue to the development or support team of the other plugin or theme. Having both teams work on the issue is a benefit to you.

If you were using the Health Check plugin, please hover over ‘Troubleshooting Mode’ and click ‘Disable troubleshooting mode’. This will, also, automatically disable when you log out of your WordPress admin account.

Will I Lose My Settings?

Yoast settings are stored in the database and are saved when you deactivate Yoast plugins. Deactivating other plugins or changing themes should not cause you to lose any settings, however, we cannot guarantee it. For the health and safety of your site, we recommend making a complete backup of your website. This simply provides you with a safety net in the event something doesn’t reset correctly.

Why Can’t I Just Deactivate the Yoast plugin?

If you’re reading these steps, something has already failed within Yoast so deactivating Yoast plugins won’t provide the full picture. Our development team must be able to reproduce the issue in order to provide an accurate solution.

I Can’t Do This On A Live Site

The Health Check plugin used above allows you to run a conflict check without affecting normal visitors to your site. However, we understand if you wouldn’t want to deactivate your plugins and switch themes on a production site, so it may be preferable that you set up a staging environment for your tests.

Some popular web hosts offer quick setups for a staging site so please contact your web host for assistance. If your web host does not offer staging sites, this article will help you create a staging site.

How do I View the Source Code to Check for Meta Tags?

In some cases you will need to review the source code as you deactivate plugins to check if certain tags have been removed. This guide explains more about how to check the source code: How To View The Source Code.

Was this article helpful? ·