> For the complete documentation index, see [llms.txt](https://docs.docontrol.io/docontrol-user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.docontrol.io/docontrol-user-guide/risk-management/alerts/manage-alerts/add-note.md).

# Add note

You can summarize the alert investigation or add important reminders in an alert note. Each alert note can be viewed and edited by all DoControl team members, even those who are not assigned to the alert.

{% hint style="info" %}

* You can add one note per alert.
* Add up to 500 characters per note.
* You need **Admin** permission to add an alert note.
  {% endhint %}

#### To add an alert note:

1. In the Alerts pane, select a specific alert.
2. Click **Add note**.<br>

   <div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FzRPFRacwPhEtsIoRlk3l%2Fadd%20note%20bar.png?alt=media&amp;token=b35305bf-383f-4368-bfa7-e23f989870fc" alt=""><figcaption></figcaption></figure></div>
3. Type your note. Use the [formatting options](#formatting-options-for-alert-notes) in the toolbar.<br>

   <div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2F8g82dLXCnySjFkyduV10%2Fadd%20note.png?alt=media&amp;token=7354b123-b554-48af-8639-51544915b4e9" alt=""><figcaption></figcaption></figure></div>
4. To add a screenshot to your note, click the **Image**<img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2F0s3C3Z3rBnAhBWYCJOnA%2Femail_insert_image.png?alt=media&amp;token=73c8bf9c-7848-4ba6-bc66-af7106076cc2" alt="" data-size="line">icon.
5. Click **Save**.
6. To view a note, select an alert and click **View note**.<br>

   <div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FpgibdO7XIhVT3LmWKrsb%2Fview%20note.png?alt=media&amp;token=a1058f14-7045-43c8-81e5-b18d4d3c64a7" alt=""><figcaption></figcaption></figure></div>
7. To delete a note, open it and click **Delete note**.

{% hint style="info" %}
After you delete a note, it will be deleted for all team members. You cannot restore a deleted note.
{% endhint %}

## Formatting options for alert notes

<table><thead><tr><th width="94">Icon</th><th width="222">Email formatting option</th><th>Description</th></tr></thead><tbody><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FzzmjoZaLzHkFDwN5eLB9%2Femail_bold.png?alt=media&amp;token=4cbae486-8609-47a3-8dc5-2440762af6b6" alt="" data-size="line"></td><td>Bold</td><td>Applies bolded font to selected text.</td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2Fk0CknDtlsuDiHzFoHMQm%2Femail_italic.png?alt=media&amp;token=7eebfbaa-8497-436a-b241-febfc765c26a" alt="" data-size="line"></td><td>Italics</td><td>Applies italicized font to selected text.</td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FDcwjd35xVDbayCuyTzLD%2Femail_strikethrough.png?alt=media&amp;token=5c16923d-c772-4e8a-abf5-54ca35e35b9d" alt="" data-size="line"></td><td>Strikethrough</td><td>Crosses out the selected text.</td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FjePib9LHSp99Xw0pZ1Ob%2Femail_paragraph.png?alt=media&amp;token=1883ee9c-63e1-46d9-a349-10638090ffde" alt="" data-size="line"></td><td>Paragraph</td><td>Applies paragraph style to selected text.</td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FwJ1LmkwK5nnDMJjWMfnX%2Femail_H1.png?alt=media&amp;token=da311691-669e-40d3-909b-28a06803977d" alt="" data-size="line"></td><td>Heading 1</td><td>Applies first-level heading style to selected text.</td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FSLbd7RqugniCewutsXm3%2Femail_H2.png?alt=media&amp;token=99ce5c57-6da0-463d-833e-c4df2e96189a" alt="" data-size="line"></td><td>Heading 2</td><td>Applies second-level heading style to selected text.</td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FZR1A1Bo5NlYvxDbeoRW9%2Femail_code.png?alt=media&amp;token=90298858-cec6-43ec-89f2-7adf63b0efb4" alt="" data-size="line"></td><td>Code</td><td>Applies code style to selected text.</td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FKXdxfeL3sG4XtSnK0RVJ%2Femail_code_block.png?alt=media&amp;token=a0b4a2af-33ea-4e21-8ba4-cb5f94fa91c6" alt="" data-size="line"></td><td>Code block</td><td>Applies code block style to selected text.</td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FM3t4xBHeZytS9bPKwjNy%2Femail_quote.png?alt=media&amp;token=61a385b5-c965-46ce-91fb-1eb4a2fa280f" alt="" data-size="line"></td><td>Quote</td><td>Applies block quote to selected text.</td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FlrHTUBf030M2Htyr45GS%2Femail_bullets.png?alt=media&amp;token=e49d7b5e-36fd-471c-9624-8008981a0359" alt="" data-size="line"></td><td>Bulleted list</td><td>Applies bullets to an unordered list.</td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FfWpdHrZAvy4kW9kSRbFV%2Femail_numbers.png?alt=media&amp;token=5e46c3cd-dd85-4d40-abf7-9ccd231e80eb" alt="" data-size="line"></td><td>Ordered list</td><td>Applies numbering to an ordered list.</td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2Fq77Uh1T8az69Zs445IgU%2Femail_line_break.png?alt=media&amp;token=51065810-3d95-48fd-858c-547d55223d79" alt="" data-size="line"></td><td>Line break</td><td>Splits a long line into two lines.</td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FoW2qSZBOCM0WgL8MKQET%2Femail_rule.png?alt=media&amp;token=12b1a734-c097-4e0d-883f-be77677c0f2e" alt="" data-size="line"></td><td>Horizontal rule</td><td>Inserts a horizontal divider between sections.</td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2F4WETLuAEABx2KCiDEWwx%2Femail_clear_format.png?alt=media&amp;token=a86b68b2-41a1-4025-b450-77660386a0d3" alt="" data-size="line"></td><td>Clear format</td><td>Removes all applied formatting.</td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2F0s3C3Z3rBnAhBWYCJOnA%2Femail_insert_image.png?alt=media&amp;token=73c8bf9c-7848-4ba6-bc66-af7106076cc2" alt="" data-size="line"></td><td>Insert image</td><td>Uploads an image file. You can modify the zoom level and size of the image as you upload it.</td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2F768EF4y88mZnGHJ8Y5xl%2Femail_undo.png?alt=media&amp;token=c5aa6d8e-b1e0-41df-ba66-df76ea54ec32" alt="" data-size="line"></td><td>Undo</td><td>Removes previously applied formatting.</td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FAawyNgNsnALjSVSu9n3U%2Femail_redo.png?alt=media&amp;token=4606671d-942b-41bb-b4da-dd6666ec9b41" alt="" data-size="line"></td><td>Redo</td><td>Re-applies last formatting that was removed.</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.docontrol.io/docontrol-user-guide/risk-management/alerts/manage-alerts/add-note.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
