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
Default points per chore	✅	5.0	Starting points value for new chores

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

Default points per chore behavior

• Applies to new chores when you do not set a custom chore points value
• Existing chores keep their stored points value until edited
• Value must be greater than 0 and may include up to 2 decimal places

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, including decimal values

Spending points

• Approved rewards deduct reward cost
• Penalty actions deduct penalty value
• Balances can go below zero when penalties are applied
• Manual service adjustments can also add or deduct decimal values directly

Multipliers

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

---

Bonuses and penalties

Bonuses and penalties are optional point adjustments you can apply for behavior outside normal chore completion.

Where to configure them

Path: Settings → Devices & Services → ChoreOps → Configure

• Manage Bonus: Create named positive point adjustments
• Manage Penalty: Create named negative point adjustments

You can then apply them from UI actions or services.

How they affect points

• Bonus adds points to the assignee balance
• Penalty deducts points from the assignee balance
• Penalties can push balances below zero
• Badge multipliers do not affect bonus earnings, and do not change penalty deductions

Recommended usage patterns

• Use bonuses for discretionary recognition (helping sibling, extra initiative)
• Use penalties sparingly and predictably
• Prefer clear, predefined amounts over frequent ad-hoc 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: General options
• Configuration: Users
• Configuration: Chores
• Configuration: Rewards
• Technical: Points

---

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