1 Households Roles and Invites

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

Table of Contents

• Households, Roles, and Invites
• Household Roles
• Create A Household
• Rename Or Delete A Household
• Invite Links
• Join Policy
• Join Requests
• Member Management

Households, Roles, and Invites

Households are the main collaboration boundary in Fiddy. Lists, stores, locations, zones, catalog items, and membership are scoped to a household.

Household Roles

Role	Can shop	Manage household	Manage stores/zones	Manage invites	Manage member roles
Owner	Yes	Yes	Yes	Yes	Yes, including ownership transfer
Admin	Yes	Yes	Yes	Yes	Yes, except protected owner actions
Member	Yes	No	Limited/no admin actions	No	No

Rules enforced by the backend:

• Only household members can access a household.
• Owner/admin actions require a household owner or admin role.
• A member cannot promote themselves.
• Owner role changes are protected.
• Server-side authorization is required; client UI checks are only convenience.

Create A Household

1. Sign in.
2. Use the household create flow.
3. Enter a household name.
4. The creator becomes the household owner.

Rename Or Delete A Household

Open Manage > Household.

Owners/admins can rename a household. Owners/admins can also delete a household, which removes that household's lists and related data. Treat deletion as permanent.

Invite Links

Owners/admins can create invite links from Manage > Household > Invite Links.

Invite link behavior:

• Links have a time-to-live from 1 to 7 days.
• Link settings are immutable after creation.
• Expired links are retained and can be revived.
• Reviving a link resets its expiration and creates a new audit event.
• Single-use links are deleted after successful use.
• Single-use does not bypass approval-required joining.
• Logs and audit records must never expose full invite codes; use last 4 characters only.

When copying or sharing invite links, send them only to people who should join the household.

Join Policy

Owners/admins choose how invite link joins work:

Policy	Meaning
Not accepting	New joins are closed. Existing members continue to use the household.
Auto accept	A valid invite link adds the user automatically.
Approval required	A valid invite link creates a pending join request that an owner/admin must approve.

Join Requests

When approval is required:

1. A user opens an invite link.
2. The app creates a pending join request.
3. Owners/admins review pending requests from the household management screen.
4. Owners/admins approve or deny each request.

Approved users become household members.

Member Management

Owners/admins can:

• View members.
• Promote members to admin.
• Demote admins to member.
• Transfer ownership where allowed.
• Remove members.

Members can leave a household. If a user belongs to multiple households, they can switch to another household after leaving.