跳到主要内容

Functional Specification

This documentation provides technical information about which X tags Yoast SEO generates and outputs. These tags are only consumed by X.

We output a variety of <meta> tags for X in the <head> of each page, in order to better inform X about the content of the page in question.

Note that for a lot of tags, X falls back on OpenGraph metadata. Where it falls back, we provide the OpenGraph metadata and don't provide the X tag specifically unless it has been customized.

X 元数据​

以下标签为社交网络和平台（如 Facebook、X、Pinterest）提供关于页面及其内容的额外信息。

假设相应的管理员设置未被禁用，这些标签将在所有页面上输出（单独描述的 error 模板除外）。

标签描述
twitter:card预览页面时使用的卡片类型（默认为 summary_large_image）。
twitter:site网站所有者/运营者的 X 账号。

Conditional tags​

The following tags are only output when their conditions are met:

TagDescriptionNotes
twitter:creatorThe X handle of the content author.Only populated when the content author has a valid X handle.
Only populated on post types.
twitter:titleThe title of the page, specifically for sharing on X.Only populated when a specific value (which is different from the og:title value) is defined for X.
twitter:descriptionThe description of the page, specifically for sharing on X.Only populated when a specific value (different from the og:description value) is defined for X.

The hierarchy for this is as follows:
  • A user-defined "X description" value for the page.
  • An auto-generated "Social description" from the template in Search Appearance.
  • No output, i.e. falls back on og:description.
twitter:imageThe URL of the primary image of the page, specifically for sharing on X.Only populated when a specific image (different from the og:image) is defined for X, or, when Facebook / og:image tags are disabled.

  • A user-defined “X image” in the Social tab of the Yoast metabox in a twitter:image tag
  • A user-defined “Facebook image” in the Social tab of the Yoast metabox in an og:image tag
  • A user-defined “Featured image” for the page (in an og:image tag, or in a twitter:image tag if Open Graph is disabled)
  • A prominent image from the page’s content. (in an og:image tag, or in a twitter:image tag if Open Graph is disabled) — when that image is resized in the content, we show its full-sized counterpart (this isn't true when indexables are disabled)
  • Yoast SEO WooCommerce only: Woo SEO adds one more image fallback: the first image in the Woo Product gallery. (in an og:image tag, or in a twitter:image tag if Open Graph is disabled)
  • The “Social default image” from the template in Search Appearance in an og:image tag
  • The site-wide Social default image from SEO > Social in an og:image tag
  • No output.
In case of an author archive, the image is based on the following hierarchy:
  • The “Social default image” from the template in Search Appearance in an og:image tag
  • The user’s Gravatar image (in an og:image tag, or in a twitter:image tag if Open Graph is disabled)
  • No output, i.e. falls back to og:image.

"Enhanced Slack sharing" tags​

We utilize X's "label/data" meta tag format to add additional data, which is shown when sharing URLs on Slack. Note that this should only be output if the "Enhanced Slack sharing" setting is enabled for the site.

TagDescriptionNotes
<meta name="twitter:label1" content="Est. reading time" />Only output on post and page types.
<meta name="twitter:data1" content="%x% minutes" />Where %x% is the estimated reading time, rounded down to the closest minute.