Skip to content

Chores

Jump to bottom
tempus2016 edited this page Mar 24, 2026 · 3 revisions

Managing Chores

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

You can add chores one at a time or in bulk (multiple chores with the same settings in one step).

Chore Fields

Field Default Description
Name — Display name shown on the child card
Description "" Optional subtitle shown below the name when enabled on the card
Points 10 Stars earned when the chore is completed and approved
Time of Day anytime Groups the chore into a time slot — controls which child card instance shows it
Scheduling Mode specific_days specific_days — appear on selected days. recurring — rolling recurrence window.
Due Days none Days of the week this chore is scheduled — see below
Assigned To all children Which children this chore belongs to — leave empty for all
Requires Approval true If on, completion is pending until a parent approves it
Daily Limit 1 How many times per day this chore can be completed
Completion Sound coin Sound played when ticked off on the child card

Time of Day

Value When to use
morning Chores done before school / after waking
afternoon After school chores
evening Before dinner / homework
night Bedtime routine
anytime No time restriction — always shown

The child card can be configured to show only chores matching a specific time category. You can have multiple child cards on the same dashboard for different times of day.

Due Days

Optionally restrict a chore to specific days of the week. Valid values:

monday tuesday wednesday thursday friday saturday sunday

Example: A homework chore that only applies Monday–Friday.

How the child card handles chores not due today is controlled by the due_days_mode card config:

Mode Behaviour
hide Chores not due today are hidden entirely (default)
dim Chores not due today are shown greyed out and non-interactive
show All chores shown regardless of schedule

Note: Due days are currently set via the config flow. A dedicated UI for due day selection is planned.

Assigned To

By default, chores are assigned to all children. To assign a chore to specific children, select the child names during chore creation/editing.

When assigned to specific children, only those children will see the chore on their child card.

Requires Approval

When requires_approval is on:

  1. Child taps the chore on the child card
  2. The chore shows as completed (ticked) but grayed out
  3. The child's pending_points balance increases
  4. The parent sees the completion in the Approvals card / Parent Dashboard
  5. Approve → points move from pending to the child's balance
  6. Reject → completion removed, no points awarded

When requires_approval is off:

  • Points are awarded immediately on completion

Daily Limit

Controls how many times a chore can be completed in a single day. Useful for:

  • Chores that can be done multiple times (e.g. "Drink a glass of water" × 5)
  • Preventing accidental double-completions

The child card shows (0/5) style progress when daily_limit > 1.

Completion % Per Month

Value Meaning
100 Expected every day (daily chore)
50 Expected every other day
25 Expected about weekly
14 Expected roughly twice a month

Set this accurately for rewards to take the expected number of days to reach.

Completion Sound

Each chore can have its own sound that plays when it's ticked off on the child card. This overrides the card's default_sound setting.

Available sounds: none, coin, levelup, fanfare, chime, powerup, undo, fart1–fart10, fart_random

See Completion Sounds for descriptions of each sound.

Bulk Adding Chores

Use Add Multiple Chores to create several chores at once with the same settings. Enter chore names one per line or comma-separated:

Make Bed
Brush Teeth
Tidy Bedroom
Put Shoes Away

All created chores will share the same points, time of day, assignment, and other settings. You can edit them individually afterwards.

Chore IDs

Each chore has an auto-generated 8-character ID (e.g. b3f9a12c). This ID is used in:

  • Service calls (taskmate.complete_chore)
  • The assigned_to field in child records
  • Chore order lists

To find a chore's ID: Developer Tools → States → sensor.taskmate_overview → expand attributes → look in the chores array.

Clone this wiki locally