Skip to content

Admin Panel

Jump to bottom
tempus2016 edited this page May 13, 2026 · 3 revisions

The Admin Panel is a web-based management dashboard accessible from the Home Assistant sidebar. It provides a single interface for managing all TaskMate configuration without navigating through the standard HA integration settings.

Accessing the Panel

After installing TaskMate, a TaskMate entry appears in the HA sidebar with the icon mdi:checkbox-marked-circle-plus-outline.

Click it to open the panel at /taskmate-admin.

Note: The panel requires an admin HA user. Non-admin users will not see the sidebar entry.

What You Can Do

The admin panel provides full management for every aspect of TaskMate:

Child Management

  • Add new children with name and avatar
  • Edit existing children (name, avatar, availability entities)
  • Remove children
  • View child stats (points, streaks, completions)

Chore Management

  • Create chores with all configuration options
  • Edit any chore field including assignment mode, scheduling, visibility, and bonus subtasks
  • Configure timed task settings (rate, cap)
  • Delete chores
  • Reorder chores per child

Reward Management

  • Create rewards with cost, icon, and assignment
  • Toggle pool mode (savings jar) per reward
  • Configure jackpot rewards
  • Set quantity limits and expiration dates
  • Delete rewards

Penalty & Bonus Management

  • Create, edit, and delete penalty/bonus definitions
  • Apply penalties and bonuses to children directly

Task Group Management

  • Create task groups with sticky or spread policy
  • Select which chores belong to each group
  • Edit and delete groups

Settings

  • Configure all global settings:
    • Points currency name and icon
    • Weekend multiplier
    • Streak reset mode and milestones
    • Perfect week bonus
    • Notification service
    • Calendar projection days
    • History retention
    • Time-of-day boundaries (morning/afternoon/evening/night windows)
    • Show IDs toggle (see below)

Badge Management

  • View built-in badge catalogue with enable/disable toggles
  • Edit built-in badge settings (tier, point bonus, assignment, notify-on-earn)
  • Create, edit, and delete custom badges with multi-criterion rules
  • View award history with AUTO / MANUAL / SILENT source indicators
  • Revoke awarded badges with automatic point bonus reversal

Notification Management (v3.9.0+)

  • Configure per-child notify services
  • Add, edit, and delete parent recipients
  • Configure the recipient routing matrix (which recipients get which notification types)
  • Set per-recipient bedtime times for bedtime reminders
  • Set global streak-at-risk cutoff time
  • Create, edit, and delete custom scheduled notifications with day masks and recipient selection

Approval Workflows

  • Approve or reject pending chore completions
  • Approve or reject pending reward claims

Show IDs (v3.7.0+)

A toggle in the Settings tab that displays internal hex IDs on every entity card and row throughout the admin panel. These IDs are needed when writing automations or service calls (e.g. taskmate.complete_chore requires a chore_id).

How to use

  1. Go to the Settings tab in the admin panel
  2. Flip the Show IDs toggle
  3. ID badges appear immediately on all entity types:
Tab Where
Children Below child name in card
Chores Below chore name in row
Rewards Below reward name in card
Penalties Below penalty name in card
Bonuses Below bonus name in card
Groups Below group name in card

Each badge shows the full 16-character hex ID with a copy button. Click the copy icon to copy the ID to your clipboard — a "Copied!" toast confirms.

The toggle is stored in your browser's localStorage — it's a per-browser preference with no backend change or restart required.

Tip: You may not need to find IDs at all. Since v3.7.0, the HA automation editor shows entity names in dropdown selectors instead of blank text fields for all TaskMate service calls. See Services — Dynamic Selectors.

Real-Time Updates

The admin panel communicates via WebSocket, so changes are reflected immediately without page refreshes. Any changes made in the panel are instantly visible on dashboard cards.

Internationalisation

The admin panel is fully translated in all supported languages:

Language Code
English en
English (GB) en-GB
French fr
German de
Norwegian Bokmål nb
Norwegian Nynorsk nn
Portuguese pt
Portuguese (Brazil) pt-BR

The panel follows your Home Assistant language setting automatically.

Panel vs Config Flow

You can manage TaskMate through either the admin panel or the standard config flow (Settings → Integrations → TaskMate → Configure). Both interfaces modify the same data.

Feature Admin Panel Config Flow
Child CRUD Yes Yes
Chore CRUD Yes Yes
Reward CRUD Yes Yes
Penalty/Bonus CRUD Yes Yes
Task Groups Yes No
Settings Yes Yes
Approvals Yes No
Timed task config Yes Yes
Badge management Yes No
Notification routing Yes No
Custom notifications Yes No
Time-of-day boundaries Yes No

The admin panel is generally more convenient for day-to-day management, while the config flow is useful for initial setup.

Related

Clone this wiki locally