Configuration: Achievements

Prerequisites: Configuration: Users, Configuration: Chores, Configuration: Points Scope: Configure long-term assignee milestones

---

Overview

Achievements are personal milestone goals tied to one assignee or a selected assignee group.

Use achievements when you want:

• Long-term individual progression goals
• Habit and consistency tracking
• Automatic point rewards when a milestone is completed

Note

The achievement/challenge model is legacy and expected to evolve in future ChoreOps versions. This page documents the current configuration contract and will be updated as the model is re-imagined.

---

Create an achievement

1. Go to Settings → Devices & Services → ChoreOps → Configure
2. Select Manage Achievement
3. Choose Add Achievement
4. Complete the form and save

---

Field guide

Basic fields

Field	Required	Notes
Name	Yes	Unique achievement name
Description	No	Optional context for the goal
Labels	No	Optional organization tags
Icon	No	Material Design icon

Assignment and scope

Field	Required	Notes
Assigned Assignees	Yes	Who can progress this achievement
Selected Chore	No	Leave blank to count qualifying activity across all chores

Goal definition

Field	Required	Notes
Type	Yes	Goal behavior model (for example streak or completion mode)
Criteria	Yes	What is counted toward progress
Target Value	Yes	Milestone threshold
Reward Points	Yes	Points granted on completion

---

Behavior summary

• Tracking starts when the achievement is created
• Progress updates from qualifying chore lifecycle events
• Completing the achievement awards configured points
• Completed state remains available for history/reporting

Tip

Start with clear, easy-to-understand milestones first, then add more advanced achievement types after your household workflow is stable.

---

Recommended setup patterns

Pattern 1: First-week wins

• Set low target values
• Use modest reward points
• Focus on reinforcement and consistency

Pattern 2: Tiered personal milestones

• Create multiple achievements with rising targets
• Keep naming explicit (for example: 10, 25, 50, 100 completions)

Pattern 3: Chore-specific mastery

• Use selected chore targeting
• Pair with labels for easier filtering and reporting

Example goal ideas

• Chore Champion: Complete 100 approved chores
• Streak Star: Complete at least one chore each day for 14 days
• Kitchen Specialist: Complete 30 approved chores with a kitchen label

---

Achievements vs badges

• Use achievements for straightforward personal milestones and progress tracking
• Use badges when you need richer progression contracts, maintenance/reset cycles, or linked gamification flows
• Use linked badges on top of achievements when you want additional themed recognition

---

Troubleshooting

Achievement does not progress

• Confirm assigned assignee list includes the user
• Confirm criteria and selected chore alignment with real chore activity
• Confirm activity occurs after achievement creation time

Achievement not awarding points

• Confirm target value has been met
• Confirm reward points are configured
• Verify points updates in related entities/services

---

Related docs

• Configuration: Challenges
• Configuration: Badges overview
• Technical: Badges
• Technical: Entities & States

---

Last Updated: February 2026