Configuration: Users

This guide covers role-based user setup in ChoreOps. Use it to create user profiles, assign capabilities, and control approvals.

Note

ChoreOps now uses a unified user model. A user can be an assignee, an approver/admin, or both based on selected capabilities.

---

Open the User Manager

1. Go to Settings → Devices & Services → ChoreOps
2. Select Configure
3. Select Manage User
4. Choose Add, Edit, or Delete

Tip

Best Practice: Create Assignee Users (the ones doing chores) before creating Approver Users (Parents). When creating an Approver, you can select which Assignees they are responsible for. If the Assignees don't exist yet, you'll have to edit the Approver later to add them.

---

User form sections

The current options flow uses three sections.

1) Identity and profile

Field	Required	Description
User Name	✅	Display name. Must be unique.
Home Assistant User (ha_user_id)	Optional	Links this profile to a Home Assistant account.
Language (dashboard_language)	Optional	Language used for dashboard content and notifications.
Notifications (mobile_notify_service)	Optional	Mobile notification service (for example, notify.mobile_app_phone).

2) System usage

Field	Required	Description
Can be assigned (allow_chore_assignment)	Optional	Allows chores to be assigned to this user profile. Creates user-assignee chore tracking and action entities.
Workflow enabled (enable_chore_workflow)	Optional (requires "Can be assigned")	Enables claim/disapprove workflow actions.
Gamification enabled (enable_gamification)	Optional (requires "Can be assigned")	Enables points, rewards, and gamification participation for this assignee profile.

3) Admin and approval

Field	Required	Description
Can approve (can_approve)	Optional	Enables approval/disapproval actions.
Can manage (can_manage)	Optional	Enables elevated management actions.
Associated Users	Conditional	Assignees this approver/admin supervises.

Tip

If Can approve is enabled, set Associated Users so the approval scope is explicit.

---

What appears after save

When you save a user profile, ChoreOps creates Home Assistant entities based on capabilities:

• Assignee capabilities create chore and workflow entities for that user.
• Gamification capability adds points/reward-related entities for that user.
• Approver/Admin capabilities enable approval and management actions for associated users.

Tip

Use this page for setup choices. For full entity naming, attribute contracts, and capability-to-entity mapping, see Technical: Users.

---

Common role patterns

• Assignee only: enable allow_chore_assignment
• Approver only: enable can_approve and set Associated Users
• Admin approver: enable can_approve + can_manage and set Associated Users
• Full participant: enable assignee + workflow + gamification + approval/admin as needed

---

Edit and delete

• Edit User: Configure → Manage User → Edit
• Delete User: Configure → Manage User → Delete

Warning

Deleting a user is permanent and removes related profile configuration and usage data.

---

Related documentation

• Quick Start Guide
• Configuration: Chores
• Configuration: Notifications
• Technical: Users
• Technical: Entities & States

---

Last Updated: February 2026 (role-based user flow)