Products

Everything a shopper can buy lives in Products. This guide covers adding a product, giving it variants and images, pricing it, organizing it into categories, and publishing it.

Add a product

1. Go to Products in the left nav.
2. Click Add product.
3. Fill in the basics:
   • Title — the product name shoppers see.
   • Description — supports rich text; this is your sales copy.
   • Slug — the URL-safe handle (/products/<slug>). It auto-fills from the title; edit it before publishing if you want a cleaner URL. Changing a slug after launch changes the product’s URL, so set it early.
4. Click Save to create the product as a draft. Drafts are not visible on the storefront.

Pricing

Set the price on the product (or per-variant, below). Prices are stored in the store’s currency in the smallest unit (for example, cents). The admin shows them formatted; you type a normal amount.

• A product with no price cannot be added to a cart and will return product_not_available on the API. Always set a price before publishing.
• For products with variants, the price usually lives on each variant.

Variants

Use variants when the same product comes in options — size, color, scent, pack count. Each variant can have its own price, SKU, and stock level.

1. On the product, open the Variants section.
2. Define your options (for example, “Size” with values S / M / L).
3. Orchard generates a variant row per combination. For each variant set:
   • Price (if it differs from the base price)
   • SKU — your internal stock-keeping code
   • Inventory — see Inventory
4. Remove any combinations you don’t actually sell.

Each variant has its own variant_id. That’s the id integrators pass to the API when adding a specific variant to a cart — see Cart to checkout.

Images

1. Open the Images section on the product.
2. Upload one or more images (drag-and-drop or file picker).
3. Drag to reorder — the first image is the primary thumbnail.
4. Optionally attach images to specific variants so the gallery updates when a shopper selects an option.

Use high-resolution images; the storefront generates the sizes it needs.

Categories and organization

Assign each product to one or more categories so it appears in the right storefront navigation and can be filtered.

1. In the product’s Organization section, pick one or more categories.
2. To create a new category, go to Products → Categories → Add category.

Some product types expose category-specific fields (for example, ingredients for a food item, or volume for a beverage). Fill these in where shown; they power storefront filters and richer product pages.

Publish

A product is live only when its status is Active — there isn’t a separate “Published” state or a dedicated Publish button; status is a Status dropdown on the product with two editable options, Draft and Active.

1. Confirm the product has a title, a price (or priced variants), at least one image, and a category.
2. Set Status to Active.
3. Visit the storefront URL (/products/<slug>) to confirm it renders.

To take a product off the storefront without deleting it, set Status back to Draft. To retire it more permanently, use Archive product instead (from the product page) — archived products are hidden from the storefront, the Status dropdown becomes read-only, and the only way back is the Restore product action, which sets the product back to Active. The product and its order history are preserved either way.

Edit and bulk actions

• Edit — click any product in the list to change copy, price, images, or status. Changes apply immediately once saved.
• Search and filter the product list by status, category, or title to find what you need.
• Bulk labels — select the checkboxes for several products and use the Labels control to apply or remove labels across the selection at once. There’s no bulk publish/archive action today; status changes are per-product.

Common questions

• A product won’t add to cart. It’s probably unpublished or has no price. Confirm both.
• The wrong image shows as the thumbnail. Reorder images; the first is primary.
• A variant is missing online. Confirm it has a price and stock, and that the parent product is published.

Next: keep stock accurate in Inventory, or watch orders come in under Orders & fulfillment.