# Task Configuration
Defines individual tasks within a Planner board with assignments, due dates, and checklists.
Referenced by: PlannerCfg.Tasks (nested array).
# Overview
TaskCfg defines a single task within a Planner board. Tasks have assignments, due dates, checklists, attachments, and category tags.
# Applied when
Tasks are created when:
- The parent
PlannerCfgis provisioned and includes this task in theTasksarray - Applied after the Planner board is created; tasks are created as part of board initialization
- The
Bucketname must match a bucket defined inPlannerCfg.Buckets; if the bucket is not found, the task may not be assigned to it - All task properties (due date, start date, assignments, checklists) are applied when the task is created
- Tasks are immediately visible in Planner and can be assigned to team members
# Core settings
# Name
Type: string | Default: — | Required: Yes
Task title. Must not be empty. Leading and trailing whitespace is automatically trimmed.
# Bucket
Type: string | Default: — | Required: No
Bucket name this task belongs to (must exist in PlannerCfg.Buckets).
# Description
Type: string | Default: — | Required: No
Task description and details.
# Scheduling
# StartDate
Type: string? | Default: — | Required: No
Task start date (ISO 8601 format: YYYY-MM-DD).
# DueDate
Type: string? | Default: — | Required: No
Task due date (ISO 8601 format: YYYY-MM-DD).
# Assignments and tracking
# Assignments
Type: string (list) | Default: — | Required: No
Array of assignee email addresses.
# OrderHint
Type: string? | Default: — | Required: No
Display order hint (internal).
# Categories
# Category1
Type: bool | Default: — | Required: No
Mark task with category 1 (as defined in parent PlannerCfg.Category1).
# Category2
Type: bool | Default: — | Required: No
Mark task with category 2 (as defined in parent PlannerCfg.Category2).
# Category3
Type: bool | Default: — | Required: No
Mark task with category 3 (as defined in parent PlannerCfg.Category3).
# Category4
Type: bool | Default: — | Required: No
Mark task with category 4 (as defined in parent PlannerCfg.Category4).
# Category5
Type: bool | Default: — | Required: No
Mark task with category 5 (as defined in parent PlannerCfg.Category5).
# Category6
Type: bool | Default: — | Required: No
Mark task with category 6 (as defined in parent PlannerCfg.Category6).
# Details
# CheckList
Type: string (list) | Default: — | Required: No
Array of checklist items to create.
# Attachments
Type: string (list) | Default: — | Required: No
Array of attachment file names or URLs.
# Related
- Planner Configuration — parent Planner board