Adding and editing products
Products are managed under Catalog → Products. From the list you search and filter the catalog, open a product to edit it, add a new one, copy an existing one, and delete what you no longer sell. This article covers the list and the General tab of the product editor, which holds the name, descriptions, brand, visibility and publishing of a product. The other tabs have articles of their own, linked at the end.
The product list
The list shows a thumbnail, the product name with its SKU underneath, price, stock quantity, product type, brand, main category and a Published badge. Click a row to open the product. Type in the search box and press Search to find products by name.
Click Filters to narrow the list further:
| Filter | What it does |
|---|---|
| Product type | Only products of one type (grouped, reservation, bundled, auction). |
| Published | All, only published or only unpublished products. |
| Warehouse | Products stocked in a given warehouse. |
| Category, Include subcategories | Products mapped to a category; with Include subcategories switched on, products of its child categories are included too. |
| Brand, Collection | Products of one brand or one collection. |
| Store, Vendor | Products available in one store or managed by one vendor. |
| Edit product with a specified SKU | Type an exact SKU and click Go to jump straight into that product's editor. |
Tick the checkboxes in the first column to act on several products: Delete (selected) appears above the grid, and Export → Export to Excel (selected) exports only the ticked rows. Excel import and export are described in Import, export and bulk edit.
How to add a product
- Go to Catalog → Products and click Add new.
- On the General tab choose the Product type. For an ordinary product that is shipped and stocked, keep Simple; the other types are explained in Product types.
- Enter the Product name, a Short description (shown in lists and at the top of the product page) and a Full description (the rich text body of the product page).
- Pick the Brand, add Product tags, and fill in SKU (your stock keeping unit, needed for Excel import), and if you have them the Manufacturer part number and GTIN.
- Switch on Published when the product is ready to be seen.
- Click Save and Continue Edit. The remaining tabs - pictures, mappings, attributes, linked products and so on - need a saved product, and several of them (reviews, documents, user fields, purchased with orders) only appear once the product exists.
- Set the price on the Prices tab, map the product to categories on the Mappings tab, and upload pictures on the Pictures tab. Save again.
- Click Show in the shop page to open the product on the storefront in a new tab.
Fields on the General tab
| Field | What it does |
|---|---|
| Product type | Simple, Grouped (product with variants), Reservation, Bundled product or Auction. Changing it shows and hides the tabs that apply to that type. |
| Product layout | The Razor layout used to render the product page. Layouts are defined under Configuration → Layouts → Product layouts; a standard install has one for simple and one for grouped products. |
| Visible individually | When on, the product has its own page and appears in lists and search. Switch it off for products that should be reachable only as a variant of a grouped product. |
| Flag | A short custom label (for example "Limited") shown on catalog tiles and on the product page. |
| Admin comment | An internal note, never shown to customers. |
| Vendor | The vendor that manages the product in the vendor panel. |
| Show on home page, Mark as a bestseller | Feature the product in the home page product blocks. A display order field appears when either is on. |
| Allow to review this product | Lets customers write reviews on the product page - see Product tags and reviews. |
| Limited to customer groups, Limited to stores | Restrict who can see and buy the product. Empty means everyone, in every store. |
| Available from, Available to | A time window in which the product can be bought. |
| Mark as new | Shows a "new" badge, optionally between a start and end date. |
Copying and deleting a product
The ⋮ button next to Save holds Copy product and Delete. Copy product asks for a new name, whether the copy should be published, and whether to copy the images. Everything else - prices, attributes, mappings, specification attributes - is copied, so this is the quickest way to create a family of similar products. The copy opens as a new product; give it its own SKU and SEO name.
The other tabs
- Prices and Inventory - Prices, discounts and inventory.
- Additional info - display order per category, brand and collection page, gift voucher, digital product, recurring product and required products settings.
- SEO, Pictures, Mappings and Linked products - Pictures, SEO, mappings and linked products.
- Specification attributes and Product attributes - Specification attributes and Product attributes and combinations.
- Purchased with orders - the orders that contain this product, with links to them.
- Product Reviews - the reviews of this product.
- Documents and User fields - linked documents and free key-value data for integrations.
Tips and common mistakes
- Remember to save. Switching tabs does not save; Save and Continue Edit keeps you on the same tab.
- In the Product type filter of the list, All and Simple currently share the same value, so the filter opens with Simple shown and choosing Simple lists products of every type. Pick another type to filter.
- Keep SKUs unique. Excel import matches existing products by SKU, and Edit product with a specified SKU relies on it.
Related
Question not answered here? Ask the community on GitHub Discussions ↗