Configuration: Rewards

Rewards are items that assignees can claim by spending their earned points.

Tip

Universal rewards: All assignees can claim any reward (no per-user reward assignment needed). Workflow: claim → approve/disapprove.

---

Creating a Reward

1. Settings → Devices & Services → ChoreOps → Configure
2. Select Manage Reward → Add Reward
3. Fill in the form and click Submit

Note

During initial setup, you'll be asked "Number of Rewards" - enter count or 0 to skip and add later.

---

Reward Configuration Fields

Field	Type	Required	Default	Description
Reward Name	Text	✅	-	Display name. Must be unique.
Reward Cost	Number	✅	10	Points required to claim. Min: 0
Description	Text	○	Empty	Optional notes.
Reward Labels	Label (multi)	○	None	Tags for organization (e.g., "treats", "toys").
Icon	Icon	○	mdi:gift-outline	Icon for entities.

Tip

Labels help organize: Use labels like "screen_time", "treats", "physical_items" for dashboard filtering.

---

Reward Claiming Workflow

1. Assignee claims → Approver notified (no points deducted yet)
2. Approver approves → Points deducted, reward granted, resets to Available
3. Approver disapproves → No points involved, resets to Available

Note

Rewards can be claimed multiple times. Each claim is a separate transaction.

Tip

Undo for assignees: Assignees can press the Disapprove button while in Claimed status to undo their claim. This is not tracked as a disapproval statistic.

---

Entities Created

Each reward creates entities per eligible assignee profile:

• Status sensor (for example sensor.<user>_choreops_reward_status_<name>)
• Claim button for assignees
• Approve/Disapprove buttons for approvers

Reward Sensor Attributes

Reward status sensors include claim state and summary statistics for the current user/reward pair.

For the full attribute contract, use the technical references below.

Note

See Technical: Entities & States and Technical: Points for complete entity and attribute details.

---

Managing Rewards

Edit a Reward: Configure → Manage Reward → Edit Reward.

Delete a Reward: Configure → Manage Reward → Delete Reward.

Warning

Deletion is permanent. All reward entities are removed. Pending claims are auto-disapproved with points refunded.

---

Notifications

Assignee and approver notifications are sent when rewards are claimed, approved, or disapproved. Configure this in Configuration: Notifications.

---

Troubleshooting

Issue	Solution
User can't claim reward	Check user has enough points (Cost ≤ Balance)
"A reward with this name already exists"	Choose a unique reward name
Reward entities missing	Reload integration after adding reward
Points not refunded on disapproval	Check coordinator logs for storage issues

---

Related Documentation

• Configuration: Users - Set up users to claim rewards
• Configuration: Points - Configure point earning and spending rules
• Configuration: Chores - How users earn points
• Technical: Entities & States - Complete entity details
• Advanced: Dashboard - Display rewards in dashboard

---

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