Note: This article covers the latest Catalog Machine version 2. For help with the previous version, see this article.
Product lists give customers a structured way to overview product details, pricing, and other essential information. With Catalog Machine, you have powerful tools to design product lists that meet your exact needs. Choose from pre-built layouts or create your own custom lists for price comparisons, order forms, product indexes, and more.
Watch this short 2-minute video for an overview of the steps for creating a product list.
Step 1: Adding a Product List
Choose your starting point:
Method 1: Pre-Designed Layout
In the Catalog Designer, select a layout featuring a price list (or other product list type).
Customize the list as needed (instructions below).
Method 2: From Scratch
Drag and drop the Product List element onto a catalog page.
Use the Product List Editor to configure your list.
Step 2: The Product List Editor
Double-click the product list on the page to open the editor, or click the Edit Product List button in the designer toolbar above the page. You do not need to drag in a new Product List element to change a list that is already on the page.
A. Choose Your Products
Individual Products: Select specific items.
Catalog Products: Include all products in the current catalog.
All My Products: Include your entire product database.
Collections: Use a pre-existing product collection.
Auto-Updates: The last three options keep your list current as you manage your products.
Use the 'InStock Products Only' toggle to display only items currently in stock.
B. Select Fields to Display
Category Fields: Include standard (price, description) or custom fields linked to your categories.
Special Fields:
Image - the product image
Product Order Link - adds an Order link to every row, so customers can order that product straight from the list (see Clickable Ordering below)
Product Page Link - a link to the page where the product appears in the catalog (for indexes and tables of contents)
Quantity - an empty quantity box on every row, for order forms
Variant Fields: Display variant options.
Barcodes: Include barcodes with {{BarcodeImage}} or {{BarcodeImageExt}}
C. Design & Structure
Grouping: Group products by category, collection, or not at all.
Ordering: Sort groups or individual products within your list.
Styling: Customize the appearance of table borders, headers, rows, and text.
Advanced:
Expandable: Make lists scrollable online or generate multiple PDF pages.
Colors: Link colors to your product categories/collections.
Variant Rows: Separate variants for clarity.
Clickable Ordering: Let Customers Order from the List
Ordering needs two things - a catalog-level switch, plus a field on the pages that use a product list:
1. Turn on orders for the catalog. In the Catalog Designer open the catalog Settings -> Orders and switch on Enable catalog orders. Optionally set an Orders Email to override the account default. Catalogs started from a Catalog Machine template may already have this switched on.
2. Make the products clickable. This works differently per page type:
Product card pages: nothing to add. With orders enabled, every product on the page automatically gets a select checkbox and a quantity control in the online catalog.
Product list / price list pages: add the Product Order Link field in the Fields section above. Every row then shows an Order link. Add the Quantity field too if you want customers to enter amounts.
Ordering works in the online catalog only, not in the PDF. The select controls and the Order link are interactive elements, so they do not appear in a downloaded or printed PDF, and the Product Order Link column renders empty there. Share the catalog link (or your showroom) when you want customers to order. Note also that a catalog in Draft status is visible only to you while you are signed in - publish it before sending the link to customers.
For the order form fields, notification emails, and Stripe payments, see Online Orders & Payments. Showrooms have their own separate orders setting.
Step 3: Customizing Further
Edit Text: Modify field labels or other text directly in the generated list.
HTML Editing: For in-depth control, adjust the HTML code of your list.
Help: Learn more about advanced customization.
Step 4: Using Lists in Layouts
Reusable Layouts: Create layouts to use across catalogs.
Save Pages: Convert any catalog page to a reusable layout.