> For the complete documentation index, see [llms.txt](https://doc.wearepatchworks.com/product-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/shape-notes.md).

# Shape notes

## Introduction

You can add notes to any shape in a process flow. This can be useful for many reasons - for example, to keep track of why certain shapes are used in more complex flows; to add reminders for any updates needed in future, or perhaps to leave guidance for another user.

## Need to know

* You can add a single note or multiple notes to each shape - there's no limit
* Any single note cannot exceed 64kb
* Notes are not encrypted - we strongly advise against adding sensitive information such as API keys, login credentials, payload data, etc.
* Notes are associated with a shape, not the process flow version, so if you add notes to shapes in a draft process flow and then deploy that process flow, the notes remain in the deployed version.

## Accessing shape notes

To access shape notes, click the notes icon for the required shape:

<div align="left"><figure><img src="/files/ty0PJDvqsf3z9CIJPaVI" alt="" width="327"><figcaption></figcaption></figure></div>

Any existing notes for this shape are displayed:

<div align="left"><figure><img src="/files/vhoH9WRoFeVm1s2wLt5s" alt="" width="375"><figcaption></figcaption></figure></div>

From here, you can click any existing note to open it in the [notes editor](#the-notes-editor), or use the **add note** button to [add a new note](#adding-a-new-note).

## Adding a new shape note

To add a new note for a shape, click the shape notes icon for the required shape and then click the add note button:

<div align="left"><figure><img src="/files/3pw3F7NBopmgSaieb2JG" alt="" width="375"><figcaption></figcaption></figure></div>

From here you can add required content via the [notes editor](#the-notes-editor), then save your note.

## The notes editor

Notes are added using a markdown editor, which includes a preview pane for rendered output:

<div align="left"><figure><img src="/files/6YOebhvHab1TIYZ59oRQ" alt="" width="563"><figcaption></figcaption></figure></div>

Standard markdown formatting can be used, or you can use the notes editor toolbar to apply formatting and add elements such as code blocks, tables and flow charts.

{% hint style="info" %}
Click [here ](https://www.markdownguide.org/cheat-sheet/)to view a markdown cheat sheet.
{% endhint %}

When adding/editing a note, you can apply a colour - perhaps useful to categorise different types of notes with a visual cue.

You can also mark a note as **private** (so only you can see it), or make it available for all users in your organisation. Once a note is saved, the rendered version is displayed in the notes panel.

## Shape note versioning

Notes persist to subsequent versions of a process flow. For example, if you add **two notes** to a `draft` process flow, then deploy that flow, the `deployed` process flow will have **two** **notes**.

If you go on to add **one more note** to the current `draft` version and then deploy this draft, the `deployed` process flow will have **three notes**. The `inactive` version will have **two notes**.

{% hint style="info" %}
For more information on process flow versions, see our [Process flow versioning](/product-documentation/process-flows/building-process-flows/process-flow-versioning.md) page.
{% endhint %}