Skip to main content

Create a product

Add warehouse catalog products in Admin. Products are the SKUs you stock, show on POS catalog, and list on ecommerce.

Prerequisites: Categories and properties (at least category and any properties you need).

Who and where​

  • Roles: Stock, Admin
  • Route: /warehouse/products (create opens a dialog — no separate URL)
  • Nav: Warehouse Management → Products

Pipeline after create: Stock and warehouses → POS catalog visibility → Ecommerce listings.

1. Open Products​

  1. Sign in to Admin.
  2. Open Warehouse Management → Products (/warehouse/products).
  3. Use Search products... and All Categories if you need to find an existing item first.

Products list

2. Start Create Product​

  1. Click Create Product.
  2. The dialog opens (create mode). Edit mode uses the same fields with Save Changes.

3. Fill product fields​

Work top to bottom:

  1. Product Image — paste Image URL or link, or Upload from Computer.
  2. Product Name — required by the API in practice; empty saves may fail. Verify in UI if the Save button stays enabled with an empty name.
  3. URL Slug — appears under /product/…. Use Reset from name or let auto-suggest run; edit only if you need a fixed slug.
  4. Category — select from the combobox (Select a category...). You can create one inline with + Add "{value}" if the category is missing (image may still be needed elsewhere — Verify in UI).
  5. Pricing Category — select (Select a pricing category...) when POS pricing rules apply.
  6. Properties — click Add; for each row pick Key and Value. Reorder with ↑↓ for wizard step order. Remove a row if unused.
  7. SKU (optional) — one SKU per product (no size/color variant matrix in this dialog).
  8. Restock Threshold — used for low-stock highlighting on warehouses.
  9. Default Price (optional).
  10. Making Time (hours) — production lead time.
  11. Customizable — turn on for products that accept designs / custom print flows.
  12. Cart addon (popup, keychain, etc.) — switch Cart addon. Help text: Addon products are hidden from the shop catalog and shown as extras when customers add items to cart.

Create product dialog

Cart addons end-to-end​

Marking Cart addon hides the SKU from normal shop browsing and surfaces it as an “extra”:

ChannelCustomer experience
EcommerceAfter adding a main item, You might also like upsell dialog; cart drawer / checkout Add extras / Add more extras
Catalog link (POS host)Cart Add extras; optional You might also like sheet before shipping
POS counterAdd-ons category on the POS product grid (in-store sale)
Classic customer-link checkoutAddon picker during the Checkout wizard when configured

Still required after create: warehouse stock, and any channel listing rules for non-addon products. Addons need stock in a warehouse the channel can sell from.

4. Save​

  1. Click Create Product.
  2. Fix any validation errors shown on fields.
  3. Confirm the product appears in the list (name, /product/{slug}, SKU, Category, Pricing Category, property tags).

5. After create — stock and channels​

Creating a product does not put stock in a warehouse or make it visible on POS/ecommerce by itself.

  1. Assign the product to a warehouse and set quantity — Stock and warehouses.
  2. Toggle In Catalog on POS Catalog if cashiers should browse it — POS catalog visibility.
  3. Enable Listed per fulfillment warehouse on Ecommerce — Listings and homepage.

6. Edit, view stock, deactivate​

From the products table:

  1. Edit (pencil) — same dialog → Save Changes.
  2. View Stock — Stock Details: {name} shows Warehouse, Location, Quantity.
  3. Delete — opens Deactivate product (soft deactivate, not hard delete). Review Dependency summary, then Deactivate.

Verify in UI: restoring a deactivated product (is_active) — warehouse Products list has no dedicated restore button in current UI; ask an admin if reactivation is needed via API/other tools.

Fields not in this dialog​

These exist on the product API/model but are not edited in Create Product: description, dimensions, weight, and show_in_pos_catalog. POS visibility is managed under POS Catalog. Mark anything else as Verify in UI.

Checklist​

  • Category (and pricing category if needed) selected.
  • Properties match design compatibility rules for customizable goods.
  • Customizable flag set correctly for print/design products.
  • Next step planned: warehouse stock + POS/ecommerce visibility.
  • Technical: Domain model — Product / WarehouseStock entities
  • Technical: Stock rules — when inventory decrements by channel