Catalog & products

Create simple, configurable, and bundle products with custom attributes.

Products are the heart of a shop. The catalog uses an EAV model, so each store defines its own product shape via attributes.

Product types

• Simple — a single sellable item with a price and SKU.
• Configurable — a parent with variants across one or more option axes (e.g. size × color). Each variant is a child simple product.
• Bundle — a kit of other products sold together.

Create a product

Use the createProduct mutation (or the MCP create_product tool). Required at minimum: name, SKU, price. Browse the exact input in the mutations reference or try it in the Explorer.

mutation {
  createProduct(input: {
    name: "Aeron Chair",
    sku: "AERON-01",
    price: 1190000,
    typeId: "simple"
  }) { id urlKey }
}

Variants (configurable)

A configurable product references option attributes; its variants are keyed by option ids (not labels). Set the axis attributes on the parent, then attach variant children. See Attributes for defining options.

Specs & facets

Attach descriptive attributes (material, weight, brand…) for spec tables and storefront filters. These are also EAV attributes — assign them to the product's attribute set.

Images & search

• Upload images with the media mutations or MCP upload_image / upload_product_image.
• After creating products, reindex so they appear in storefront listings/search (MCP reindex_products).

Next

• Attributes (EAV) · Collections