Checklists

Checklists are the heart of Pantry: shared shopping and to-do lists that everyone in the house sees update in real time. An item can carry a quantity, a price, a category, one or more stores, labels, an image, and a repeat schedule.

A checklist in the Pantry web app, with items grouped under category headers and carrying quantities, prices, stores, labels and a weekly repeat.

Open Pantry in Nextcloud and look at the checklists in the left sidebar.
Select New list.
Give it a name, and optionally an icon, color and description.

Each list has settings for its name, description, icon, color, and a delete on done default that controls whether checked items are removed automatically. All lists shows every item across the house in one place.

Add and check off items

The composer at the bottom of a list — labeled Add to … with the list’s name — adds an item. Checking an item marks it done: it strikes through and drops to the bottom, and can be un-checked to bring it back.

On the web, the composer carries a row of chips — Category, Stores, Labels, Quantity, Price, Description, Item type, Image, Barcode — so you can set any of those on the new item before you add it, rather than opening it afterwards.

The checklist composer with chips for category, stores, labels, quantity, price, description, item type, image and barcode.

Web
Mobile & desktop

Type a name, set any of the composer chips (category, quantity, price, …) you want, and press Enter or Add.
Click the checkbox on a row to mark it done or undone.
Use the row menu to edit, copy, move, archive or trash an item.

Item details

Set any of these from the composer chips as you add an item, or open an existing item to change them:

Quantity — increase, decrease or clear it.
Price — an amount (or a range) used to estimate shopping totals.
Category — one category, shown as a colored header that groups the list.
Stores — one or more shops where the item is bought.
Labels — free-form tags for filtering.
Image — attach a photo so everyone recognizes the exact product.

A checklist item showing its details inline — quantity, price, an attached image, a weekly repeat and its store.

Organize with categories, stores and labels

Three independent ways to organize a list:

Categories group items under colored headers (Bakery, Dairy, …). An item has at most one.
Stores mark where each item is bought (Supermarket, Home Depot, …), and drive Shopping Mode routes.
Labels are free-form tags for anything else.

You create and manage each set from its picker — Create category…, Create store…, Create label… — and can rename, recolor or delete them there.

Above the list, a free-text filter plus Categories, Labels, Stores and Price filters narrow what you see.

The filter row above a checklist — a text filter and dropdowns for categories, labels, stores and price.

Web
Mobile & desktop

Combine the filters above the list to focus on one store, category or price range, and sort the list from Sort by.

Repeat items

An item can repeat on a schedule — for the groceries you buy every week. Set a repeat (for example Every week or Every 2 weeks) and Pantry brings the item back on its next recurrence after it is checked off.

A repeat can be anchored two ways:

On a fixed schedule (default) — the item comes back on its next scheduled date, no matter when you actually tick it off. A weekly item stays on the same weekday even if you shop a few days late.
Starts after completion — turn this on to count the interval from when the item is ticked off instead. A “every week” item you buy two days late then returns a full week from that purchase, not from the original date.

Import and export

You can move lists in and out of Pantry as Markdown checklists:

Import from Markdown — paste a Markdown list or drop a .md file to create items in bulk.
Export to Markdown — copy the list out as a Markdown checklist.

You can also copy or move items to another list from the item menu.

Archive and trash

Archive an item to take it off the active list without deleting it — archived items stay available to bring back later. Whole lists can be archived too.
Trash an item or list to soft-delete it. Trashed things can be restored, or permanently deleted, from the trash view.