Shopify Collection 集合页配方索引

collection template type 渲染一个集合及其商品列表，默认路径为 /collections/{handle}。集合是商品的分组资源，集合页是它在店面上的呈现；集合成员、发布范围与菜单入口是三件事，排查见集合与发布。

本索引只收录由 collection type 承载的两种业务页面。检索路径与 Page 索引一致：

collection → 可选 alternate → 业务页面 → 页面内容清单 → 内容 × 展现 → Theme 实现

按顾客任务选择页面

选择判据：集合对应稳定的商品分类、顾客主要靠筛选和排序缩小范围，用品类集合页；集合由有期限的活动或编辑主题驱动，页面需要先讲清主张与条件，用活动与编辑型集合页。活动只需要讲述、不需要商品列表的能力（筛选、排序、分页）时，改用 Page 承载的活动落地页，两者的分工见活动配方。

先判断是否需要 alternate

默认 collection.json 已能表达的页面，不需要 alternate。只有某类集合稳定需要不同的页面组成（例如活动集合需要额外的活动模块）并会复用时，才建立 alternate。命名、分配和例外见 Template type 与 alternate template，此处不复制。

alternate 怎样分配给集合

• 命名格式为 template-name.template-suffix.template-file-type，集合的例子是 collection.campaign.json；后缀是主题自己的命名。可在本地开发、主题代码编辑器或主题编辑器中创建（alternate templates 页）。
• 帮助中心写明：在后台进入 Collections，选择具体集合，在「Theme template」下拉菜单中选择模板并保存（帮助中心模板页，该页对集合、商品与页面通用）。因此分配发生在集合资源上，多个集合可以共用一个 alternate。
• collection.template_suffix 在未分配时为 nil，可用来确认某个集合当前使用哪个后缀（Liquid 对象页）。
• 预览可在集合地址后加 ?view=<后缀>（alternate templates 页以商品为例，集合按同一格式，未在真实店铺实测）。
• 官方页面写明不能用 alternate 替换默认模板；默认模板不合适时应直接修改它。

collection 类型的平台约束

以下核验于 2026-09-29。

• 模板文件为 templates/collection.json。使用 JSON 模板时，HTML 与 Liquid 必须放在被模板引用的 Section 中；JSON 模板最多渲染 25 个 Section，每个 Section 最多 50 个 Block。JSON 模板页并未规定必须有名为 main 的 Section，示例中的 main 只是命名。
• 模板必须使用 collection 对象展示集合信息，商品来自 collection.products；每页最多 50 个（该页与 paginate 标签页的上限口径不一致，见集合浏览与筛选）。
• 排序由 URL 参数 sort_by 控制；collection.filters 在商品超过 5,000 时为空，此时页面不会有筛选。
• 集合资源模型：帮助中心写明新的集合模型正在替代旧的手动与智能集合；新模型开放前可继续使用旧模型。旧手动集合只能整件商品加入，只有新模型能加入变体；旧智能集合最多 60 个条件，可选「满足全部」或「满足任一」条件。不同店铺的后台界面可能不同。
• 集合的标题、说明、图片、销售渠道发布和主题模板都可在后台编辑（帮助中心集合总览页）；collection.image 与 collection.description 由后台数据提供，页面如何呈现取决于主题。

未核验：各主题默认 collection.json 的 Section 组成、新集合模型下的模板分配界面。主题实现见 Horizon 集合与搜索与 Dawn 筛选与分页（固定版本源码解读）。