Grouping Settings

Table of Contents

1. workspaceTasks.groups.enabled
2. workspaceTasks.groups.useParentFolder
3. workspaceTasks.groups.taskSeparator
4. workspaceTasks.groups.recentTasks.enabled
5. workspaceTasks.groups.compoundTasks.enabled
6. workspaceTasks.groups.expanded
7. Related

---

workspaceTasks.groups.enabled

Type: boolean Default: true

When enabled, tasks in the tree view are grouped by task type (e.g. npm, shell, vscode). When disabled, all tasks from all providers appear in a flat list.

Example:

{
  "workspaceTasks.groups.enabled": true
}

---

workspaceTasks.groups.useParentFolder

Type: boolean Default: false

When enabled, tasks are additionally sub-grouped by the folder that contains their source file, giving a workspace-folder > task-type > folder > task hierarchy. When disabled, tasks are grouped at workspace-folder > task-type > task level.

Example:

{
  "workspaceTasks.groups.useParentFolder": true
}

---

workspaceTasks.groups.taskSeparator

Type: string Default: ""

A string that is inserted between the task-type group label and the task name when rendering tree items. Leave empty for no separator.

Example:

{
  "workspaceTasks.groups.taskSeparator": " › "
}

---

workspaceTasks.groups.recentTasks.enabled

Type: boolean Default: false

When enabled, a Recent Tasks group is shown at the top of the task tree, surfacing the most recently executed tasks for quick access.

Example:

{
  "workspaceTasks.groups.recentTasks.enabled": true
}

---

workspaceTasks.groups.compoundTasks.enabled

Type: boolean Default: false

When enabled, a Compound Tasks group is shown at the top of the task tree, listing all defined compound task sequences for quick access. Has no effect if compound tasks are not configured.

Example:

{
  "workspaceTasks.groups.compoundTasks.enabled": true
}

---

workspaceTasks.groups.expanded

Type: object Default: { "favorites": true, "compoundTask": true, "recent": true }

Controls which special group headers are expanded by default when the task tree loads. Each property corresponds to one of the pinned groups at the top of the tree. Set a key to false to start that group collapsed.

Property	Type	Default	Description
favorites	boolean	true	Whether the Favorites group starts expanded
compoundTask	boolean	true	Whether the Compound Tasks group starts expanded
recent	boolean	true	Whether the Recent Tasks group starts expanded
queue	boolean	—	Deprecated. Use compoundTask instead

Note: The queue key is retained for backward compatibility only. Set compoundTask instead.

Example — collapse Recent Tasks on startup:

{
  "workspaceTasks.groups.expanded": {
    "favorites": true,
    "compoundTask": true,
    "recent": false
  }
}

---

Related

• Recent Tasks
• Task Filtering