Skip to main content

Catalogue Management

Version: v1.1
Last Updated: May 30, 2026

Partner App Menu Path​

Catalog → Stock Category / Stock Item

Required Access​

  • shop.catalog.view
  • shop.catalog.manage (manager or owner role)

Catalogue Structure​

Your catalogue is organised in two layers:

Category  (e.g. "Electronics", "Fresh Produce", "Clothing")
  └── Product / Stock Item  (e.g. "Samsung USB-C Charger")
        └── Variant (optional)  (e.g. "Black / 25W", "White / 45W")

Categories help customers browse. Variants let you offer the same product in different configurations (colour, size, capacity) without creating separate listings.

Creating a Category​

  1. Go to Catalog → Stock Category
  2. Click Add category
  3. Fill in:
    • Name — customer-facing label (e.g. "Kitchen Appliances")
    • Description — optional summary shown on the category page
    • Sort order — lower numbers appear first in the browse view
  4. Click Save

📸 Screenshot: Stock Category list with Add category button

Adding a Product​

  1. Go to Catalog → Stock Item
  2. Click Add product
  3. Fill in:
    • Name — clear, descriptive product title (e.g. "Stainless Steel Water Bottle 750ml")
    • Category — which category this product belongs to
    • Price — selling price in your default currency
    • SKU / Reference — your internal product code (optional but recommended for stock tracking)
    • Description — what the product is, materials, key specifications
    • Image(s) — see image guidelines below
  4. Set Stock quantity (see stock management below)
  5. Set Availability to Available
  6. Click Save

📸 Screenshot: Add/edit product form with all fields

Image guidelines​

  • Recommended size: 800 × 800 px or larger (square, 1:1 ratio)
  • Format: JPG or PNG, max 5 MB per image
  • Style: clean background, real product photograph
  • Multiple images are supported — add a front view, back view, and any detail shots
  • The first image becomes the thumbnail in search and browse results

📸 Screenshot: Product image upload with multiple slots

Managing Product Variants​

Use variants when you sell the same product in different configurations.

  1. Open a product in Catalog → Stock Item
  2. Scroll to the Variants section
  3. Click Add variant
  4. For each variant, set:
    • Variant name — what makes it different (e.g. "Red / Large", "128GB")
    • Price — can differ from the base product price
    • SKU — variant-level reference code
    • Stock quantity
  5. Save

Customers see a variant selector on the product page. Each variant can be individually stocked and priced.

📸 Screenshot: Product variants list with stock per variant

Stock Levels and Availability​

Setting stock quantity​

Each product (and each variant) has an independent stock quantity. When the quantity reaches zero, the product is automatically marked unavailable and disappears from the customer storefront.

To update stock:

  1. Open the product or variant
  2. Update the Stock quantity field
  3. Save

Manually marking unavailable​

To remove a product from the storefront without zeroing the stock (e.g. seasonal item, awaiting restock):

  1. Open the product
  2. Toggle Availability to Unavailable
  3. Save

The product is hidden from customers immediately. Stock is preserved.

Bulk availability​

To temporarily pause your entire catalogue (e.g. shop closed for the day, stock audit):

  1. Go to Settings → Delivery Settings
  2. Toggle the shop status to Closed or set a closed period

📸 Screenshot: Stock quantity field and availability toggle

How Product Changes Take Effect​

Saves are immediate — price changes, stock updates, and availability toggles are live to customers as soon as you save. There is no cache delay.

What Customers See for Out-of-Stock Items​

When a product's stock hits zero or availability is toggled off, it is hidden from search results and category browsing. Customers who have the product bookmarked or reach it via a direct link will see an "out of stock" label and cannot add it to their cart.

Common Problems​

ProblemLikely causeFix
Product not visible on storefrontAvailability is Unavailable or stock is 0Check availability toggle and stock quantity
Variant not appearingVariant availability is off or stock is 0Open the variant and check its own availability and stock
Product showing but cannot be added to cartStock is 0 at variant levelUpdate variant stock quantity
Image not displayingFile too large or wrong formatRe-upload as JPG/PNG under 5 MB
Save fails with errorRequired field missing (name, category, or price)Complete all required fields and retry