# canvas.groups

> Named visual groups of canvas nodes.

Named visual groups of canvas nodes.

- **Type:** list of object
- **Since:** manifest v1

## Example

```yaml
canvas:
  groups:
    - name: backend
      nodes:
        - services.api
```

## Fields

### name

`canvas.groups[].name`

Stable group name.

- **Type:** [name](/docs/manifest/#name)
- **Required:** yes
- **Since:** manifest v1

```yaml
canvas:
  groups:
    - name: backend
```

### label

`canvas.groups[].label`

Display label.

- **Type:** string
- **Maximum length:** 100
- **Since:** manifest v1

```yaml
canvas:
  groups:
    - label: Back end
```

### nodes

`canvas.groups[].nodes`

Canvas node keys in this group.

- **Type:** list of string
- **Required:** yes
- **Since:** manifest v1

```yaml
canvas:
  groups:
    - nodes:
        - services.api
```

### colour

`canvas.groups[].colour`

Group colour.

- **Type:** string
- **Pattern:** `^(#[0-9a-fA-F]{6}|grey|blue|green|amber|red|purple|teal|pink)$`
- **Since:** manifest v1

```yaml
canvas:
  groups:
    - colour: blue
```

## See also

- [canvas](/docs/manifest/canvas/): all fields of `canvas`
- [guv.yaml reference](/docs/manifest/)