NiaDocs
Latest
Menu

Nia documentation · Latest

Shopping

Create shopping lists with quantities, sections and stores, use Quick Add and personal destination memory, and shop offline.

Shopping is part of the Nia V4. Switch to Shopping using the module selector in the sidebar. If it is hidden, enable it in your account’s Modules settings; this setting applies across devices.

Shopping lists are independent of Tasks projects and personal workspaces.

Create a list

  1. Choose Add list in the Shopping sidebar.
  2. Give the list a name and choose its appearance.
  3. Keep it personally owned or select an available household where permitted.
  4. Save the list.

Use sections such as Produce, Chilled and Pantry to match how you shop. Items without a section remain unsorted. Sections belong to their list.

You can share a personally owned list or use household ownership. List participants work with the same content; personal view settings such as filtering do not reorganize the list for everyone.

Add an item

Open Add item and enter its name. Under Details, optionally set a quantity, unit, section and store.

Use One item for a single entry or the multiple-item mode to prepare several entries together. Review the resulting entries before saving.

You can use a numeric quantity such as 2 l, or a free-text quantity where the editor provides it, such as “to taste”. Notes keep preparation or purchasing details separate from the item name.

Units

Known unit spellings are normalized through the same unit register used by Recipes and BrainDump. For example, a recognized spelling of “liter” is displayed in the normal short form l. Unit labels follow the interface language where appropriate.

Unknown units remain as entered. Nia does not guess or correct misspelled units. An unfamiliar custom measure is not silently converted into a known one.

Manual Shopping quantities retain their precision. Ingredients transferred from a recipe use the recipe’s practical quantity display; see Recipes.

Quick Add

Enter quantities and destinations in the item field. For example, with a Green Market store and Chilled section already present in the selected list:

2 l Milk @"Green Market" /Chilled
3x Apples /Produce
500 g Pasta /Pantry
  • A leading quantity with a recognized unit fills quantity and unit.
  • 3x means a quantity of three without a separate unit.
  • @ selects an existing active store in this list.
  • / selects an existing section in this list.
  • Quotes can make a multiword destination explicit.

In the English interface, field prefixes such as qty:, unit:, store: and section: are also available. Prefixes and hints follow the selected interface language; use the syntax shown in your app. Decimal notation follows your locale.

Quick Add does not create a missing store or section. Unknown assignments remain in the item text with a warning; ambiguous or conflicting assignments need correction. Review the badges rather than assuming every part of the input was understood.

To keep an entire input literal, enclose it in matching quotes.

Stores and sections

Create or manage stores through the store controls. A store belongs to one shopping list: another list needs its own store entry, even if it represents the same supermarket.

An item can be associated with stores in its own list. Use the store filter to see the items for a particular trip. Inactive stores are not offered as new destinations.

Move an item to another section when its placement is wrong. Deliberate section and store choices can teach your personal Memory. A section-only move does not clear a remembered store.

A remembered destination fills automatically and carries the same sparkle icon used by BrainDump and Memory settings. There is no separate “accept suggestion” step. Your explicit fields and Quick Add syntax take priority.

Mark purchases

Mark an item as purchased when it goes into the basket. Use Show purchased to include purchased items, or reopen an item if it is needed again.

Delete purchased removes purchased entries; it is different from hiding them. Check the confirmation before deleting shared list content.

Add recipe ingredients

Open a recipe and choose Add to shopping list. Select the portions, target list and ingredients, then review combined amounts and destinations before transferring.

Compatible duplicate ingredients combine by default. Unknown quantities and incompatible units remain separate. The operation can add to matching open items, but does not change purchased items. See the complete transfer workflow.

Offline and synchronization

Previously synchronized lists and supported item changes work offline. Local changes remain queued until your server is reachable. Other participants see them after synchronization.

Stay signed in and retain the client’s local data until pending changes have synchronized. A store filter or hidden section is a view choice, not evidence that an item was deleted.

Invitations, household management and ownership changes require a server connection. If you lose access, the client removes inaccessible list content when it receives the authoritative update. Personal memory does not grant access to an old destination.