Product Lists

Product lists let you organize your catalog into named collections for use in email templates. Create a curated set of featured products or define rules that automatically keep a list up to date.

Static vs. Dynamic Lists

Static Lists

A static list is a hand-picked collection. You add and remove products manually and control the exact order they appear. Great for curated selections like "Editor's Picks" or "Holiday Gift Guide."

Dynamic Lists

A dynamic list uses filter rules to automatically include matching products. For example, "all active products in the Electronics category priced under $100." When your catalog changes, the list updates automatically.

Available filter fields include:

Name, Category, Brand, SKU — text matching (equals, contains, starts with)
Tags — contains or not contains
Price — numeric comparisons (greater than, less than, between)
Status — active, draft, archived
Available — in stock or out of stock
Source — manual, Shopify, MLS
City, State, Country, Postal Code — text matching on product location fields
Location Radius — find products within a given number of miles from a latitude/longitude point. Enter a latitude, longitude, and radius in miles, and the list includes all products with a location within that circle. This is ideal for real estate, multi-location retail, or any catalog where products are tied to a physical place.
Created / Updated At — date filters (before, after, in last N days)

Using Product Lists in Emails

Product lists power two modes in the email template editor's Product block:

From List — Pick N

The system picks a set number of products from your list at send time. Useful for recommendation sections where you want variety but want to control the pool of eligible products. For example, "pick 3 from the Holiday Sale list."

From List — Show All

Every product in the list renders in order into the email. Ideal for newsletter catalog sections like "New This Week" or "Featured Homes." Products render using whichever product style you select on the block.

Sort Order

Product lists support several sort options:

Newest First — sorted by creation date, newest on top
Price: Low to High / High to Low — sorted by price
Name: A to Z — alphabetical
Manual (static lists only) — you set the exact order by dragging products

API Endpoints

All product list endpoints are available under /api/v1/product-lists. See the REST API docs for full details.

GET /product-lists — list all product lists
POST /product-lists — create a product list
GET /product-lists/:id/products — get products in a list
POST /product-lists/:id/products — add products to a static list
DELETE /product-lists/:id/products — remove products from a static list
POST /product-lists/preview — preview which products match dynamic conditions