Yoast SEO 文档

Replace WooThemes Breadcrumbs with Yoast Breadcrumbs

If you are not sure if you have a WooTheme or not, please contact your theme developer for more information.

Note that you need to have both WooBreadcrumbs in your options panel and the Yoast Breadcrumbs enabled for it to show up on your site.

Table of Contents

I have Yoast SEO or Yoast SEO Premium OnlyI have the WooCommerce SEO Plugin AND Yoast SEO or Yoast SEO PremiumHow Can I Stylize the Breadcrumbs or Output them Somewhere Else on my WooTheme?How Can I Enable the Breadcrumbs and Configure Them?

I have Yoast SEO or Yoast SEO Premium Only

If you want to use Yoast Breadcrumbs instead of the default WooBreadcrumbs, then you can add the code snippets here to your functions.php.

If you are not sure how to do this, please speak to your theme developer for more information or work with a Yoast Partner.

I have the WooCommerce SEO Plugin AND Yoast SEO or Yoast SEO Premium

If you have the Yoast WooCommerce SEO plugin (with either Yoast SEO or Yoast SEO Premium) add in the code snippets here and go to SEO-WooCommerce and be sure to leave the: Replace WooCommerce Breadcrumbs unclicked

If you have WooCommerce SEO AND a WooTheme leave this unclicked.

When that happens you should get one set of breadcrumbs, the Yoast SEO breadcrumbs.

How Can I Stylize the Breadcrumbs or Output them Somewhere Else on my WooTheme?

The code snippets here insert the code using the woocommerce_before_main_content hook. If you』d like the breadcrumbs in a different location, please locate the appropriate hook in the theme』s documentation and update the hook.

To style them in the same fashion as the original breadcrumbs, you may need to modify the line that starts with 『yoast_breadcrumb』 (line 22 in the code snippets) and/or add custom CSS styles.

If you are not sure how to do this, please speak to your theme developer for more information or work with a Yoast Partner.

How Can I Enable the Breadcrumbs and Configure Them?

Please refer to our guide here on how to do that.

Sitemap Error: Unsupported format HTML

Unsupported format. Your file appears to be an HTML page.

Possible causes

Wrong sitemap URL submittedSitemap displays an errorSitemap redirects to a pageHidden video sitemap is cached

Was the correct sitemap URL submitted?

The Yoast SEO sitemap URL to submit ends in sitemap_index.xml. If you submitted sitemap.xml, please remove it and submit the correct sitemap.

Does the sitemap error?

Open the sitemap in a browser. Remember, the Yoast SEO sitemap URL to submit ends in sitemap_index.xml. Does an error appear? If so, search our list of common sitemap errors for additional steps.

Sitemap redirects to another page

Redirects can come from WordPress (core, theme or plugins) and your server (htaccess or webhost control panel). A conflict check can help narrow down where the redirect is located so you can remove or modify the redirect.

Hidden Video Sitemap is cached

Typically this happens with video sitemaps when you』re running W3 Total Cache and you』ve ticked the setting to hide the sitemap from normal visitors. What W3TC does is cache the error which normal visitors get, if they want to view the video XML sitemap. This error is then also served to googlebot, because the logic to show the sitemap to googlebot won』t execute. The best way to fix this is to create an extra user agent group.

You can create this user agent group by going to the W3TC』s settings. Under Performance and then User Agent Groups there』s a button 「Create a group」. Click this button and call your group 「Google」 or 「Googlebot」 and then in the user agents field you just enter 「googlebot」. This will force W3 Total Cache to make a separate cache for Googlebot user-agents.

Another option is to prevent W3TC from caching video-sitemap.xml entirely by excluding the sitemaps, but since that』s slower, we actually prefer the user-agent group.

My sitemap is giving a 404 error, what should I do?

Is your sitemap giving a 404 error? This article will take you through the steps you should follow to fix this error. 
First of all, let us be clear that this is usually not due to our plugin, but due to poorly coded themes and/or other plugins. A 404 error basically means that the sitemap index or individual sitemap does not exist for a variety of reasons.
You can solve the 404 error by following these steps:

Permalink structure
Missing content
Rewrite rules
Check to see if sitemaps have been enabled

1. Update the permalink structure

First of all, sometimes resetting the permalink structure will quickly solve a 404 error from a recent change to your installation. Go to Admin > Settings > Permalinks and click save without altering anything. For more, information, see this how-to guide.

2. No content for the sitemap

Second, check that items exist in order to create the individual sitemap. For example, a category sitemap requires categories with published content. If the items do not exist, exclude the post type or taxonomy from the sitemap until you create content. For more information, see this how-to guide.

3. Rewrite rules are missing

If you still receive a 404, check the rewrite rules for your server. If you are not sure how to check for the rules below, which server you are using, or how to enter them, please contact your host provider.

Using Apache server

This article has more advice on troubleshooting the sitemaps on Apache servers: Yoast XML Sitemaps on Apache servers.

Using NGINX server

This article has more advice on troubleshooting the sitemaps on NGINX servers: Yoast XML Sitemaps on NGINX servers.

Can I Change The Sitemap Change Frequency?

This is an optional sitemap field to describe how often a URL is likely to be updated.

We』ve decided to remove the change frequency from our XML Sitemaps in the 3.5 version of Yoast SEO as Google has said publicly that they don』t use them on most sites.

Sitemap Error: Incorrect namespace

The error:

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.

However, we have seen a few cases where WP Engine』s HTML post processing feature contains a line (similar to the examples below) that when removed resolves this issue but may break other things on your site. Please contact WP Engine for advice on how to exclude the sitemap namespace from this command.

#http://# => // #http://# => https://

Yoast SEO is changing my slug!

This should no longer occur when you are using the most recent version of Yoast SEO. This used to be a feature called clean slugs which automatically removed stop words from the generated slug. It has always been bug prone and is not really important for SEO anymore, so we removed it in Yoast SEO 7.0.

What is this 「slug」 thing you talk of?

The slug is the part of the URL that distinguishes the post or page, so in this URL http://example.com/hello-world/ the slug is hello-world.

Why does my podcast or RSS feed stop working when the Video add-on is enabled?

This is an issue we』ve built a manual fix for, just for the people with this problem. We』ve implemented a setting you can simply turn off, and it』ll make sure your RSS and podcast will keep working.

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 『Video SEO』. The 『SEO』 settings will expand providing you additional options. Click on 『Video SEO』. Toggle the 『Disable Media RSS Enhancement』 checkbox. To enable the feature, uncheck the box.To disable the feature, check the box. Click 『Save Settings』.

How Do I Change the WooCommerce Shop Page meta data?

You can change the title or meta description for your WooCommerce shop page directly in the Snippet Preview on the WooCommerce shop page. To change the breadcrumb title, please follow these steps. 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 additional options. Click on 『Search Appearance』. Click on 『Content Types』. Expand the 『Product』s post type. Scrolling to the 『Products』 post type and expand the post type by clicking the arrow. Click the link to edit your shop page. Near the bottom of the box, you will see a heading 『Settings for Products archive』. Click the link to edit your shop page. In the Yoast SEO snippet preview, click 『Edit snippet』. Add or change the SEO title and meta description. Click 『Update』.

Yoast SEO for Drupal

Despite being built using YoastSEO.js, this module is no longer affiliated with Yoast. For further support please visit https://www.drupal.org/project/yoast_seo.

Missing or Invalid Date in XML Sitemap

Google Search Console (former Google Webmaster Tools) may flag your sitemap for a missing or invalid date in your sitemap.

Missing date on the sitemap index

An empty or missing date in the sitemap index typically means the individual sitemap is not available. Opening the individual sitemap with the missing date will display a 404 error. Please customize the sitemap and remove post types or taxonomies you are not using on your site.

Missing date on individual sitemaps (excluding the video sitemap)

An empty or missing date on an individual sitemap typically indicates an invalid timestamp in your database. Adding, updating and removing a minor change will refresh the date. Open the post displaying the invalid date in edit mode. Make a minor change to the content. For example, add 「This post has been updated.」 to the top of the content. Update the post to save changes. Remove the minor change you made in step 2. Update the post to save changes. Repeat steps 1-5 for all URLs with invalid dates. Purge cache, if applicable.

Missing date on the video sitemap

An invalid date in the sitemap typically indicates a miscommunication between our plugin and the WordPress database. Removing, updating and re-adding the video will refresh the date.

Open the post displaying the invalid date in edit mode.Remove the video.Update the post to save changes.Re-add the video.Update the post to save changes.Repeat steps 1-5 for all videos with invalid dates.Purge cache, if applicable.

We understand the above steps are tedious for sites with a large amount of videos with invalid dates. We are investigating alternative options at this time.