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 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’ 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 plugin should be visible now. Click the ‘Install Now’ button. Admin Plugins Add New Health Check Install

  6. Click the ‘Activate’ button.

    Click the ‘Activate’ button that appeared where the ‘Install Now’ button was previously located.Admin Plugins Add New Health Check Activate

  7. Click on ‘Dashboard’.

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

  8. Click on ‘Health Check’.

    The ‘Dashboard’ menu will expand providing you additional options. Click on ‘Health Check’.
    Admin Dashboard Health Check

  9. There are multiple tabs which provide a lot of information about your website and server setup.

    If you see errors on the ‘Health Check’ or ‘Debug Information’ tabs, please resolve the issues before continuing.

  10. Click on the ‘Troubleshooting’ tab, read the warning information, and click ‘Enter troubleshooting mode’.

  11.  Reproduce the issue you were experiencing.

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

  12. Click on ‘Dashboard’.

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

  13. Click on ‘Home’.

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

  14. Under ‘Available Plugins’, click ‘Show all plugins’ and ‘Enable’ next to Yoast SEO or Yoast SEO Premium.

  15. Reproduce the issue you were experiencing.

    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.

  16. Click on ‘Dashboard’.

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

  17. Click on ‘Home’.

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

  18. Under ‘Available Plugins’, click ‘Show all plugins’ and ‘Enable’ on the first disabled plugin.

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

  19. 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.

  20. Click on ‘Dashboard’.

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

  21. Click on ‘Home’.

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

  22. Under ‘Available Themes’, click ‘Show all themes’ and ‘Enable’ on your preferred theme (or the parent theme, if using a child theme).

  23. 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 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.

  • Deactivate all plugins.
  • Switch to an unaltered default WordPress theme like Twenty Seventeen.
  • Reproduce the issue you were experiencing.
    If the issue occurs, this means our plugin is not causing the unexpected behavior. Click here for advice.
    If the issue does not occur, continue to the next step.
  • Activate only Yoast SEO or Yoast SEO Premium.
  • Reproduce the issue you were experiencing.
    If the issue occurs, the issue is caused by our plugin. Click here for advice.
    If not, continue.
  • 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.
  • 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.
  • Activate your preferred theme (or the parent theme, if using a child theme).
  • 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

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.

Was this article helpful? ·