> For the complete documentation index, see [llms.txt](https://docs.protoboard.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.protoboard.xyz/editor/groups-and-notes.md).

# Groups and notes

Organize the canvas with coloured groups around related parts and sticky notes linked to the parts they describe

## Goal

Keep larger boards readable by framing subsystems in groups and leaving notes next to the parts they're about.

## Groups

A group is a coloured, labelled frame on the canvas. Parts, notes and other groups can sit inside it, and they move with it.

### Create a group

{% embed url="<https://cdn.protoboard.ai/docs/clip/group-selection?title=Group+selected+parts>" %}
Group selected parts
{% endembed %}

[Animated GIF](https://cdn.protoboard.ai/docs/clips/group-selection-light.gif) · Steps:

1. Select the parts and notes to group: drag a box on empty canvas, or Shift+click each one.
2. Click **Add group** in the canvas toolbar, or right-click and choose **Group**. The group wraps the selection.
3. In the Inspector, type a name and pick a **Color** (or a custom colour).

With nothing selected, **Add group** places an empty group in view. Drag parts into it to add them; drag them out to remove them.

### Change or remove a group

* Drag the group's edges to resize it.
* In the Inspector, **Remove from group** takes one member out.
* **Ungroup (keeps members)**, or right-click **Ungroup**, removes the frame and keeps the parts.
* **Delete group and members** removes the frame and everything in it.

<figure><picture><source srcset="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-e634a6f48ed33ad45b7e6394981acfb94e710d9a%2Fcontext-menu-group-dark.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-8c0f6c4f9d54ed7efce2db56742a82ed405ff70b%2Fcontext-menu-group-light.png?alt=media" alt="The right-click menu on a group with Ungroup"></picture><figcaption><p>The group menu.</p></figcaption></figure>

## Notes

A note is a sticky note on the canvas, up to 500 characters.

### Add a note

{% embed url="<https://cdn.protoboard.ai/docs/clip/note-add?title=Add+a+note+and+connect+it>" %}
Add a note and connect it
{% endembed %}

[Animated GIF](https://cdn.protoboard.ai/docs/clips/note-add-light.gif) · Steps:

1. Click **Add note** in the canvas toolbar. The note lands in free space.
2. Double-click it and type.
3. To point it at a part, keep the note selected, choose **Connect annotation** in the Inspector, pick the part and click **Create**.

A note connection draws a line from the note to the part. Select the line to remove it with **Delete connection**.

{% hint style="info" %}
**Add note** on the canvas makes a sticky note. The **Add note** button in Board Review adds a review comment instead. See [Board Review and review comments](https://docs.protoboard.xyz/validate-and-build/board-review.md).
{% endhint %}

## Common failures

<details>

<summary>A part won't join the group</summary>

Drag it fully inside the group's frame, or select it with the other members and group again.

</details>

## Related pages

* [Editor tour and canvas basics](https://docs.protoboard.xyz/editor/canvas-basics.md)
* [Inspector](https://docs.protoboard.xyz/editor/inspector.md)
* [Build a line-following robot](https://docs.protoboard.xyz/tutorials/line-following-robot.md)
