诗语，作者 Yoast SEO 文档 - 第 9 页共 34 页

How to check for plugin conflicts

You have likely arrived at this article because you spotted a conflict on your site. Your WordPress site consists of WordPress core, a theme, and various plugins like Yoast SEO or Yoast SEO Premium. 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 cause of the problem, so you can contact the right team 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 method as it allows you to run a conflict check without affecting normal visitors to your site. However, if you cannot install plugins, please use an alternative option.

Step-by-step guides

Using the Health Check plugin (preferred)No plugin needed (alternative)

Common questions & concerns

I can』t do this on a live siteWill I lose my settings?Can I just deactivate Yoast SEO?How do I view the source code of a webpage to check for meta tags?What do I do next?

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 Twenty. If this resolves the issue, you have indeed a conflict. You can then switch back to the theme you are using to check if you can reproduce the issue. If the issue isn』t reproduced when your theme is active, you can enable one plugin at a time to check when the issue reappears. Doing 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. Log in to your WordPress website. When you』re logged in, you will be in your 『Dashboard』. Make sure you are running the latest versions Make sure you are up to date with the latest versions of your theme, plugins, and WordPress. If there are any open updates ready to be installed, go to 『Dashboard』 then 『Updates』 and install the available updates. Newer versions of plugins and themes can already contain a fix for the issue you are experiencing. After updating, check if the issue persists.Note: before installing (any number) of updates, please keep in mind to create a site backup. 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』. Type 『Health Check & Troubleshooting』 in the search bar, as shown below. In the plugin box, 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. When the installation is done, click the 『Activate』 button. Click the 『Activate』 button that appeared where the 『Install Now』 button was previously located. 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 that 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. 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 is only active for you and does not affect normal visitors on your site. 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 to step 10. 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』. Click 『Enable while troubleshooting』 next to Yoast SEO first. Reproduce the issue you were experiencing with just Yoast SEO active and a default theme. If the issue doesn』t occur, then also activate Yoast SEO Premium and try again. The second thing to check is whether or not the issue occurs with only the Yoast SEO plugins active while using a default theme.If the issue occurs when just Yoast SEO is active or when just Yoast SEO and Yoast SEO Premium are the only active plugins, the issue is caused by our plugin. Please hover over 『Troubleshooting Mode』, click 『Disable troubleshooting mode』 and click here for advice.If not, continue to step 13. 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』. Under 『Available themes』, click 『Switch to this theme』 on your preferred theme (or the parent theme, if you are 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 customization in the child theme.Additionally: if your theme requires any plugins to be activated, you can enable this/those plugins at this stage too. 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. 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』. 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. 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.

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 default WordPress theme like Twenty Twenty. 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 activated, 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 and switch to an unaltered default WordPress theme like Twenty Twenty.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 step 3.Activate only Yoast SEO.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 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 your preferred theme (or the parent theme, if using a child theme).If the issue occurs, the issue is caused by your theme. Click here for advice.If not and you have a child theme, repeat the steps to enable and test the child theme.If the issue occurs, the issue is caused by your child theme.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 a 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 you』ve found what minimal combination is causing the issue.

Results of a conflict check

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

Does the issue occur with no active plugins on a default theme?Does the issue occur with only Yoast SEO (free or premium with no add-ons) on a default theme?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 web host. 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 happens when only Yoast SEO (Premium) is active

Please file a bug report for our development team.

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.

Common questions and concerns

I can』t do this on my 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 plugin 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.

WordPress plugin not working? Check these things!

How to redirect a post or page

The redirect functionality is available in Yoast SEO Premium. We created it to solve problems with redirects in your WordPress site. To do this, we use relative input for redirecting. Consequently, you do not need to enter your site address in the old URL. We already add it for you using the WordPress site address found under Settings → General → Site Address in your WordPress admin.

To learn more about redirect and which one you should use read this article.

Table of contents

Valid examples
Redirect manager
Redirect within WordPress
Regex redirects
Redirect outside of WordPress
Import redirects
Deleting redirects
Redirecting with UTMs
Troubleshooting

Valid examples

The following examples will use http://example.com as WordPress site address.

The Old URL has to be your WordPress site address. You can enter the Old URL as http://example.com/redirect_url or as redirect_url. Both will point to the same URL.

The target URL can be both as well, but can also contain an external URL, for example: https://www.google.com.

Redirect manager

Yoast SEO for WordPress Premium includes a redirect manager. Follow the steps below to access the redirect manager screen. Log in to your WordPress website. When you』re logged in, you will be in your 『Dashboard』. Click on 『SEO』. On the left-hand side, you will see a menu. In that menu, click on 『SEO』. Click on 『Redirects』. The 『SEO』 settings will expand providing you additional options. Click on 『Redirects』.

Please keep the following in mind when creating a redirect, as most problems with redirects are due to a faulty input.

Redirect within your WordPress site

For this example, we redirected some broken URLs to the homepage, or to another page on the site.

In the above example you see the following:

A redirect from http://example.com/third-broken/ to http://example.com/not-broken/A redirect from http://example.com/another-broken/ to http://example.com/not-broken/A redirect from http://example.com/broken to http://example.com/

Redirect outside of your WordPress site

For this example, we redirected a broken URL to another domain. For instance, you can enter /broken-link/ to be redirected to any URL (e.g. http://example.org/). This would result in the absolute URL http://example.com/broken/ being redirected to http://example.org/.

Old URLs are relative!

Since we only handle relative input we cannot redirect you from the one (sub)domain to another. So, if your blog is installed on http://blog.example.com, you cannot redirect your visitors from:

http://otherblog.example.com,http://example.com orhttp://example.com/blog.

To redirect people from those URLs, you』d need a WordPress install with WordPress SEO Premium activated on those URLs.

Import redirects

In Yoast SEO Premium, it is possible to import redirects. To learn how, go to this article.

Deleting a redirect

Delete an Individual Redirect

To delete an individual redirect go to SEO-Redirects and find the redirect. Then, hover your mouse over it and a delete option will appear. Finally, click on Delete, and the redirect is removed.

Delete Redirect

Deleting Redirects in Bulk

The other option is to bulk delete redirects. You can delete redirects in bulk by clicking on Type which will mark all the redirects on the page. Then select Delete in the Bulk Action Drop-down Menu. Finally, click Apply.

Select Type

Select Delete in the Bulk Action Drop-down Menu

Select Apply

Redirecting with UTMs

When you have the UTM parameters in the URL, you』ll need to use the Regular Expression Redirects (RegEx) method. Otherwise, they may get stripped out. If you』re using UTM with a ?, it truly is a parameter, so it shouldn』t be redirected. We suggest using the # based UTM links or creating RegEx redirects.

Troubleshooting

If your redirects are not working, please try clearing all your cache. For example, clean the cache from your theme, plugin, server, CDN like CloudFlare or browser.

If you are not sure how to clear the cache from a theme or a plugin, please speak to the authors or CDNs of those applications. Alternatively, if you want to clear cache from the server, we advise you to speak to your host provider.

To clear the cache from a browser use this guide: https://yoast.com/help/how-to-clear-my-browsers-cache/.

How to migrate from SmartCrawl SEO to Yoast SEO

Kudos for choosing the best SEO plugin! In this article, we』ll explain how you can easily migrate from SmartCrawl SEO to Yoast SEO. We ensured the process is as smooth as possible and that all your SEO data, such as keyphrases, SEO titles, and meta descriptions, will be safe. So let』s get to it.

In this article, we mention the configuration wizard. In Yoast SEO 17.7, we』ve replaced the configuration wizard with the new configuration workout. Check out this help article to read how to use the configuration workout!

Migrating from SmartCrawl SEO to Yoast SEO

To migrate from SmartCrawl SEO to Yoast SEO follow these steps Deactivate SmartCrawl SEO. You can do that by going to the Plugins screen, and locating the plugin. Then, hover your mouse over it to reveal the options, and click Deactivate. Create a backup of your site. If you are not sure how to do this, take a look at the article – How to create a backup for your WordPress site. Go to the SEO menu item, and select Tools. The Tools screen will open. Click on the Import and Export link. The Import and Export settings will open. Select the Import from other SEO plugins tab. The tab options will be revealed. Since you should have already created the backup, move on to importing your data from SmartCrawl SEO by clicking the Import button. The time it takes to do the import depends on the amount of data you have. Once the importing is done you will see a notification on the top of the screen. Go to a Post or Page and check if your data is imported. For example, check if your focus keyphrase is there. Also, click the Google Preview button and check if your SEO title and meta description are in order. Run the Yoast SEO configuration wizard. If you need help in this process, watch the video on how to configure Yoast SEO with the configuration wizard. Once you』ve checked that everything is working properly, click the Clean Button. When the plugin cleans up the data, you will receive a notification on the top of the screen.

How to get started with Yoast SEO

Our blog is full of posts that help you learn and apply SEO the right way. If you are wondering how to get the best out of the Yoast SEO plugin, read these posts:

The beginners guide to Yoast SEOHow to use the content analysis in Yoast SEO.WordPress SEO the definite guide

Common XML sitemap errors

Are you getting an error on or about your XML sitemap? In this article, we』ve listed the most common XML sitemap errors, along with their causes and solutions.

Yoast SEO Premium makes it easy to improve and control your site structure. Among the many other benefits, it also comes with an internal linking feature and content filters. Their job is to make sure your audience and search engines find the posts and pages they need on your site.

If the 『Detected』 date is not today』s date, please test the individual sitemap to verify whether or not the issue has been resolved.

Types

Sitemap errors (General)
Errors in Bing Webmaster Tools
Errors in Google Search Console

Sitemap errors (General)

ErrorCauseSolutionMy sitemap is not using the URL format. For example, it does not include/exclude www or has http instead of https.The sitemap uses the same protocol as the WordPress Site URL.Go to Admin > Settings > General and change the site URLs to the correct protocol. If you have recently switched your URL format, you may have incorrectly formatted URLs in your database. Please backup your database and complete a search and replace of the old to new format.My sitemap is a white page or a header with no URLs.Your XSLT file is unavailable, the XML is invalid, or the 「Do not process 404 errors for static objects with WordPress」 setting is checked in W3 Total Cache.Check this page to see which error applies to you, and fix it accordingly.My sitemap doesn』t work on an Apache server.Most likely, you haven』t implemented our rewrite rules.This article has more advice on troubleshooting the sitemaps on Apache servers: Yoast XML Sitemaps on Apache serversMy sitemap doesn』t work on an NGINX server.Most likely, you haven』t implemented our rewrite rules.This article has more advice on troubleshooting the sitemaps on NGINX servers: Yoast XML Sitemaps on NGINX serversMy plugin won』t create a sitemap.The settings of your permalinks aren』t properly saved.Go to WordPress 『Settings』 in the backend Go to 『Permalinks』 Click 『Save Changes』 (without altering anything)The sitemap has gray links.This is how we built it.Gray links in your sitemap identify recently visited URLs in your own browser. Google does not see the browser formatting as they retrieve the XML source code. Learn more in this article about gray links in sitemaps.My new videos are at the bottom of my second sitemap.This is how we built it.This way only the last video sitemap changes and Google only needs to re-fetch that one instead of re-fetching all the video sitemaps all the time. The last update time will tell Google what』s new.My sitemap does not update.Sometimes the cache functionality on your site prevents the sitemap from updating automatically. This article has more advice on how to tackle this issue: Sitemap does not update.I don』t see an individual page in my sitemap. There are multiple reasons an individual page may be missing from the XML sitemap: 1. You have set the page (or the whole post type) to noindex. 2. The page』s canonical URL is set to a different URL.3. The page was redirected to another URL by Yoast SEO Premium. 4. If it』s the news sitemap, the page has not been published within the past 48 hours.1. To check if an individual page is set to noindex, go to the Advanced tab in the Yoast SEO metabox or sidebar, and make sure you allow search engines to show the page in the search results. To check the settings for the whole content type/taxonomy, go to the Advanced settings in Yoast SEO and ensure you are not blocking search engines from accessing your content. 2. To check if the page』s canonical URL is set to a different URL, use the URL inspection tool and follow Google』s guidelines on consolidating duplicate URLs.3. If you are using Yoast SEO premium, check if the page was redirected to another URL in Yoast』s redirect manager.

Errors in Google Search Console

ErrorCauseSolutionXML or text declaration not at start of entity / XML declaration allowed only at the start of the documentThere are probably several lines of whitespace preceding the <?xmltagTo be sure this is the case, follow the steps on this page. After that, start searching. Something in your WordPress install, either a plugin or your theme is outputting whitespace, and it shouldn』t… It』s not a bug in our plugin. A conflict check maybe helpful.Unsupported format. Your file appears to be an HTML pageYou』re using W3 Total Cache and you』ve ticked the setting to hide the sitemap from normal visitors.You should create an extra user agent group. You can do that by following the steps on this page.URL blocked / restricted by robots.txtThis error appears when Google is unable to crawl the specific URL due to a robots.txt restriction.Check this page to see which restriction is applied to your site and fix it accordingly.Your Sitemap or Sitemap index file doesn』t properly declare the namespace.This error appears when something on your site is modifying URLs after the sitemap is generated.This is virtually impossible for us to locate or fix as it』s not something controlled by our plugin. See this article for more information.Missing XML tag. This required tag is missing. Please add it and resubmit.This error appears when the sitemap contains zero items.Please create content for the sitemap. See this article for more information.General HTTP error: 404 not foundThere』s a handful of causes depending on which sitemap displays the error.If it』s your sitemap index, you should follow these steps. If it』s an individual sitemap, you should follow these steps. If you have a custom post type 『Video』, add a single line of code to your functions.php. If you have a custom post type 『News』, add a single line of code to your functions.php.Unknown news siteYour website may not be approved for Google News.Please verify the URL submitted to Google News exactly matches the URL in your sitemap. If you have not applied for inclusion, please visit the Google News Publisher Center.

Errors in Bing Webmaster Tools

ErrorCauseSolutionDownload of the sitemap or feed failed.The sitemap may not be accessible to Bing.Use Bing』s Mobile Friendliness Test Tool to see if Bing can read the sitemap. If the tool successfully loads feedback, resubmit the sitemap to Bing. If the tool is unsuccessful, your site may be slow or have restrictions set for Bing. Check out the site speed tools we recommend to locate areas where you can improve your speed. Your web host may also be helpful when a site is slow.

How to use the Yoast SEO Premium orphaned content workout

Have you noticed how it becomes harder and harder to clean up your site as content piles up? Do you remember the last time you checked your content and wondered: is this still relevant and up to date, or should I remove it? Just like your home, your site also needs a thorough clean-up once in a while! No worries! We』ll help you with the chore of cleaning up with the simple, three-step workout called the Orphaned content workout!

In the workout, we』ll guide you into cleaning up your orphaned content. That』s the content on your site that doesn』t have enough links pointing to it. Therefore, it is hard to find. You』ll have the option to either update and link to the content or remove it. We』ll be there every step of the way to help you do the clean-up as efficiently as possible!

If you haven』t completed the SEO data optimization, you will be required to do so to be able to proceed with the workout. Running the SEO data optimization helps the plugin give you the best internal linking suggestions.

Using the Yoast SEO Premium orphaned content workout

The orphaned content workout is organized as a checklist. After each step, you can click the button 「I』ve finished this step.」 Clicking those buttons won』t make any changes to your site or your content. The checklist is there to help you easily move through the steps. Now, let』s explore the workout! Access the workout To access the Orphaned content workout, go to the SEO menu item and then select Workouts (see image below). Then, find the Orphaned content workout in the index and click Start Workout! Love it or leave it? The first step of the workout is about deciding what you want to do with your orphaned content. Yoast SEO Premium automatically creates a list of orphaned content articles from your site. Those are the articles that are six months or older and have less than three links pointing to them. On the left side, in the first two columns, you can see the articles』 SEO and Readability scores. On the right side, you will see three buttons. Let』s explore what they do: Improve: If you』ve decided that an article is worth keeping but it needs some improvement, click the Improve button. That will automatically add the article to the second step of the workout, and you』ll be able to proceed with it from there. Remove: If you think an article is no longer relevant on your site, you can remove it. However, simply deleting it is bad for SEO and can cause 404 errors. That is why we automatically prompt you to redirect the article to another URL or to your homepage. Hide from search engines: Some of your articles may be outdated or unnecessary for the time being. But, you may want to get back to them and refresh them at some other time. In that case, you can hide those articles from search engines by clicking the button. Yoast SEO will automatically noidex the page, telling search engines not to show that page in the search results.Need help deciding what to do? Read: Keep your content fresh and up to date! Check if your article is up to date In this step, you will see a new list of articles. Those are the ones that you chose to improve in the previous step. On the left, you will again see the Readability and SEO score of the article. See any red or orange bullets? Then the article may need some work. To improve it, follow these steps: a. Click on the article in the workout to access it and read it. b. Look for outdated information. For example, you may be referring to events that have passed, products that are sold out, or software that』s been updated. In addition, there may be some new developments in the field the article is about. If there are, it may be good to edit the content and mention them. For more detailed guidance, check: How to update your content in 10 easy steps. c. Click the Edit button at the top of the screen to access the post or page editor and make the necessary changes. d. Check the SEO and Readability scores and follow the feedback to make improvements (if necessary). Satisfied with your article? Then, go back to the workout and tick the box in the Is it up-to-date column. The plugin will automatically move the article to the next step! Add internal links towards your orphaned content In the third step, you will see a list of the orphaned content articles you marked as updated. In addition, for each article, there is a list of suggested articles you can use to add internal links to the orphaned content. To add the links, follow these steps: a. Click the copy link button to the right of the orphaned article title. That will enable you to use the link later on.b. Find an article in the list relevant to the orphaned article you want to add links to.c. Click on the blue link 「Edit to add link.」 The post or page editing screen opens.d. Find a relevant sentence that is related to your cornerstone article. Use the link you copied in step one and insert it in the sentence you chose. Make sure that the link text is also relevant to the topic of the cornerstone.Note: you』ll need to repeat this process for each of your orphaned content articles. Well done! You did it! You cleaned up the old content on your site in just three steps and freshened up your site』s SEO! In this step, you get an overview of the work you』ve done. Time to pat yourself on the back!

The Yoast SEO workouts FAQ

Still have some questions about this workout? Head to the Yoast SEO Workouts FAQ page!

Granting a Yoast member access to your Google Search Console property

In rare cases, we may ask you to grant us access to your Google Search Console property. Each team at Yoast has a shared Google account so a team member must provide you with the email address for their team. Please remember to remove our access once your question has been answered.

Add new user
Change user permission
Owner, Full or Restricted

How to add a user to your Google Search Console property

Below we』ll show you the steps to adding a user to your Google Search Console property. Before we do please note that Google Search Console properties can have a maximum of 100 full or restricted users.

Open Google Search Console』s user admin Select a verified property The property should match your preferred URL format including http or https and www or non-www because Google treats each format as separate but related properties. If your preferred URL format is not listed, add your preferred URL format to Google Search Console (formerly Google Webmaster Tools) by following the steps here. Click 『Settings』 on the left-hand side Click 『Users and permissions』 Click 『Add a new user』 on the top right Enter the email address provided to you by a Yoast team member. Selected 『Full』 under the permission dropdown. Why 『Full』 permissions? Click 『Add』.

Change Existing User Permissions

Open Google Search Console』s user adminSelect the verified property that matches your preferred URL format including http or https and www or non-www because Google treats each format as separate but related properties.Click on the permission drop down and select 『Full』 for the email address provided to you from a Yoast team member. The change is made immediately. Why 『Full』 permissions?

Permission Levels

Google has different account roles so you can give different permission levels to each user. We ask for 『Full』 access because it allows us to make changes like submitting the sitemap and using the 『Fetch as Google』 tool. If you would prefer to handle changes, you can provide us with 『Restricted』 permissions.

The full list of permissions for each role is listed here.

Do you need to remove a user? You can find instructions on how to do that in this help article.

Security: no advanced settings for authors

This feature lets you determine who gets access to the Advanced tab of the Yoast SEO meta box and the Yoast SEO sidebar. In the Advanced tab, you find the settings that allow you to remove posts from the search results or change the canonical. These are powerful settings, and, as such, it is advisable to let only specific users access them. That is why, by default, only editors and administrators can see and use the Advanced tab in Yoast SEO. If you want all users of your WordPress website to be able to operate the Advanced tab in the Yoast SEO meta box and the Yoast SEO sidebar, you can choose to switch this feature 「off」. To do that, go to Yoast SEO in the admin menu, click the General menu item, and then the Features tab. You will find the toggle for this feature at the bottom of the screen.

The settings in the Advanced tab of the Yoast SEO meta box and the Yoast SEO sidebar

With the Advanced tab in Yoast SEO, you can determine how search engines crawl and index your post or page. There are five settings in the tab:

The Advanced tab in the Yoast SEO meta box

1. Allow search engines to show this Post in search results?

This setting determines whether search engine robots can index your post or page. If you set this to 『yes,』 the Google robots will index your post or page. As a consequence, your post or page will be able to appear in search engines.

2. Should search engines follow links on this Post?

Some of the links you add to a post or page may lead to parts of your website that you don』t want Google to index. With this setting, you can prevent Google from following such links.

3. Meta robots advanced

The advanced meta robots settings allow you to set the meta robots for this page or post to several values. Read more about the meta robots advanced settings here.

4. Breadcrumbs title

With the breadcrumbs title setting, you can change the breadcrumbs title for the Yoast SEO breadcrumbs. To learn more, read the article on how to change the breadcrumb title.

5. Canonical URL

Some of your URLs may contain the same content. To avoid confusing Google (and the user), you can tell search engines which URL contains the original content. You do this by adding a canonical URL that this post or page should point to.

How to disable the 『Internal Linking』 feature?

Yoast SEO Premium includes an Internal Linking tool. This feature is enabled by default. Log in to your WordPress website. When you』re logged in, you will be in your 『Dashboard』. Click on 『SEO』. On the left-hand side, you will see a menu. In that menu, click on 『SEO』. Click on 『General』. The 『SEO』 settings will expand providing you additional options. Click on 『General』. Click on the 『Features』 tab. Toggle the 『Link suggestions』 switch. To enable the feature, toggle the switch to 『On』.To disable the feature, toggle the switch to 『Off』. Click 『Save Changes』.

How to migrate from Squirrly SEO to Yoast SEO

Thanks for choosing Yoast SEO! In this post, we go through the steps you need to take when migrating from Squirrly SEO to Yoast SEO. Your primary concern may be that you will lose your SEO data. For example, you may wonder what will happen to the keyphrases, meta descriptions, and SEO titles you already used in your published posts and pages. No worries. Follow the steps below, and Yoast SEO will import all the data and ensure your transition is smooth.

Migrating from Squirrly SEO to Yoast SEO

To migrate from Squirrly SEO to Yoast SEO follow these steps Deactivate Squirrly SEO. You can do that by going to the Plugins screen, and locating the plugin. Then, hover your mouse over it to reveal the options, and click Deactivate. Create a backup of your site. If you are not sure how to do this, take a look at the article – How to create a backup for your WordPress site. Go to the SEO menu item, and select Tools. The Tools screen will open. Click on the Import and Export link. The Import and Export settings will open. Select the Import from other SEO plugins tab. The tab options will be revealed. Since you should have already created the backup, move on to importing your data from Squirrly SEO by clicking the Import button. The time it takes to do the import depends on the amount of data you have. Once the importing is done you will see a notification on the top of the screen. Go to a Post or Page and check if your data is imported. For example, check if your focus keyphrase is there. Also, click the Google Preview button and check if your SEO title and meta description are in order. Run the Yoast SEO configuration wizard. If you need help in this process, watch the video on how to configure Yoast SEO with the configuration wizard. Once you』ve checked that everything is working properly, click the Clean Button. When the plugin cleans up the data, you will receive a notification on the top of the screen.

Need some help getting started with Yoast SEO?

These post on the Yoast blog may be helpful:

The beginners guide to Yoast SEOHow to use the content analysis in Yoast SEO.WordPress SEO the definite guide

How to implement Yoast SEO breadcrumbs

Table of contentsWhat are breadcrumbs? Why are they important?What do the Yoast SEO breadcrumbs do?How to use the Yoast breadcrumbs block to add breadcrumbs to single posts and pages What do the Yoast SEO breadcrumbs look like?How do I implement Yoast SEO breadcrumbs site-wide?How can I add breadcrumbs with a shortcode? How do I enable and set-up the Yoast breadcrumbs?I』m a theme developer, how do I integrate Yoast breadcrumbs in my non-WooTheme?How do I configure breadcrumbs on posts and pages?How does it work with the WooThemes breadcrumbs?How do I edit the breadcrumbs pathway?

What are breadcrumbs? Why are they important?

Breadcrumbs are a way to help your users better navigate your site and its structure. Additionally, they can appear on Google and provide a better user experience. If you want to know more about breadcrumbs please visit our: What are Breadcrumbs and Why are they Important for SEO guide.

To make it easy for users and search engines to navigate your site, you need more than breadcrumbs. Yoast SEO Premium comes with an internal linking feature, as well as content filters. With those tools, you can keep your content structured, findable, and up-to-date.

What do the Yoast SEO breadcrumbs do?

The Yoast SEO breadcrumbs will output JSON-LD data in the source code. We have found this to be the most reliable method of implementing breadcrumbs for rich snippets.

How to use the Yoast breadcrumbs block to add breadcrumbs to single posts and pages

With Yoast SEO, it is possible to add breadcrumbs to single posts and pages. You can do that with the breadcrumbs block. All you need to do is add the block to the post or the page, and that』s it! Note that the breadcrumbs you add with the block are only visible on the individual page you added the block to. You will need to use the steps we mention below if you want to have site-wide breadcrumbs. To learn how to use the block, watch the video below.

What do the Yoast SEO breadcrumbs look like?

Once configured, Yoast will show the JSON-LD in the source code.

Yoast SEO Breadcrumbs as JSON+LD as they appear in the Source code for the plugin sales page.

Eventually, Google will replace the link that appears beneath your blue SEO Title with one that shows the breadcrumb pathway.

Yoast SEO Breadcrumb pathway as shown in Google.

How do I implement Yoast SEO breadcrumbs site-wide?

The steps below are a temporary solution as manual edits made to theme files may be overwritten with future theme updates. Please contact the theme developer for a permanent solution.

We』ve written an article about the importance of breadcrumbs for SEO. To implement the breadcrumbs function in Yoast SEO, you will have to edit your theme. If you are not sure how to edit the theme files, your theme developer may be able to help. Alternatively, you may use a Yoast Partner. We recommend that prior to any editing of the theme files, a backup is taken. Your host provider can help you take a backup.

Copy the following code into your theme where you want the breadcrumbs to be. If you are not sure, you will need to experiment with placement:

<?php
if ( function_exists('yoast_breadcrumb') ) {
yoast_breadcrumb( '

','

' );
}
?>

NOTE: Depending on your theme you may or may not need to add in the beginning PHP tags. If you are not sure, your theme developer can help.

Common places where you could place your breadcrumbs are inside your single.php and/or page.php file just above the page』s title. Moreover, another option that makes it really easy in some themes is by just pasting the code in header.php at the very end.

In most non-WooTheme themes, this code snippet should not be added to your functions.php file. If you have trouble locating the correct place to add the code, please contact the theme developer for assistance.

How can I add breadcrumbs with a shortcode?

Yoast can output breadcrumbs with a shortcode on a site』s posts, pages, and taxonomies. If you are using Gutenberg, you will need to insert a shortcode block and add the following code:

首页 » 归档于诗语 » 第 9 页

If you are using the Classic editor (or if the post type does not yet support Gutenberg) you will need to click on the Text editor and add in the shortcode (see image below).

This will output the breadcrumb pathway into that part of the page. The only way to remove the breadcrumb from the page is to delete the shortcode. It cannot be disabled in the SEO-Search Appearance-Breadcrumb section. If you use the breadcrumb shortcode you do not need to add the breadcrumb code snippet described here to your theme』s files.

Note that the shortcode works only on the page that has them, it is not a global solution. If you want to add breadcrumbs to all your post types efficiently, you will need to use that code snippet.

How do I enable and set-up the Yoast breadcrumbs?

Yoast SEO offers a breadcrumb feature. This feature is disabled by default as you or your theme developer must add code to your theme files. After that, go to SEO → Search Appearance → Breadcrumbs and enable the breadcrumb feature. Log in to your WordPress website. When you』re logged in, you will be in your 『Dashboard』. Click on 『SEO』. On the left-hand side, you will see a menu. In that menu, click on 『SEO』. Click on 『Search Appearance』. The 『SEO』 settings will expand providing you with additional options. Click on 『Search Appearance』. Click on the 『Breadcrumbs』 tab. Scroll down to the bottom of the screen and toggle the 『Breadcrumbs』 switch. To add Yoast breadcrumbs, toggle the switch to 『Enabled』.To remove Yoast breadcrumbs, toggle the switch to 『Disabled』. If you enabled the breadcrumbs, configure the settings to your preference. Note that Pages do not get a Taxonomy to Show option and therefore are not shown. Instead, a shortcode must be used to display them. Click 『 Save changes』. Show Blog Page Feature If you want to use the feature, you will need to set-up a static page for your Posts Page in the Settings-Reading section of your WordPress site.

I』m a theme developer, how do I integrate Yoast breadcrumbs in my non-WooTheme?

If you are a theme developer you may need to take one additional step to complete the integration with Yoast SEO Breadcrumbs by adding our breadcrumbs filter.

Once this filter has been added to your theme, the Yoast breadcrumbs will take over all the non-Yoast ones.

How do I configure breadcrumbs on posts and pages?

To configure the breadcrumbs please use this guide. Note, that the Taxonomy to Show does not appear in the Breadcrumb section. Instead, you will need to use a shortcode.

How does it work with the WooThemes breadcrumbs?

If you have a WooTheme you may need to add some different code. If you are not sure if you have a WooTheme, your theme developer can help. You can also replace WooThemes Breadcrumbs.

How do I edit the breadcrumbs pathway?

Change the category in the breadcrumb pathway on posts by selecting the primary category

You can change the breadcrumb pathway on posts by selecting the primary category. For example, if you select a Subcategory as primary, Yoast will output the Parent Category and also the Subcategory. You may need to experiment with selecting categories in order to get the right pathway to appear.

Select Category and be sure to mark it as primary. In the example image below, the subcategory (also called a child category was selected)

2. See parent (also called Primary or Main) and child category appear.

Change the title of a post or page or taxonomy in the breadcrumb pathway by adding in a custom title

You can add a custom breadcrumb title for a post or page or taxonomy. As a result, the default title will be replaced. Check out our help article on how to customize your breadcrumb titles to learn how!

Change the full breadcrumb pathway using a filter

To edit the breadcrumbs pathway use the filter below and place it in your child theme』s functions.php file:

wpseo_breadcrumb_links

We also have some examples of how to edit and remove breadcrumbs. If you are not sure how to use them, where your functions.php file is, or what a child theme is please contact your theme developer for more information. Alternatively, consider a Yoast Partner who can help.

Change the breadcrumb separator

If you need to change the breadcrumb separator you can do so by going to SEO-Search Appearance-Breadcrumb Pathway and locate the Separator Between Breadcrumbs field. Then, you can add whatever character you want here.

If you want to further customize the separator you can do so using the filter below. It would go into your functions.php file. We recommend using a child theme to preserve changes. If you are not sure how to use the filter, where your functions.php file is, or what a child theme is please contact your theme developer for more information. Alternatively, consider a Yoast Partner who can help.

wpseo_breadcrumb_separator

Change single items in the breadcrumb pathway using a filter

To edit individual items/links in the breadcrumb pathway use the filter below and place it in your child theme』s functions.php file:

wpseo_breadcrumb_single_link

We also have some examples of how to edit and remove individual breadcrumbs.

If you are not sure how to use them, where your functions.php file is, or what a child theme is please contact your theme developer for more information. Alternatively, consider a Yoast Partner who can help.

How do I change the breadcrumbs on a WooCommerce shop page?

You can edit the shop page by using some of these filters and code snippets. It would go in your functions.php file. The code can also be used to make the Shop page appear elsewhere on your site such as on a Product Category page.