Help & Reference

Custom items

Add anything to your grocery list that isn’t tied to a recipe — household supplies, one-off purchases, a bottle of wine for dinner.

Add an item from the Groceries page

  1. Type into the Add a custom item… field at the bottom of the Groceries page.
  2. Press Enter or tap the +.

The item joins the list right away and lands in Miscellaneous unless you give it an aisle (see below).

Add an item from anywhere in the app

Press / (or tap the search icon) to open the search overlay. Type what you need, then tap a row under Add to grocery list.

If the name matches an ingredient mirepoix knows, it joins your list as a tracked item — like a recipe ingredient. An unfamiliar name joins as a custom item instead. Either way you stay on the page you started from.

Place an item in a specific aisle

Use the Name @ Aisle syntax in either input:

Dish soap @ Cleaning
Sparkling water @ Beverages

If the aisle name matches one of your configured aisles, the item lands there. An aisle name you haven’t used before is added to your kitchen’s aisle list — see Aisle order to rename or reorder it later.

In the search overlay, a small pill on the right of each row shows where the item will land. Miscellaneous is left blank.

How custom items behave

A custom item sits on your Groceries list until you tap it off. It stays visible, crossed out, for an hour after the check in case of a mistap. Tap the checkbox again within that window to put it back on the list. After the hour, the row drops off the Groceries page.

If you add a name that’s already on the list — because a checked recipe calls for it, or because you already added it yourself — your second add folds into the existing row. Adding “olive oil” twice doesn’t create two lines.

To remove a custom item without checking it off, tap the × at the end of the row. The confirm dialog appears, the row leaves the list, and no supply state changes.

After you check a custom item off, it stays in your kitchen’s records for 45 days even after it disappears from the page — so the same name is remembered if it comes back. After 45 days untouched, it prunes itself.

See also