结构化数据标记
结构化数据标记
结构化数据标记用于自动向页面插入 JSON-LD 格式的结构化数据,帮助搜索引擎理解网站内容。
入口路径
后台顶部菜单 →「功能」→「SEO/GEO」→「结构化数据标记」。实际地址:/system/plugin/seo/jsonld,需要管理员权限(canAdmin)。
功能说明
页面只有一个开关。开启后,系统会自动把网站的结构化数据以 JSON-LD 格式插入页面底部,无需手动修改模板。
界面截图

设置项说明
| 设置项 | 作用 | 取值 / 默认 | 怎么选 / 填写建议 | 影响 / 注意 |
|---|---|---|---|---|
| 开启结构化数据标记 | 是否自动插入 JSON-LD | radio:否 / 是;源码未注明默认值 [源码] | 希望搜索引擎更好理解内容时开启 | 开启后页面底部自动插入,模板中不要重复写 |
配置项详解
结构化数据类型的选择
出现条件:开启结构化数据标记后,模型数据结构与各分类数据结构可配置 list_type 与 schema_type [源码]。
list_type 3 项:CollectionPage(分类/集合页)、ItemList(简单条目列表)、DetailedItemList(详细内容卡片列表)[源码]。
schema_type 20 项:Article、Product、ScholarlyArticle、BlogPosting、NewsArticle、WebPage、ItemPage、Recipe、Course、FAQPage、HowTo、Event、Person、Place 等 [源码]。
推荐值:文章用 Article、产品用 Product、常见问题用 FAQPage;非 VIP 部分类型不可选。
填错后果:类型与内容不符会影响搜索引擎富摘要展示,不会导致功能故障。
数据类型与联系方式
出现条件:data_type 选择组织机构或个人时显示对应字段 [源码]。
data_type=1组织机构:组织类型 15 项(含 LocalBusiness 本地商家等)、名称、法定名称、URL。data_type=2个人:姓名、职位、图片。- 两者共用:联系类型 12 项、联系号码(disabled,需到联系方式设置修改)、联系 URL、Logo 图片(尺寸须 160×50 或 600×60)[源码]。
- 本地商家(LocalBusiness)另需营业时间、价格区间、经纬度、地址等 [源码,VIP]。
填错后果:Logo 尺寸不符或联系方式缺失会导致结构化数据校验不通过。
操作步骤
- 进入「功能 → SEO/GEO → 结构化数据标记」。
- 将开关设为「是」。
- 点击「提交」保存。
- 查看前台页面源代码,确认已输出 JSON-LD 脚本。
适用场景与建议
- 希望通过富摘要(Rich Results)提升搜索展示效果的站点建议开启。
- 具体支持的标记类型可参考 Google 结构化数据文档。
注意事项
- 自动插入的标记由系统生成;如需自定义字段,使用
jsonLd标签覆盖同名字段,不要在模板里另起一套重复的结构化数据。 - 开启后如果前台源代码看不到 JSON-LD,先清理缓存再检查。
前台调用示例
开启后台功能后,页面默认插入名为 json-ld 的结构化数据标签。需要更自由地控制内容时,可以用 jsonLd 标签包裹自定义字段;自定义字段与默认字段同名时会覆盖默认值:
{% jsonLd %}
{
"author": { "@type": "Person", "name": "示例作者" },
"images": ["{{ siteLogo }}"]
}
{% endjsonLd %}
自定义内容必须符合 JSON-LD 语法,字段说明见模板标签手册的 jsonLd 标签。
相关文档
- LLMs 配置
- 模板标签手册中的
jsonLd标签 - Sitemap 管理
- 首页 TDK 设置