Configuration: Notifications

Configuration: Notifications

ChoreOps sends Home Assistant mobile notifications to keep assignees and approvers informed about chore, reward, and points activity.

---

What you can configure

You can control notifications at two levels:

1. Per-user delivery (which device/service receives messages)
2. Per-chore moments (which chore events trigger reminders)

Tip

Keep high-signal notifications on (overdue, disapproval, reminder) and disable low-signal events for routine chores.

---

Notification event groups

Chore events

Event	Typical recipient	Action buttons	Auto-clear
Chore Claimed	Approver	Approve / Disapprove / Remind	Yes
Chore Approved	Assignee	No	Yes
Chore Disapproved	Assignee	No	Yes
Chore Now Due	Assignee	Claim	Yes
Chore Reminder	Assignee	Claim	Yes
Chore Overdue	Assignee + Approver	Claim (assignee), Complete/Skip/Remind (approver)	Yes
Chore Missed	Assignee + Approver	No	No

Reward events

Event	Typical recipient	Action buttons	Auto-clear
Reward Claimed	Approver	Approve / Disapprove / Remind	Yes
Reward Approved	Assignee	No	Yes
Reward Disapproved	Assignee	No	Yes

Gamification events

Examples include badge, achievement, challenge, bonus, and penalty notifications when those features are enabled.

---

Due-date notifications explained

Chore due timing uses separate notification moments:

• Chore Now Due: sent when the due window opens
• Chore Reminder: sent before the due time
• Chore Overdue: sent after the due time passes

Example timeline for a chore due at 5:00 PM with common defaults:

• 4:00 PM → Chore Now Due
• 4:30 PM → Chore Reminder
• 5:00 PM → Chore Overdue (if still incomplete)

---

Action buttons

Approver actions

• Approve
• Needs Work / Disapprove
• Complete (for overdue workflows)
• Skip (reschedule overdue chore)
• Remind in 30 min

Assignee actions

• I Did It / Claim (claim from due/reminder/overdue notifications)

---

Configure notification delivery per user

1. Go to Settings → Devices & Services → ChoreOps → Configure
2. Open Manage User
3. Edit a user profile
4. Set Notification Service (for example notify.mobile_app_phone)
5. Save

Leave the notification service blank to disable direct notifications for that profile.

---

Configure per-chore reminder behavior

1. Open Manage Chore in the ChoreOps config flow
2. Edit the target chore
3. Configure due-window, reminder, and overdue notification options
4. Save

This lets you keep reminders on for high-priority chores while silencing routine chores.

---

Language behavior

Notification text uses each recipient’s configured user language.

• Mixed-language households are supported
• Missing translations fall back to English
• Titles, body text, and action labels are localized

Set language in Manage User for each profile.

---

Mobile app requirements

To receive actionable notifications:

• Install the Home Assistant Companion App (iOS/Android)
• Sign in to your Home Assistant instance
• Allow notification permissions
• Use the matching notify.mobile_app_* service in the user profile

---

Troubleshooting

Not receiving notifications

• Confirm user has a valid notification service
• Confirm mobile app is installed and logged in
• Confirm notification permission is enabled on device
• Confirm chore notification options are enabled for that chore

Wrong language

• Check user profile language
• Save profile and retry a notification event

Action buttons do nothing

• Confirm notification came from Companion App (not browser push)
• Update Companion App to a recent version

---

Related documentation

• Configuration: Users
• Configuration: Chores
• Advanced: Chores
• Technical: Notifications

---

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