> For AI agents: the complete documentation index is available at https://docs.halo.run/llms.txt, the full documentation bundle is available at https://docs.halo.run/llms-full.txt.

# 产品管理

![](/img/user-guide/shop/preview-console-products.png)

## 查找和管理产品

登录 Halo 控制台，进入 **商店 -> 产品**。产品列表支持关键词搜索，并可按状态、类型和分类筛选或调整排序。打开单个产品的操作菜单，可以编辑或删除产品。

## 创建产品

首先登录到 Halo 控制台，进入 **商店 -> 产品** 页面，点击右上角的新建按钮。

![](/img/user-guide/shop/products-create.png)

### 基本信息

- 名称：产品名称
- 简短描述：产品的简短描述
- 描述：产品的详细描述，使用富文本编辑器
- 图片：产品图片，可以直接上传或者从附件库中选择，第一张图片会作为封面图

### 产品数据

这里主要配置产品的类型、属性、规格、价格等数据。

产品类型目前支持三种：

1. 实体：需要配送的产品类型
2. 虚拟：不需要实体配送，使用线上发货的产品类型
3. 链接：直接跳转到第三方链接的产品类型

:::info 虚拟产品交付方式
虚拟产品支持文件资源下载、卡密发货，可参考 [虚拟交付](https://docs.halo.run/guide/shop/virtual-delivery.md) 进行发货配置。
:::

#### 属性配置

属性的作用是为产品添加一些额外的信息，比如颜色、尺寸、型号等，同时也可以用于生成产品规格。

![](/img/user-guide/shop/products-spec-form.png)

- 名称：属性名称，比如颜色、尺寸
- 属性值：支持多个属性值，比如颜色可以有红色、蓝色、绿色等，尺寸可以有小、中、大等，同时也可以为不同的属性值设置图片，用于展示给用户
- 用于生成产品规格：勾选后，支持在配置产品规格时根据多个属性生成不同的产品规格

#### 规格配置

规格即产品的具体规格，比如颜色为红色、尺寸为小，型号为1234567890，可以根据属性值生成不同的规格，并单独设置价格、库存等信息，最终用户购买时，可以选择属性值来确定购买的产品规格。

:::note 规格也称 SKU
这里的规格也可以称之为 **变体** 或者 **SKU**。
:::

![](/img/user-guide/shop/products-variants-0.png)

当我们设置好 [属性](#属性配置) 之后，可以点击 **生成规格** 按钮来批量生成所有可能产生的规格。

![](/img/user-guide/shop/products-variants.png)

然后可以点击具体的规格项，展开规格配置表单：

![](/img/user-guide/shop/products-variants-form.png)

- 图片：为规格设置图片，用于在购物车，订单等页面展示，如果不设置，会使用属性值中配置的图片或者产品封面
- 状态：支持 **草稿**、**已发布**、**已归档** 三种状态
- SKU 编号：规格的唯一标识
- 条形码：产品规格的条形码，也可用于表示 GTIN、UPC、EAN 或 ISBN 等
- 定价类型
  - 固定价格：填写实际价格和可选的划线价
  - 询价：不填写价格，前台显示 **联系销售**；跳转行为由[商店设置](https://docs.halo.run/guide/shop/settings.md#%E8%AF%A2%E4%BB%B7%E8%B7%B3%E8%BD%AC%E5%9C%B0%E5%9D%80)决定
- 管理库存
  - 否：不管理库存，用户可以无限购买
  - 是：管理库存，用户购买时，库存会减少
- 库存：规格的库存数量，当库存为0时，用户无法购买
- 重量：规格的重量
- 长度：规格的长度
- 宽度：规格的宽度
- 高度：规格的高度

:::note 尺寸信息仅用于实物产品
重量、长度、宽度、高度用于后续发货相关的业务，如果产品类型为虚拟，则不需要配置。
:::

除了为单个规格设置上述配置之外，也可以点击上方的批量设置按钮，用于为所有规格设置相同的配置。

![](/img/user-guide/shop/products-variants-batch.png)

### 分类配置

分类配置用于将产品分类，比如手机、电脑、服装、数码等，支持多级分类。

![](/img/user-guide/shop/products-category-selector.png)

## 管理分类

进入 **商店 -> 分类**，可以新建、编辑和删除分类。分类支持父分类、名称、别名、描述和图片；为分类选择父级即可建立多级结构。

产品编辑页面的分类选择器会使用这里维护的分类。

## 管理属性模板

进入 **商店 -> 属性模板**，可以把常用的属性名称和值保存为模板，例如“颜色：红色、蓝色”和“尺寸：S、M、L”。创建产品时选择模板，可以直接带入这些属性值，再按当前产品调整。

## 发布产品

配置完产品信息之后，就可以将产品状态改为 **发布**，并保存产品，最终就可以在商城前台中展示。

![](/img/user-guide/shop/preview-product.png)