Configuration: Points

The points system is your household currency in ChoreOps. Users earn points from approved activity and spend points on rewards.

Tip

Point label and icon are system-wide settings. Every user sees the same point name and icon.

---

Configure points

Points label and icon

Path: Settings → Devices & Services → ChoreOps → Configure → Manage Points

Field	Required	Default	Purpose
Points label	✅	Points	Display name such as Stars, Coins, or Tokens
Points icon	Optional	mdi:star-outline	Icon used in dashboard cards and entities

Changing these values updates display text/icon only. User balances and history are preserved.

Manual adjustment values

Path: Configure → General Options → Manual Points Adjustment Button Values

• Enter values separated with |
• Default: +1.0 | -1.0 | +2.0 | -2.0 | +10.0 | -10.0
• Example: +5.0 | -5.0 | +10.0 | -10.0 | +25.0 | -25.0

These values define the quick add/subtract point buttons available for users with points enabled.

---

How points work

Earning points

• Approved chores add points using each chore's configured value
• Approved bonuses add points using the bonus value
• Manual + buttons add exactly the configured amount

Spending points

• Approved rewards deduct reward cost
• Penalty actions deduct penalty value
• Balances can go below zero when penalties are applied

Multipliers

Badge multipliers apply to earned points from chores and bonuses. Multipliers do not apply to reward costs, penalties, or manual adjustments.

---

User setup requirements

To participate in points, configure the user with:

• Can be assigned (allow_chore_assignment)
• Gamification enabled (enable_gamification)

Approver/admin-only users can still review and approve, but they do not get a user points sensor unless assignment and gamification are enabled.

---

Quick validation checklist

• User has assignment + gamification enabled
• At least one chore/reward is assigned to that user
• Point adjustment values are configured if you want quick manual buttons
• Reward approvals are enabled for the approver scope

---

Troubleshooting

Issue	What to check
Label/icon looks outdated	Re-open Manage Points and save settings
Manual point buttons missing	Confirm manual values are configured in General Options
User points not changing	Verify approval happened and user has gamification enabled
Statistics warning after renaming points label	Expected when Home Assistant unit labels change; resolve in Developer Tools → Statistics

---

Related documentation

• Configuration: Users
• Configuration: Chores
• Configuration: Rewards
• Technical: Points

---

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