Examples

Every list on this page runs on Four Mile Books, the test store the app is built against. Each example gives the problem, the list as it looks in the editor, what it says in plain English, where it renders, and how the same shape applies to your own content.

The store

Four Mile Books is a classics imprint with 328 books and these metaobject types. Replace the fields with your own; the shape of each list is what carries over.

Type	Fields
Book	title, author (reference), series (reference), series order, genres (list of references), first published, pages, blurb, featured, added on, product, cover
Author	name, born, died, nationality, biography
Series	name, author, description
Genre	name
Event	title, date, book, author, description, free
Award	name, year, book
Reading list	name, description, books (products), collections, curated on
Staff pick	staff name, month, book, note

Every book is also a product, linked from the book’s product field, and each product carries a custom.book metafield pointing back at its book. The genres are collections too.

The examples

The first ten are store-wide lists, from a single flag to a random sort. Then relationships and groups. Then the lists that are written per product, per collection or per entry.

Example	What it shows
Featured books	The simplest list: every book with a flag set, in title order, capped at eight.
Latest staff picks	No conditions at all: every entry, newest first, with a limit.
Award winners	A text condition on a type that records many awards: keep the rows for one of them.
New this month	A relative date condition: the list moves on by itself.
Upcoming events	The forward-looking relative date, on a type with a date field and a reference.
Past events	The other side of the calendar: what has already happened, most recent first.
Published in a range	Two conditions on the same numeric field make a range.
Longest reads	A sort on a numeric field, with an is-not-empty condition so unknowns stay out.
Every book, A to Z	No conditions and no limit: the whole type in order, and what the ceilings mean.
A random shelf	The random sort, on a filtered set.
By French authors	A condition on the entry a reference points at.
Either genre, and short	A group set to any of, inside the top-level all of.
British, either genre, short	The home-page hero list: a relationship condition, an any-of group and a number condition together.
Reading lists, per product	A per-product list: entries that reference the product, written to that product.
Reading lists, per collection	The same shape through a collection reference.
The rest of the series	A per-entry list: the other entries that share a reference with this one.
More by this author	The same per-entry shape through a different field, with a limit.
An author page	A per-referenced-entry list: the entries that point at this one.
A series page	Per referenced entry again, sorted by a number on the referencing type.
Events for a book	Per referenced entry with a condition: only the future ones.