Yoast SEO 开发者文档 文档中心 › Yoast SEO 开发者文档

title: "Functional Specification" post_status: publish comment_status: open taxonomy: category: - yoast-developer post_tag: - Twitter - Features - Repos

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:

Tag Description Notes
twitter:creator The X handle of the content author. Only populated when the content author has a valid X handle.
Only populated on post types.
twitter:title The 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:description The 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:image The 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.

Tag Description Notes
<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.
← 返回文档中心