1 Stores Zones and Catalog Items

Nico edited this page 2026-05-26 00:31:28 -07:00

Table of Contents

• Stores, Zones, and Catalog Items
• Store Model
• Add A Household Store And Location
• Manage Zones
• Manage Available Items
• Good Catalog Hygiene
• When A Store Is Missing

Stores, Zones, and Catalog Items

Store management controls how grocery lists are organized for a household.

Store Model

Fiddy separates:

• Global store records: system-level store templates.
• Household-owned stores: stores configured for a specific household.
• Locations: concrete shopping locations under a household store.
• Zones: ordered areas inside a location.
• Available items: location-specific catalog items used for suggestions and defaults.

The active shopping list is scoped to a household and one location.

Add A Household Store And Location

Open Manage > Stores.

Owners/admins can:

1. Add a household store.
2. Add one or more locations for that store.
3. Rename stores or locations.
4. Set the default shopping location.
5. Remove stores or locations when they are no longer needed.

The main list uses the active/default location when showing list items and suggestions.

Manage Zones

Zones represent store areas such as produce, dairy, freezer, household, or checkout.

Owners/admins can:

• Add zones.
• Rename zones.
• Set zone order.
• Delete zones.

Users see list items grouped by the active location's zones. Zone order should match the route people normally walk through the store.

Manage Available Items

Available items are reusable household/location catalog entries. They power suggestions and default details when users add groceries.

From Manage > Stores > Manage Items, owners/admins can:

• Search the catalog.
• Add catalog items.
• Edit item names, defaults, notes, classification, and images.
• Delete catalog items.
• Import current list items into the catalog.

Members can use catalog-backed suggestions while adding items. Admin-only catalog deletion is enforced by the backend.

Good Catalog Hygiene

Use stable, simple item names:

• Prefer milk over need milk.
• Prefer eggs over 12 eggs because quantity is tracked separately.
• Use notes for brand, size, or special instructions.
• Keep zones broad enough to be useful while shopping.

When A Store Is Missing

If the list says no stores are found:

1. Confirm the correct household is selected.
2. Ask an owner/admin to open Manage > Stores.
3. Add a store and at least one location.
4. Set the location as default if it should open automatically.