max-video-preview 是 google 专属的 meta 标签,用于控制搜索结果中视频预览时长上限(单位秒),仅对含 videoobject 结构化数据的页面生效,合法值为 -1、0 或正整数,必须写在 head 中且 name 为 googlebot。

什么是 max-video-preview meta 标签
它不是 HTML 标准规范里的标签,而是 Google 搜索引擎(仅限 Google)识别的特殊 <meta> 值,用于控制视频在搜索结果中显示的预览时长上限(单位:秒)。只对被 Google 索引的、含结构化视频数据(如 VideoObject)的页面生效,普通页面加了也没用。
常见错误是把它当成本地播放控制或浏览器行为开关——它不影响页面内视频播放,也不被 Chrome/Firefox 解析,纯属 Googlebot 的索引提示。
max-video-preview 的合法取值和写法
必须写在 中,且值只能是以下三个之一:-1(禁用预览)、0(允许缩略图但不生成动态预览)、数字(如 30,表示最多截取前 30 秒生成预览)。不能写成字符串 "30" 或带单位 "30s"。
-
<meta name="googlebot" content="max-video-preview:-1">—— 完全屏蔽视频预览 -
<meta name="googlebot" content="max-video-preview:0">—— 只显示静态缩略图 -
<meta name="googlebot" content="max-video-preview:60">—— 允许最长 60 秒的动态预览片段
注意:name 必须是 googlebot,不是 robots 或 viewport;content 值里冒号前后不能有空格。
为什么加了没效果?常见失效原因
最常踩的坑是以为加了就立刻生效——实际上它依赖 Google 重新抓取并解析你的页面,且前提是页面已通过 Schema.org 标注了有效的 VideoObject。
- 没加
VideoObject结构化数据:Google 不知道哪段是视频,max-video-preview就无从作用 - 页面被
noindex或 robots.txt 屏蔽:Googlebot 根本没机会读到这个 meta - 用了错误的
name属性:比如写成name="robots",Googlebot 完全忽略 - 值超出范围:填了
120以上,Google 会静默降级为默认策略(通常 30 秒)
验证方式:用 Google Search Console 的「URL 检查」工具抓取后,看「增强功能」卡片里是否识别出视频,以及预览时长是否符合预期。
与 max-image-preview 和 max-snippet 的关系
它们同属 googlebot 的 content 控制指令,语法一致,但互不影响。可以共存:
<meta name="googlebot" content="max-video-preview:30, max-image-preview:large, max-snippet:-1">
注意逗号后不能有空格;max-snippet:-1 表示禁用文字摘要,但不会影响视频预览——这是独立控制项。混淆三者作用域,容易误判调试方向。
真正起效的前提始终是:Google 认定这是个视频页面,且你没用其他规则(比如 data-nosnippet)覆盖掉关键视频元素。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











