> ## Documentation Index
> Fetch the complete documentation index at: https://help.hoopai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Notes

> Create, edit, pin, and search notes on contact records to capture context and keep your team informed in the HoopAI Platform.

Notes let you record free-form information directly on a contact record — call summaries, preferences, background details, or anything else your team needs to remember. Every note is timestamped, searchable, and visible to all team members with access to the contact.

## Accessing notes

Open any contact record and click the **Notes** tab in the right-side information panel. All existing notes for that contact are displayed in reverse chronological order (newest first).

***

## Creating a note

<Steps>
  <Step title="Open the Notes tab">
    Navigate to **Contacts > Smart Lists**, click a contact's name to open their record, then select the **Notes** tab in the right-side panel.
  </Step>

  <Step title="Click Add">
    Click **+ Add** to open the note editor.
  </Step>

  <Step title="Write your note">
    Enter your note text in the editor. Notes support plain text and can be as long as needed. Common uses include:

    * Call summaries and next steps
    * Client preferences and personal details
    * Meeting outcomes and decisions made
    * Concerns, objections, or special handling instructions
  </Step>

  <Step title="Save the note">
    Click **Save** to attach the note to the contact record. The note appears immediately with your name and a timestamp.
  </Step>
</Steps>

<Frame caption="Creating a new note on a contact record">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/ISC7y4WirTQDUcmj/images/contacts-restore-overview.png?fit=max&auto=format&n=ISC7y4WirTQDUcmj&q=85&s=1d7c059b900935f8cb33d49c2d6a8c4f" alt="Adding a note to a contact record" width="1629" height="414" data-path="images/contacts-restore-overview.png" />
</Frame>

***

## Editing a note

<Steps>
  <Step title="Locate the note">
    In the **Notes** tab, find the note you want to update.
  </Step>

  <Step title="Open the edit view">
    Click the **pencil icon** on the note card to open the editor.
  </Step>

  <Step title="Update and save">
    Make your changes, then click **Save**. The note retains its original timestamp but shows that it has been edited.
  </Step>
</Steps>

***

## Deleting a note

Click the **trash icon** on the note card to delete it. A confirmation prompt appears before the note is permanently removed.

<Warning>
  Deleting a note is permanent and cannot be undone. If you want to preserve the content, edit the note rather than deleting it.
</Warning>

***

## Searching and sorting notes

Use the **search bar** at the top of the Notes tab to find notes by keyword. This is especially useful on contacts with a long history.

Use the **sort control** to switch between:

* **Newest first** — default view; most recent notes appear at the top
* **Oldest first** — useful for reviewing the full chronological history of a contact

***

## Pinning notes

<Frame caption="Pinned notes appear at the top of the contact notes list">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/ISC7y4WirTQDUcmj/images/contacts-restore-deleted.png?fit=max&auto=format&n=ISC7y4WirTQDUcmj&q=85&s=06f16e06617c13b5f54dc03ed066505b" alt="Pinned note on a contact record" width="1598" height="580" data-path="images/contacts-restore-deleted.png" />
</Frame>

Pin important notes so they always appear at the top of the list, regardless of sort order.

<Steps>
  <Step title="Locate the note to pin">
    Find the note in the Notes tab.
  </Step>

  <Step title="Pin the note">
    Click the **pin icon** on the note card. Pinned notes move to the top of the list and display a filled pin icon.
  </Step>

  <Step title="Unpin the note">
    Click the pin icon again to unpin the note and return it to its natural position in the list.
  </Step>
</Steps>

<Tip>
  Pin your most important context notes — such as a client's preferred communication method or an agreed-upon discount — so they are immediately visible to any team member who opens the record.
</Tip>

***

## Notes in automation

<Frame caption="Workflow action to automatically create a note on a contact record">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/5j372da1_YvJVoEe/images/contacts-customize-save.png?fit=max&auto=format&n=5j372da1_YvJVoEe&q=85&s=6bcd70bd5a7b82595024409659fa1dcf" alt="Workflow Create Note action" width="287" height="302" data-path="images/contacts-customize-save.png" />
</Frame>

Workflows can create notes on contact records automatically using the **Create Note** action. This is useful for logging events such as:

* When a contact submits a form
* When a payment is received
* When a workflow stage changes

Automated notes are indistinguishable from manual notes in the Notes tab and include a timestamp reflecting when the workflow ran.

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Are notes visible to all team members?">
    Yes. Notes are visible to any team member who has access to the contact record. There is no concept of private notes — use internal comments in the Conversations tab if you need to leave messages only for specific team members.
  </Accordion>

  <Accordion title="Can I add attachments to a note?">
    Notes are text-only. To attach files to a contact record, use the **Documents** tab where you can upload PDFs, images, and other file types.
  </Accordion>

  <Accordion title="Do notes survive a contact merge?">
    Yes. When two contacts are merged, all notes from both records are combined on the master record.
  </Accordion>

  <Accordion title="Can I search across notes for all contacts at once?">
    Not directly from the Notes tab. Use the **Advanced Filters** in Smart Lists and filter by note content to find contacts based on notes across your entire database.
  </Accordion>
</AccordionGroup>
