How To Check For Plugin Conflicts

You have likely arrived at this article because something on your site conflicts with a plugin, like Yoast SEO. 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

Common Questions & Concerns

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 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 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’ then ‘Add New’.

    On the left-hand side, you will see a menu. In that menu, click on ‘Plugins’.
    The ‘Plugins’ settings will expand providing you additional options. Click on ‘Add New’.

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

    add new search plugins

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

  5. Click the ‘Activate’ button.

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

  6. Click on ‘Tools’ then ‘Site Health’.

    On the left-hand side, you will see a menu. In that menu, click on ‘Tools ’. The ‘Tools’ menu will expand providing you additional options. Click on ‘Site Health’.

    Note: 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

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

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

    The first thing to check is whether or not the issue happens in a default environment with no plugins while using a default theme. This is the default state when you click ‘Enter Troubleshooting Mode’.

    If the issue occurs when Yoast SEO is not active, this means our plugin is not causing the unexpected behavior. Click here for advice.

    If not, continue.

  9. Click on ‘Plugins’ then ‘Installed Plugins’.

    On the left-hand side, you will see a menu. In that menu, click on ‘ Plugins ’. The ‘Plugins’ menu will expand providing you additional options. Click on ‘Installed Plugins’.

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

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

    The second thing to check is whether or not the issue occurs with only the core Yoast SEO plugin active while using a default theme.

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

    If not, continue.

  12. Click on ‘Plugins’ then ‘Installed Plugins’.

    On the left-hand side, you will see a menu. In that menu, click on ‘ Plugins ’. The ‘Plugins’ menu will expand providing you additional options. Click on ‘Installed Plugins’.

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

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

  14. Reproduce the issue you were experiencing.

    The next thing to check is for the minimum plugin environment required to reproduce the issue. To check, this requires some patience and time. Activate plugins one at a time while testing for the issue. This step will be repeated many times as you layer on one part of your site until you find the minimum setup required.

    If the issue occurs in a specific environment, 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.

  15. Click on ‘Dashboard’ then ‘Home’.

    On the left-hand side, click on ‘Dashboard’ at the top. The ‘Dashboard’ menu will expand providing you additional options. Click on ‘Home’.WordPress Dashboard Home

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

    Note: If your preferred theme is a child theme, please enable the parent theme first. This will help determine if the conflict is with the parent theme or a customization in the child theme.

  17. Reproduce the issue you were experiencing.

    The last thing to check is your theme.

    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 Plugin 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 and switch to an unaltered default WordPress theme like Twenty Nineteen.
  2. 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.
  3. Activate only Yoast SEO or Yoast SEO Premium.
  4. Reproduce the issue you were experiencing.
    If the issue occurs, the issue is caused by our plugin. Click here for advice.
    If not, continue.
  5. 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.
  6. 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.
  7. Activate your preferred theme (or the parent theme, if using a child theme).
  8. 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.

Results of a Conflict Check

There are three important questions that you should be able to answer after completing a conflict check.

  1. Does the issue occur with no active plugins on a default theme?
  2. Does the issue occur with only Yoast SEO (free or premium with no add-ons) on a default theme?
  3. If no to both above, what is the minimum setup required to reproduce the issue consistently?

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.

Common Questions and Concerns

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.

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.

How do I View and Search the Source Code to Check for Meta Tags or Schema?

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 and search the source code: How To View and Search The Source Code.

If you are using an external tool, like the Google Structured Data Testing tool, please switch to a code snippet view for the external tool and use the source code instead of the post/page URL as the live post/page URL may be cached with outdated information or not be modified due to the way the plugin handles troubleshooting.

Was this article helpful? ·