# Use notes on canvas

While creating or editing a transformation or job, you can add notes to the canvas to help you and others understand the structure, design decisions, business rules, dependencies, and other aspects of your transformations and jobs.&#x20;

For instructions on creating and editing transformations and jobs, see [Create a job](broken://pages/eI9zUxWpJJGBsGcLiYMc), [Create a transformation](broken://pages/Bj0Q1QSvXmarGMgvgLUq), and [Edit a transformation or job](broken://pages/H2AkMmSZ5npWhak5xXPD).

With a transformation or job open, take one or more of the following actions.

* [Add a note](#add-a-note)
* [Edit a note](#edit-a-note)
* [Reposition a note](#reposition-a-note)
* [Delete a note](#delete-a-note)

## Add a note

1. In the canvas toolbar, click the **Add Note** icon. The **Notes** dialog box opens.&#x20;
2. In the **Note** box, enter the content for the note.
3. To format the note, click **Style**, and then enter the font, color, and shadow options you want to use for the note.
4. Click **Save**. The note appears on the canvas.

## Edit a note

1. Hover over the note on the canvas. The Delete and Edit icons are displayed above the note.
2. Click the Edit icon. The Notes dialog box opens.&#x20;
3. In the **Note** box, edit the content of the note.
4. To edit the format of the note, click **Style**, and then edit the font, color, and shadow options for the note.
5. Click **Save**. The edited note is saved.

## Reposition a note

To reposition a note, click and drag the note on the canvas to the location where you want it to appear.

## Delete a note

1. Hover over the note on the canvas. The Delete and Edit icons are displayed above the note.
2. Click the **Delete** icon. The note is deleted.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pentaho.com/pdia-data-integration/pipeline-designer/use-notes-on-canvas.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
