Managing products

Products live under Catalog → Products in the sidebar. The list shows everything the active business exposes through its API; the product page is where you edit a single product. Everything on these screens is scoped to the active business: if no business is selected, the page shows Select a business first.

The product list#

The Products page lists your catalog in a table with these columns: an image thumbnail (a gray placeholder square when the product has no image), Name, SKU (shows - when empty), Status (a status pill), and Price (right-aligned). Click any row, or the eye icon at the end of it, to open the product's page.

• Search filters the list as you type (matches on the server, with a short delay).
• Filter by Status narrows the list to Draft, Active, or Archived products.
• Sort by clicking the Name, SKU, Status, or Price column headers.
• Pagination is fixed at 25 rows per page. Use Previous / Next; the footer shows "Page X of Y" and the total count.

When you have no products at all, the list shows an empty state ("No products yet") with New product and Import CSV buttons to get started.

Product statuses#

Bulk actions#

Select products with the row checkboxes (or the select-all checkbox in the header) to unlock bulk actions:

• Set status prompts for a New status (Draft, Active, or Archived) and asks you to confirm before applying it to every selected product.
• Delete removes all selected products after a confirmation dialog. This is destructive.

Import and export CSV#

• Export CSV downloads your catalog as products.csv. If the export fails, an inline "Export failed." message appears.
• Import CSV opens the Import products dialog. Choose a .csv file with a header row and click Import. The import upserts: the result reports how many rows were created, updated, and failed, with a per-row error message ("Row {n}: ...") for each failure. The product list refreshes when you close the dialog, not before.

The file's columns are id, capability, name, slug, sku, barcode, status, price_amount, compare_at_amount, currency, description and categories. capability is standard (Product) or made_to_measure (Made to measure); both amounts are in minor units (1990 for 19.90). The easiest way to get a valid file is to export first and edit that.

Create a product#

1. Click New product on the Products page.

2. The screen asks What are you selling? and explains "This decides which sections the product gets. It can't be changed later." Pick one of the cards:

   Card	Meaning
   Product	Sold as is: one price, or options like size or color with their own SKU and price. Always offered.
   Made to measure	Priced from dimensions and option choices (e.g. a width x height grid), made per order. Only offered while the Configurator module is enabled for your business. See Variants and the configurator.

3. The header now reads "Selling as Product" (or "Selling as Made to measure"); click Change to go back to the cards. Fill in the Details section: Name is required ("Give the product a name." otherwise), Description is optional.

4. Click Save in the header. The product is created as a draft and you land on its page, where every other section becomes available.

You no longer type a slug when creating a product: the storefront address is derived from the name (a second "T-shirt" gets t-shirt-2). Change it later under Search & social. What you pick on the first screen is permanent; to sell the same thing the other way, create a new product.

The product page#

The product page is one editor: a header, a column of sections, and a sidebar on the right (below the sections on small screens).

The header and Save#

The header shows the back arrow, the product name, its status pill, a Save button and a More actions menu (the "⋯" button).

• One Save for the whole page. Edit as many sections as you like; the header says Unsaved changes, and Save stores every section you changed, in order. While it runs the button reads Saving…; afterwards the header says Saved.
• A failed save keeps your edits. The header shows "Save failed. Your changes are still here." and the page scrolls to the section that failed, opening it if it was collapsed, with the error under the field. Sections saved before the failure stay saved.
• Leaving with unsaved changes asks first. The back arrow (or your browser's back button) opens an Unsaved changes dialog; Discard changes leaves without saving.
• Delete lives in the More actions menu. The Delete product dialog asks 'Delete "{name}"? This cannot be undone.' and returns you to the product list.

Some sections are editors of their own that save as you go instead of through the header Save: Images, Options & variants, and the configurator cards. Each one confirms its own saves.

If the product's way of selling is switched off for your business, a warning banner under the header says so, for example "Made to measure is turned off; this product cannot be bought." The product stays editable; it cannot be bought until the module is enabled again.

If the product was deleted, the page shows "This product does not exist (it may have been deleted)." with a Back to products link.

Sections#

Which sections you see depends on what the product is and which modules your business has:

The sidebar holds Status, Tags, Categories, VAT class (only with the Webshop module) and Lead time.

Product fields#

Setting Status to Active is refused while the product cannot be priced (no price, or dimensions without price rules). The Status card then shows "Not published: {reason}" and the product keeps its old status.

Units and decimal quantities#

The Unit decides how quantities of the product are counted everywhere: in carts, on orders, on quotes and in stock. A Piece product is sold in whole numbers; every other unit accepts decimals with up to 3 places, so a customer can buy 0.75 kg and a quote can carry 64.5 m². The line total is the unit price times the quantity, rounded to the cent. Quantity fields in the dashboard accept a decimal comma as well as a dot (0,75 or 0.75).

Bulk pricing#

The Bulk pricing section (Product only) sets "Fixed prices and quantity discounts per customer group." Each row has:

Use Add price to add rows and the trash icon to remove them, then save with the header Save. Saving replaces the entire set of group prices at once. You cannot save a row for everyone at quantity 1: "A price for everyone at quantity 1 is the base price, set it on the product itself." With no rows, the section shows "No group prices yet. Base product pricing applies to everyone."

Quote#

With the Sales module enabled, the Quote section sets the product's Purchasability: Direct checkout only (default), Quote only, or Direct checkout and quote. The quote options only take effect while quote requests are switched on under Sales → Settings → Quotes; until then the section shows "Quote requests are switched off under Sales → Settings → Quotes, so this product still checks out directly until you enable them." Without the Sales module the section is not shown and every product checks out directly.

Search and social#

The Search & social section (collapsed at first) controls how the product appears in search results and when it is shared:

When you change the URL handle and save, the old address keeps working: a storefront that uses the redirect lookup sends visitors on to the new one. The same goes for a category's slug. See the SEO API reference for how a storefront uses it.

Product preview#

A floating Product preview button (bottom-right) opens a storefront-style sheet: the image carousel (or "No images"), name, computed price, a quantity stepper, and an Add to cart button showing the line total. For a Made to measure product it renders the live configurator and fetches a server price quote with a line-item breakdown as you change inputs.

The preview is display-only for you as a merchant: its Add to cart button does nothing, and the server always recomputes prices at cart time on the real storefront. For how your storefront consumes products, see the API reference.