Yoast SEO 文档

Configuration guide for Yoast WooCommerce SEO

Once you』ve set up the Yoast WooCommerce SEO plugin, you』ll want to set things up so they work the way you want them to.

Brand, Manufacturer, and ColorYoast SEO Breadcrumbs Replaces the WooCommerce BreadcrumbsAdminProduct identifiersPinterest Rich PinsXML SitemapsSchemaMetabox Notifications

The Yoast SEO: WooCommerce settings page is located under SEO → WooCommerce SEO 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 『WooCommerce SEO』. The 『SEO』 settings will expand providing you additional options. Click on 『WooCommerce SEO』.

Brand, Manufacturer, and Color

There』s also a feature for improving the output of Schema and OpenGraph markup. This allows for (among other things) better sharing on Facebook.

The Yoast WooCommerce SEO plugin will add the 「Brand」 attribute as a 「product:brand」 tag in the source code of the product page. It will also add the 「Manufacturer」 and 「Brand」 attribute as schema attributes to the product page. This will help show rich snippets in Google for products.

The Color attribute describes the color of your product. That can help clients filter the results, to get their desired color.

To make WooCommerce SEO output these tags you will need to add attributes to your products. To learn more about the Brand, Manufacturer, and Color schema and how to set it up visit: How to Add Custom Attributes to your Products.

For a full review of what is outputted when you add a video on a page see our WooCommerce SEO Schema Documentation Guide. 

Yoast SEO Breadcrumbs Replaces the WooCommerce Breadcrumbs

Note: This section is only displayed when you have enabled breadcrumbs in our WordPress SEO plugin.

Enabling this will make sure your website is outputting the Yoast SEO breadcrumb, instead of the WooCommerce breadcrumb. The advantage is our breadcrumb is better customizable and gets picked up by search engines better. And all that at the tick of a box:

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.

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 SEO Title with one that shows the breadcrumb pathway.

Yoast SEO Breadcrumb pathway as shown in Google.

How do I further Customize the Yoast SEO Breadcrumbs?

You can do so by examining the filters and links on our Implement Yoast SEO Breadcrumbs page.

Admin

The last option is eally simple. If you want the WooCommerce meta box to show up above the Yoast SEO meta box, tick the box next to Move WooCommerce up:

Product identifiers

You can also find some of the plugin settings when you are adding a new product. If you click on the Yoast SEO tab in the Product data meta box, you will see some input fields that allow you to add product identifiers.

If your products have any of the listed unique identifiers you can add them in the appropriate field. Yoast SEO will use them in your Schema and OpenGraph output.

Pinterest Rich Pins 

The plugin will output WooCommerce』s price, currency and availability meta data for use with Pinterest』s Rich Pins. Below is the meta data that the WooCommerce SEO plugin outs:

In order to get rich pins you will need to valid and apply for them. Please use this guide here for more information: Rich Pins for My Site.

XML Sitemaps

The Yoast WooCommerce SEO plugin also does some things automatically, like removing stuff from the XML sitemaps that doesn』t belong there like WooCommerce』s Cart, My Account and Checkout pages. 

It also adds images from the Product Gallery into the sitemap.

Schema

WooCommerce SEO outputs several schema types based on the information you enter into WooCommerce. For full listing of all the schema types see: WooCommerce SEO Schema Documentation

With aggregateRating schema you need to have at least one review before the plugin can output it.

Metabox Notifications

The WooCommerce SEO adds additional checks in the metabox area of the Yoast plugin.

It will output a singular check for length in the short product description area. Specifically, it looks at word count and considers 0 as having no words, 1-19 as short, 20-49 as good, and 50+ as long. 

If you added a product gallery the plugin will check it for alt-attributes.

However, with regards to setting up the plugin: you』re done! Have fun with it!

Twitter Product Cards

Twitter no longer supports product cards. Learn more directly from Twitter here.

How to clear your browser』s cache

Internet browsers are trying to give you the best and smoothest experience on the web they possibly can. This is done in a lot of different, very smart ways you usually won』t notice. Caching pages and scripts is one of them.

What』s the problem?

However, that same mechanism that is making pages you visit (regularly) so blazing fast to load, can also cause trouble. Caching is basically 『saving the current state a file, so it can be accessed really quickly later on』. Your browser caches a lot of images and scripts used on the websites you visit, to make sure that you get a smooth experience.

Usually when such an image or script is updated, the cached (saved) file is removed and the new version gets downloaded. Unfortunately, sometimes your browser doesn』t clear a cached version, and as a result doesn』t download the updated version of that file. This can cause all sorts of strange problems.

How to fix it?

Luckily, all browsers have an easy mechanism of forcing a refresh of the cached information for a certain website.

ChromeFirefoxInternet ExplorerEdgeSafariOpera

My browser is not listed above?

If your browser is not listed above, you could check out this page about clearing cookies in different browsers. You could also consult your browser』s help file for information on clearing cache and cookies. Alternatively, you can try Refresh Your Cache or search in Google for how to clear cache and cookies in [browser_name].

I cleared the browser』s cache, now what?

Your browser should now have downloaded the latest version of all the files, potentially solving quite a few issues.If there are still things you need help with, please contact us through the appropriate channels.

Sales tax/VAT handling by Yoast.com

Table of contentsSales tax in the USA Economic Nexus LawsVAT in the EUVAT in the UKSales tax/VAT in other countriesIs your organization tax exempt?

VAT stands for Value-Added Tax, also known as sales tax in the USA. Different countries apply different VAT or sales tax values. We calculate the VAT/sales tax automatically based on the address you enter when you purchase a product on yoast.com.

Sales tax in the USA 

Economic Nexus Laws

With the implementation of the economic nexus in 2018 in the US for sales tax, businesses outside the US become tax liable after reaching a certain threshold of sales. As of January 2021, Yoast may have reached this threshold in your State. If that』s the case, we』re therefore obliged to collect sales tax, resulting in a slight increase in the price of our products. For more information on sales tax and sales tax nexus, please read this article.

Updated October 2020 | Source: https://blog.taxjar.com/economic-nexus-laws/

VAT in the EU

We』re obligated to charge VAT for everyone who lives or has their company in the EU. The VAT is automatically calculated based on the country you select during checkout. There, you can also select whether you』re a person or a company. When selecting 「company」 you will be able to enter a VAT number which will then be displayed on the invoice you』ll receive. When entering a valid VAT number, VAT won』t be charged.

There』s one exception to this rule: If you』re from The Netherlands, you』ll always have to pay VAT (BTW) since the company Yoast is based in The Netherlands.

Why is my VAT number rejected? We validate your VAT number in the checkout. If it』s rejected, you can read about the most common reasons for that here.

VAT in the UK

As of January 1st, 2021, if you』re located in the UK, you are required to pay UK VAT on all purchases made on yoast.com, even though we are based outside the UK, per UK government regulations. At this moment, you cannot apply for tax exemption on yoast.com if you』re located in the UK, as the HMRC provides no way for us to validate your business records.

Sales tax/VAT in other countries

If you』re located in a country outside of the USA, UK or EU, you won』t have to pay VAT when buying our products.

Is your organization tax exempt?

If your organization is exempt from sales tax, please follow the instructions here to get tax exempt status, so that we can update your account accordingly.

How to find the correct custom field name

The Yoast SEO and the Video SEO plugins can scan the content of your custom fields. However, they do not do it automatically. If there is a particular custom field you want the plugins to scan, you will need to add it to the plugin』s settings. To do that, you will need to find the custom field name. In this post, we show you how.

Before you go searching for the custom field name, you first need to know the post or page ID. You can find it in two ways:

1. Hover over the post in the Posts overview screen. You will see an address in the bottom left corner. The post id is the number that is shown after post=. In the example below, the post ID is 97.

2. When you are editing a post in the post editing screen, look at the address bar. The post id, like in the previous example, is 97.

How to find the custom field name

To find out the name of your custom field, you will need to download and install the Custom Field Finder plugin. Log in to your WordPress website. When you』re logged in, you will be in your 『Dashboard』. Download, install, and activate the Custom Field Finder plugin. Click on the Tools menu item in the Admin menu. The Tools screen opens, and the menu under the Tools menu item expands. Click on the Custom Field Finder item in the expanded Tools menu. The Custom Field Finder screen opens. Enter the page or post ID in the input field, and click 『Find custom fields』. Find the custom field name. You will see a list of custom fields you are using. You need to look for the custom field name in the column titled Key.

How to add the custom field to Yoast SEO and Video SEO

After you have the custom field name, you can add it to Yoast SEO and Video SEO, and its content will be analysed by the plugins. To do that, follow the steps in these guides:

Video SEO: Find the custom field that has the video URL or ID in it, copy the key, and enter it into the Video SEO plugin settings.

Yoast SEO: Find the custom field you want Yoast to scan, copy the key, and enter it into the Yoast SEO plugin settings.

Couldn』t find a custom field with the correct information? Don』t fret, you can create your own.

How to install Yoast SEO for WordPress

Note: This is the installation guide of the free Yoast SEO plugin. If you』re looking for the installation guide of Yoast SEO Premium, please go here.

Thank you for choosing Yoast SEO for WordPress for your website!

Time needed: 5 minutes. Installing Yoast SEO is easy, just follow these simple steps: Log in to your WordPress website. When you』re logged in, you will be in your 『Dashboard』. Click on 『Plugins』. On the left-hand side, you will see a menu. In that menu, click on 『Plugins』. Search for 『Yoast SEO』 Click on 『Add New』 near the top of the screen. Type 『Yoast SEO』 in the search bar. Install the plugin Searching will give you a page of search results. Our plugin should be visible now. Click the 『Install Now』 link to start installing our plugin. Activate the plugin Once the installation has finished, click the 『Activate』 button. It has appeared where the 『Install Now』 button was previously located. You』re done! You can now go and configure the plugin.

Installing Yoast Using File Transfer Protocol (FTP)

In some cases you may need to install using FTP. This guide explains more: How to Install Yoast SEO using FTP.

How to use the import and export functionality in Yoast SEO

With the import and export functionality of Yoast SEO and Yoast SEO Premium you can easily use similar Yoast SEO settings on multiple websites, for instance. Read how to use it here.

There are multiple options for importing data into the Yoast SEO plugin. 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 『Tools』. The 『SEO』 settings will expand providing you additional options. Click on 『Tools』. Click on 『Import and Export』.

Yoast SEO (free version)

You will see the following import and export options for Yoast SEO:

Import Yoast SEO settingsExport Yoast SEO settingsImport from other SEO pluginsAll in One SEOGreg』s High Performance SEO 5HeadSpace2 SEOJetPack『s SEO modulePlatinum SEO Pack 5Premium SEO Pack 5SEO Framework 5SEOpressorSEO UltimateSmartcrawl SEO 5Squirrly SEO 5WooThemes SEO FrameworkWP Meta SEO 5wpSEO.deRank Math 7

Yoast SEO (premium version)

You will see additional import and export options for premium plugins:

All Yoast SEO options above, plusImport redirectsRedirectionSafe Redirect Manager 1Simple 301 Redirects 1CSV file 3.htaccess fileExport redirects 2Export keyphrases 4Local SEO  6

1 Requires Yoast SEO Premium 4.0 or newer2 Requires Yoast SEO Premium 5.3 or newer3 Requires Yoast SEO Premium 5.4 or newer4 Requires Yoast SEO Premium 5.5 or newer5 Requires Yoast SEO (free or premium) 7.3 or newer6 Requires Yoast SEO: Local any version7 Requires Yoast SEO (free or premium) 12.3 or newer

News sitemap doesn』t work when I have Custom Post Type 『News』

Note: The default Yoast-News-Sitemap will only show if you have a published news article within the past 48 hours. You may need to publish a post-type in order to generate that sitemap.

Yoast SEO: News will automatically detect a naming collision and change the news sitemap name. Please go to Admin > SEO > News SEO and click the 『XML News sitemap』 link to get the correct sitemap URL.

If you prefer to give your news sitemap a custom name, please use the developer filter discussed below.

How to Change the News Sitemap URL

Disable the sitemap feature. Disable all sitemaps by following the steps in this article. Add the filter in your theme』s functions.php file. See the example code below. Enable the sitemap feature. Enable all sitemaps by following the steps in this article.

This will create two sitemaps; one for the news custom post type and one specifically formatted to meet Google News guidelines.

News Post Type = www.example.com/news-sitemap.xml Google News Format = www.example.com/google_news-sitemap.xml

You or your developer can use a filter to change the name of the Yoast SEO news sitemap. An example of how to use this filter is below.

/* Change Yoast News sitemap when custom post news conflicts */
function wpseo_change_news_sitemap() {
return "google_news";
}
add_filter('YoastWPNewssitemap_name', 'wpseo_change_news_sitemap');

The following required properties are missing: fb:app_id

Facebook』s Sharing Debugger tool helps you preview how your content might look when shared on Facebook. It also shows errors or warnings when you have problems in your code which might impact how your content performs.

One of the things the tool looks for in your code is a fb:app_id meta tag. When that tag is missing, you get the following message:

「The following required properties are missing: fb:app_id「

If you』re seeing this warning, then don』t worry. Your code is correct, and your shared content will display properly.

The fb:app_id meta tag is not required. In fact, it doesn』t do anything, and hasn』t for years.

That』s why we removed support for it from Yoast SEO 15.5, and why you might have started seeing these 『warnings』 for the first time.

Table of contentsWhat does (did) the fb:app_id tag do?The short answerThe longer answerWe removed fb:app_id from Yoast SEOHow to remove the warningAdding the fb:app_id tag (back) inUsing Facebook』s 「default APP ID」

What does (did) the fb:app_id tag do?

The short answer

The simple answer is, 「nothing」. You can ignore the warnings in the Sharing Debugger tool.

The longer answer

The longer answer is that the fb:app_id tag used to be part of Facebook』s 『Domain insights『 product. When users 『liked』 your content (using an embedded like button on your webpage), the app_id value let Facebook know which Facebook Page should be able to see and access the relevant statistics.

The Domain Insights product no longer exists, though. The analytics capabilities that the fb:app_id tag provided are now part of Facebook』s Analytics platform, and require you to install a Facebook Pixel instead of a fb:app_id meta tag.

Facebook starting closing the Domain Insights platform in 2016, and replaced it with Facebook Analytics

You can read more about Facebook』s retirement of Domain Insights in this article.

Older versions of the error message also describe how the app_id tag was used attribute interactions with 『stories』 would be correctly attributed. Like Domain Insights, Facebook』s support for Open Graph Stories was ended (in this case, in 2018).

「Specify the app ID so that stories shared to Facebook will be property attributed to the app.」

You can read Facebook』s announcement for ending their support on this help page.

With the removal of Domain Insights and Open Graph Stories, the fb:app_id meta tag is no longer used anywhere in Facebook』s ecosystem.

We』re hopeful that the Sharing Debugger will be updated to remove this warning.

We removed fb:app_id from Yoast SEO

Yoast SEO used to provide a field which allowed users to add a fb:app_id value. When that was set, we would output a meta tag on each page, which looked something like . We removed this in version 15.5.

tSetting your Facebook App ID in Yoast

Removing this was a long-overdue change, as the tag had long since been unsupported. Additionally, obtaining an app_id value was complex and convoluted (involving creating a Facebook application, and linking it to your website). Our controls, the tag itself, and Facebook』s app creation process lead to a lot of user confusion, and a lot of support overhead for us.

The Yoast SEO plugin still manages and outputs the rest of your open graph meta data, though. It』s only the fb:app_id tag which we』ve removed.

How to remove the warning

Whilst we』re confident that the 『missing fb:app_id warning』 isn』t something that people should worry about, we recognize that some users might be uncomfortable seeing 『errors』 in the Sharing Debugger tool. If you』re still concerned about the message, you』ll need to 『fix』 it by (re)introducing an fb:app_id tag.

It』s our recommendation that you don』t follow these steps, and that no action is needed – despite the warning in the debugging tool.

Adding the fb:app_id tag (back) in

Since we completely removed support for the tag in Yoast SEO, you』ll need to use another approach to add it into your theme. Because we already output other open graph tags (like og:title and og:description), we don』t recommend another another plugin to reintroduce the fb:app_id tag. That』s likely to mean that you have duplicate open graph tags, which can lead to real warning and errors.

Instead of adding a plugin, we recommend that you add the tag via your theme』s functions.php file, or via your own custom plugin. You can use the following code as an example; though don』t forget that customizations to a theme may be overwritten if not handled properly (read more on preventing this by using a child theme).

function my_custom_function_name() {
$app_id = 966242223397117;
$tag = '';
echo sprintf($tag, $num);
}
add_action( 'wp_head', 'my_custom_function_name' );

Using Facebook』s 「default APP ID」

The $app_id value in our example above (966242223397117) is Facebook』s 「default APP ID」. This can be used by any website as a default, and will remove the error in the debugger.

If you have a Facebook app, you can replace that value and use your own application ID.

Why isn』t the plugin giving my lat/long coordinates?

The Cause

This is probably because your server doesn』t allow for any outgoing traffic.

The Solution

You can generate the coordinates yourself, by using Google Maps. This is how you can do it.

Go to Google Maps. Search the maps for the place you need. Right-click on the place and select What』s here?. You will see the coordinates on the left-hand side of the screen.

4. Copy the coordinates and paste them into the Local SEO settings page!

How to disable the Ryte indexability check

The Ryte indexability check is a tool in the Yoast SEO plugin, which checks if your site can be found by search engines. You can read more about what this tool does in our post about Yoast SEO & Ryte: Checking your site』s indexability.

Yoast SEO includes an option to check if your site can be indexed using the Ryte indexability check. This feature is enabled by default.

In rare cases, the Ryte indexability check may fail due to a communication or configuration error. As such, you may prefer to disable the check. In this article, we』ll explain how you can disable the Ryte indexability check.

To disable the Ryte indexability check, follow the steps below. 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 『Integrations』 tab.  Toggle the 『Ryte integration』 switch. To enable the feature, toggle the switch to 『On』.To disable the feature, toggle the switch to 『Off』. Click 『Save changes』.