Rewards

Managing Rewards

Access via Settings → Integrations → TaskMate → Configure → Manage Rewards.

---

Reward Fields

Field	Default	Description
Name	—	Display name shown on the rewards card
Description	""	Optional subtitle
Cost	50	Fixed point cost — set by the parent
Icon	mdi:gift	Icon shown on the rewards card
Assigned To	all	Which children can earn this reward — leave empty for all children
Is Jackpot	false	Pool points from all assigned children toward this reward

---

Reward Types

Standard

Set a Cost — a fixed number of points the child needs to earn this reward. That's it. The cost never changes automatically.

Jackpot Rewards

Enable Is Jackpot. All assigned children's points pool together toward one shared goal.

• The rewards card shows a colour-coded contribution bar — each segment represents one child's contribution
• Any child can claim the jackpot reward once the pool reaches the goal
• Great for big family goals: holidays, day trips, expensive treats

---

Reward Approval Flow

Claiming a reward is a two-step process to give parents control:

Child taps Claim
      ↓
Pending claim created
Points NOT deducted yet
      ↓
Parent sees claim in Parent Dashboard → Claims tab
      ↓
    Approve                    Reject
      ↓                          ↓
Points deducted           Claim cancelled
Reward granted            No points affected

After claiming, the rewards card shows "Awaiting parent approval" instead of the claim button.

The binary_sensor.taskmate_has_pending_approvals turns on when there are pending claims (as well as pending chore completions).

---

Reward Icons

Available icons include:

mdi:gift mdi:ice-cream mdi:pizza mdi:movie mdi:gamepad-variant mdi:tablet mdi:television mdi:bike mdi:currency-usd mdi:shopping mdi:party-popper mdi:swim mdi:sleep mdi:candy

Any valid MDI icon can be entered manually.

---

Reward IDs

Each reward has an auto-generated 8-character ID. To find it:

Developer Tools → States → sensor.taskmate_overview → expand attributes → look in the rewards array.

The ID is used in:

• The reward_progress card (reward_id config option)
• Service calls (taskmate.claim_reward, taskmate.approve_reward, taskmate.reject_reward)