Yoast SEO 文档

How do I add a new WordPress admin user?

Adding a user with administrator rights in WordPress is fairly easy. We highly recommend creating a temporary, self-expiring admin user with the steps here. If you cannot install plugins, please use the steps below to create an admin user.

Table of contentsSelf-hosted WordPress siteWordPress.com siteSending your login details to the Yoast support team

Self-hosted WordPress site

Log in to your WordPress website. When you』re logged in, you will be in your 『Dashboard』. Click on 『Users』. On the left-hand side, you will see a menu. In that menu, click on 『Users』. Click 『Add New』. Across the top, click the 『Add New』 button. Fill out the form and set the role to Administrator. If you』re creating the account for us, please DO NOT check 『Send User Notification』. Click 『Add New User』. At the bottom of the form, click the 『Add New User』 button.

If you want us to be able to log in to your website, please copy the link to your admin login URL and the username in your email to us. Please do not include the password in your email to us. We will use the password reset feature to generate a password for our use.

For example:

Oh, and don』t forget to delete the account after your question has been answered!

You can learn more about WordPress user roles and a bunch of other WordPress related stuff in our free WordPress for beginners course.

WordPress.com site

To see a detailed guide on how to add users to your wordpress.com website, go to the article Invite users to your website. If you are experiencing issues with the assigned user roles, read the troubleshooting instructions for multiple users.

Sending your login details to the Yoast support team

The Yoast support team may ask you to create an account for them on your site, so they can help you with the question for which you』ve reached out. If you want the Yoast support team to be able to log in to your website, please copy the link to your admin login URL and the username in your email to us. Please do not include the password in your email to us. We will use the password reset feature to generate a password for our use.

For example:

Oh, and don』t forget to delete the account after your question has been answered!

Customize the author sitemap

Our plugin can create a sitemap that lists the author archive pages for sites with multiple authors. If you have a single author, please disable the author archives.

Table of contentsCustomize sitemapExclude individual authors featureExclude authors filter

Customize sitemap

After enabling author archives, you will have some additional options to customize the author sitemap.

Show author archives in search results
Yes. The author sitemap will be created.No. The author sitemap will not be created.
Show archives for authors without posts in search results.
Yes. All authors will be included in the sitemap.No. Only authors with published content will be included in the sitemap.Need to exclude individual authors?
Title & meta description templates
These will be used to generate the title and meta description of the author archive page.

Exclude individual authors feature

Excluding an individual author does not remove the author』s contents from other sitemaps.

After enabling author archives, you can prevent individual users from appearing in the author sitemap. Log in to your WordPress website. When you』re logged in, you will be in your 『Dashboard』. Click on 『Users』. On the left-hand side, you will see a menu. In that menu, click on 『Users』. Click 『Edit』 for the username of the user you want to exclude. Under 『Yoast SEO Settings』, check the 『Do not allow search engines to show this author』s archives in search results.』 box. Click 『Update User.』

Exclude authors filter

Yoast comes with the following filter:

wpseo_sitemap_exclude_author

This filter can be further used to customize the sitemap to exclude authors. It can be used to bulk exclude authors or exclude authors based on certain conditions. This will likely require some development work. If you are not sure how to use the filter, you may wish to work with a Yoast Partner who can assist.

Google Maps are not working

We highly recommend securing your API key to prevent others from using your quota. The downfall is that restrictions can cause the maps to fail. There is also the chance that the required service is disabled or returns an error.

Without the proper keys and restrictions, you』ll see the following error:

Oops! Something went wrong.This page didn』t load Google Maps correctly. See the JavaScript console for technical details.

Table of contents

Table of contentsDid I enter keys?How to regenerate a keyEnable keysPricing for APIsStill not working?

Did I enter keys?

How to regenerate a key

You may need to regenerate a key for a variety of reasons, especially if you notice another site is using your key.

Go to Google API Console.If prompted, log in.Select your site project.Click on the name column of the key you need to regenerate.Click 『Regenerate key』.Click 『Replace key』.Click 『Save』.

Don』t forget to copy and paste the new key into the Local SEO settings to avoid display issues. Learn how to set a new browser key or a new server key.

Enable keys

Please verify that the Google Maps JavaScript API (browser key) and the Geocoding API (server key) are enabled in the Google Maps API Manager.

Pricing for APIs

Pricing for the Google Maps, Routes and Places and the APIs connected with them (Maps JavaScript API, Directions API, Timezone API, Geocoding API ) is pay as you go, and you only pay for what you use. You get a recurring $200 credit on your billing account each month to offset your usage costs, and you can also set usage limits to protect against unexpected cost increases.

For a table of Google』s pricing, see Pricing for Maps, Routes, and Places. If you need to enable billing, please go to APIs and billing.

Still not working?

If you continue to have problems displaying the maps, please check your JavaScript console for the exact error message. Google lists errors and their explanations here.

Common subscription issues

A license key is no longer needed to use our premium plugins because we launched a customer portal where you can find and manage all the Yoast SEO products you own. If you don』t have an account yet or want to know how it all works, this guide will get you started. Below, we』ve listed some of the most common subscription issues and errors.

Table of contentsThe subscription is active in MyYoast but is does not show as active on your websiteSubscription Connection Errors500 status – Server error. Check logs for more details404 error403 error400 Bad requestssl3_read_bytes – stream_socket_client(): SSL operation failed with code 1. OpenSSL Error messages: error:14094410:SSL routines:ssl3_read_bytes:sslv3 alert handshake failure stream_socket_client(): Failed to enable crypto stream_socket_client(): unable to connect to ssl://my.yoast.com:443 (Unknown error)SSL23_GET_SERVER_HELLO – stream_socket_client(): SSL operation failed with code 1. OpenSSL Error messages: error:14094410:SSL routines:SSL23_GET_SERVER_HELLO:sslv3 alert handshake failure stream_socket_client(): Failed to enable crypto stream_socket_client(): unable to connect to ssl://my.yoast.com:443 (Unknown error)Server Connection Tests

The subscription is active in MyYoast but is does not show as active on your website

As part of changing to our customer portal, there are a number of reasons why the subscription will be active in MyYoast but not show active on your website. Please check the following:

Did you download and install the premium plugin?If not, please install the premium plugin. Our installation guides will walk you through the process.Is a supported version installed on your site?If your premium plugin version is below 5.x, please manually update to the current version to activate your subscription.Is the premium plugin installed into the correct folder?If you are unsure of the folder name, please remove the plugin, download a new copy from MyYoast, and install the premium plugin again. Your settings are stored in the database so you will not lose any information when you remove and reinstall the premium plugin.Are you using the correct URL in MyYoast?The URL in MyYoast needs to be the same as the one found in Settings -> General -> Site URL. Changing the URLs in the WordPress settings could break your site, so be sure to make a backup first!Are you using an older version of a previously managed by Yoast plugin such as Google Analytics by Yoast (now Google Analytics by MonsterInsights) or Post Connector?If so, please update to the most recent version of the plugin as some older versions interfere with the subscription activation verification process.Do you receive a connection error?If so, please see the section below.

Subscription Connection Errors

500 status – Server error. Check logs for more details

Cause Yoast SEO uses cURL to verify the plugin subscription. For communication to be successful, your web host must meet our premium plugin requirements.

SolutionPlease send the complete error to the support desk of your webhost. They should be able to help you fix this, since this is a server-issue. Or you can switch to another webhost.

404 error

CauseThe site isn』t listed in MyYoast or does not have an active subscription.SolutionAdd the site to MyYoast and/or connect the subscription.

403 error

CauseThe server cannot communicate due to a block.

SolutionPlease contact your web host for assistance.

400 Bad request

CauseYour Yoast version is outdated. Please check our change log for the most current version.

SolutionPerform a manual update of the plugin to the current version. You will need an FTP program such as FileZilla and your FTP details, which can be obtained from your host provider.

ssl3_read_bytes – stream_socket_client(): SSL operation failed with code 1. OpenSSL Error messages: error:14094410:SSL routines:ssl3_read_bytes:sslv3 alert handshake failure stream_socket_client(): Failed to enable crypto stream_socket_client(): unable to connect to ssl://my.yoast.com:443 (Unknown error)

Cause The error above indicates that your server may be running SSL v3. We require that your server does not use SSL v3.

SolutionPlease contact your web host for assistance with your server setup.

SSL23_GET_SERVER_HELLO – stream_socket_client(): SSL operation failed with code 1. OpenSSL Error messages: error:14094410:SSL routines:SSL23_GET_SERVER_HELLO:sslv3 alert handshake failure stream_socket_client(): Failed to enable crypto stream_socket_client(): unable to connect to ssl://my.yoast.com:443 (Unknown error)

Cause The error above indicates that your server may be running SSL v3. We require that your server does not use SSL v3.

SolutionPlease contact your web host for assistance with your server setup.

Server Connection Tests

In rare cases, there may be an issue with the communication between our server and your server. Unfortunately, unless you』re an administrator on the web server, you can』t solve the problems above yourself. You』d need to contact your web host and ask them to fix these issues.

If your web host is unable to resolve the issue, please ask your web host or server admin to provide us with the information listed below to help us identify where the connection issue occurs.

Server Information

Server IP(s) or IP rangeA cURL test from the server to https://my.yoast.com/(Command: curl -i https://my.yoast.com/ )A traceroute from the server to https://my.yoast.com/(Command: traceroute my.yoast.com )

Why is my video not detected?

Are you seeing the error message shown below, while you have added a video to your content? Then our plugin was not able to detect a video in your content. In this article, we』ll list possible reasons why our plugin couldn』t detect your video.

It looks like your content does not yet contain a video. Please add a video and save your draft in order for Video SEO to work.

Do you have a different question regarding the Video SEO plugin? Check our Video SEO FAQ.

Possible reasons and their solutions

1. Your video hosting platform is not supported.If you』re using a video hosting platform that isn』t supported by Video SEO, our plugin might not be able to detect your video. You can find the full list of supported video hosting platforms here.

2. Your video is set to private.If your video is set to private, the plugin cannot read its data. We』ve created a work-around for this, which you can find in this article on indexing private videos with Video SEO.

3. You』re using a visual page builder to add the video.Some page builders are not natively compatible with the Video SEO plugin.

4. You』re using a custom field to add the video.See how the Video SEO plugin works with custom fields.

How to change the XML video sitemap URL

You can change the XML video sitemap URL by following the steps described below.

Do you have a different question regarding the Video SEO plugin? Check our Video SEO FAQ.

Disable the sitemap feature. Disable all sitemaps by following the steps in this article on XML sitemaps. 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:

an XML sitemap for the video custom post type (www.example.com/video-sitemap.xml)an XML sitemap specifically formatted to meet video sitemap guidelines (www.example.com/vsvideo-sitemap.xml)

The filter

You should add the following filter to your theme』s functions.php file. You can replace vsvideo with your preferred choice.

define ('YOAST_VIDEO_SITEMAP_BASENAME', 'vsvideo');

How to create Custom fields to use with Video SEO or Yoast SEO

In WordPress, Custom fields are hidden by default. So, before you can create custom fields, you will need to enable them.

To enable Custom fields in the post and pages editing screen, click on the three vertical dots in the top right corner. That will open the More tools & options menu (1 in the image below). Then, click Options at the bottom of the menu (2 in the image below). Finally, check the box next to Custom fields (3 in the image below). The Custom fields will be added. You can find them at the bottom of your Post or Page editing screen.

Once you create a custom field, you can reuse the same field in other posts. All you need to do is select the field from the Name drop-down instead of creating a new one each time.

How to create Custom fields

Open the Post or Page editing screen. Scroll down to the Custom Fields section. Click Enter new. Add a name and value for the content. Enter a recognizable and reusable custom field name under the Name. Enter the full URL to the video for this page/post in the Value input field. Or add in your content you want Yoast SEO to scan. Click Add Custom Field』

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

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

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

Yoast SEO: Copy the key of the custom field you want Yoast to scan, enter it into the Yoast SEO plugin settings.

How do Yoast SEO and Video SEO work with Custom fields?

With the Custom fields in WordPress, you can add additional metadata to your posts. It is also possible to display the metadata on your website. However, to do that, you will need to edit your theme files. Both Video SEO and Yoast SEO can scan designated custom fields. In this post, we outline what you need to do to enable our plugins to scan the content of your custom fields.

Table of contentsFind the custom field nameCreate a custom field Add custom fields to the Video SEO plugin settings Add custom fields to the Yoast SEO plugin settingsRead more

Find the custom field name

To add a custom field to Video SEO or Yoast SEO, you need to know its name. You might be using a lot of custom fields, which would make it harder to remember all of their names. To help you, we wrote a post with a step-by-step guide on how to find a custom field name.

Create a custom field

You can also create new custom fields, and then add them to the Video SEO or the Yoast SEO plugin. You can learn how to do that in our guide on creating custom fields.

Add custom fields to the Video SEO plugin settings

Video SEO can scan the video content of your custom fields. It is possible to add multiple custom fields in the plugin settings. To learn how to add custom fields to Video SEO, go to the post – Add custom fields to the Video SEO plugin settings.

Add custom fields to the Yoast SEO plugin settings

Yoast SEO can also scan the content of your custom fields. In this post, you can learn how to add custom fields to Yoast SEO.

Following the steps above should make it easy for you to add custom fields to our plugins. Good luck!

Configuration guide for Video SEOConfiguration guide for Yoast SEO

How to index private videos with Video SEO

Currently, our Video SEO plugin doesn』t work with private videos if they are set to private before the video is indexed by the plugin. Unfortunately, the plugin cannot read the data from a private video. We』re working on a solution for this. In the meantime, we have a work-around for you, which we』ll discuss in this article.

Do you have a different question regarding the Video SEO plugin? Check our Video SEO FAQ.

Change the privacy settings of the video(s) in the video hosting platform to 『public』. Reindex the videos in the plugin using 『Force reindex of already indexed videos』. Check the box for 『Force reindex of already indexed videos』. Then click 『Re-Index Video』s. Change the privacy settings of the video(s) in the video hosting platform to 『private』 again.

Please note that every time you do a forced reindex of already indexed videos, you must first change the videos to public.

The breadcrumbs title setting

With the Advanced tab in Yoast SEO, you can determine how search engines crawl and index your post or page and what your breadcrumbs will look like on your site and in the search results. In this article, we』ll explain the breadcrumbs title setting.

What are breadcrumbs? Why are they important for SEO?How to implement Yoast SEO breadcrumbs

Using the breadcrumbs title setting

The breadcrumbs title setting allows you to change the breadcrumbs title for the Yoast SEO breadcrumbs. Each breadcrumb level can be changed on the corresponding post, page, taxonomy or custom post type on the Advanced tab of the Yoast SEO meta box. With these settings you can also change the title of the breadcrumbs you』ve added with the Yoast SEO breadcrumbs block.

On the Advanced tab in the Yoast SEO meta box and sidebar, you』ll find a field called 『Breadcrumbs Title』 (see image below). If you have enabled breadcrumbs, you can change the breadcrumb title by filling out your custom title in this field. Then, click 『Update』 to see the changes on your post or page.

In the rest of this article, we explain how you can change the title in custom post type archives, and WooCommerce shop pages.

Custom post type archives

Some custom post types have a custom archive page and you can change the breadcrumb title in the Yoast SEO settings under SEO → Search Appearance → Content Types.

WooCommerce shop page

If you are using WooCommerce, you will also see a Products custom post type in the Search Appearance settings. Follow the steps below to change the breadcrumbs title of your Product post type.

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 the 『Content Types』 tab.Expand the 『Product』 post type and click the link to edit your shop page.Scroll to the 『Products』 post type and expand the post type by clicking the arrow. Near the bottom of the box, you will see the heading 『Settings for Products archive』. Click the link to edit your shop page.Expand the 『Advanced』 section and change the title.Scroll to the Yoast SEO meta box or go to the Yoast SEO sidebar and click on the 『Advanced』 section to expand it. If you have enabled breadcrumbs, you can change the breadcrumb title here.Click 『Update』.