Configuration: Badges Cumulative

Prerequisites: Configuration: Points, user profiles with gamification enabled Scope: Set up long-term rank progression badges

Note

In kid-facing dashboard wording, these may be presented as Rank Badges or simply Ranks. In Home Assistant configuration screens, the setup flow still uses Cumulative Badge terminology.

---

Overview

Cumulative badges are long-term rank milestones based on lifetime points.

Use them when you want:

• Tier progression (for example Bronze → Silver → Gold)
• Ongoing multiplier rewards for sustained effort
• Optional maintenance requirements to keep higher tiers active

Tip

Cumulative badges are best for long-term motivation. In dashboard language, think of them as Rank Badges. Use periodic/daily badges for short-cycle missions or Quest Badges.

---

Create a cumulative badge

1. Go to Settings → Devices & Services → ChoreOps → Configure
2. Select Manage Badge
3. Choose Add Cumulative Badge
4. Complete fields and save

---

Field guide

Basic fields

Field	Required	Notes
Badge Name	Yes	Unique display name
Description	No	Optional guidance text
Labels	No	Optional organization tags
Icon	No	Material Design icon

Target and maintenance

Field	Required	Notes
Threshold Value	Yes	Lifetime points required
Maintenance Points	No	Points required per cycle to keep higher-tier status

Assignment

Field	Required	Notes
Assigned To	Yes	Select at least one eligible profile

Note

Some UI labels and keys still use legacy assignment wording. Keep those literal labels in forms as-is.

Awards

You can configure one or more award items:

• Points
• Rewards
• Bonuses
• Multiplier

Tip

Use conservative multipliers. Larger base chore points usually need smaller multipliers.

Maintenance schedule (optional)

Configure recurring evaluation windows (daily/weekly/monthly/etc.) and optional grace days.

---

Behavior summary

Earning and progression

• Profile earns points over time
• Badge is awarded when threshold is reached
• Higher thresholds unlock higher tiers

Maintenance and demotion

If maintenance is enabled:

• Meeting maintenance target keeps current tier behavior active
• Missing maintenance target can move effective tier down
• Regaining required points restores higher-tier status

---

Recommended starting pattern

For a 3-tier setup:

• Tier 1: reachable in first month
• Tier 2: medium-term stretch
• Tier 3: long-term target

Keep early tiers motivating, but leave enough spacing for meaningful progression.

---

Troubleshooting

Badge not awarding

• Verify profile is assigned to the badge
• Verify threshold value and current lifetime points
• Confirm gamification is enabled for the user profile

Multiplier not applied as expected

• Check badge status in entity state
• Verify multiplier is configured in award items
• Confirm maintenance requirements are being met (if enabled)

Assignment changes not reflected

• Save and reload integration if needed
• Recheck assigned profile list in badge editor

---

Related docs

• Configuration: Periodic Badges (Quest badges)
• Configuration: Badges overview
• Advanced: Cumulative Badges (Rank badges)
• Technical: Badges

---

Last Updated: March 2026 (dashboard terminology bridge for Rank badge wording)