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

# Team notes and mentions

> Leave notes for your crew and the office, tag a teammate so they see it, and know when they have.

Notes are where your team keeps the things that are easy to forget: the gate code, the dog in the back yard, "customer wants a call before you arrive", a photo of the boiler's data plate, a question for the office. Write it once and the right people see it.

> [!NOTE]
>
> Notes are only for your team. Your customer never sees them: not in Client Hub, not on estimates or invoices, and not in any email or text Jomioz sends.

> [!TIP]
>
> Where this page says **phone app**, it means the Jomioz app for iPhone and Android, which is coming soon (expected at the end of November). Until then, open [app.jomioz.com](https://app.jomioz.com) in your phone's browser: notes, tagging, and photos work there just as they do on a computer.

## Add a note

**1. Open the Notes tab**

Every customer, job, visit, estimate, request, recurring plan, and invoice has a **Notes** tab. On an invoice on the web, notes are in the column beside the invoice.

**2. Write it**

Type in **Add a note**. In the phone app, tap **Add note**.

**3. Tag someone if they need to see it**

Type **@** and pick a name. See [Tag a teammate](#tag-a-teammate).

**4. Add photos or files**

Snap a photo, record a short video, or attach a PDF. See [Photos, videos, and files](#photos-videos-and-files).

**5. Save**

Click **Add note**. On a computer, **⌘ + Enter** (Mac) or **Ctrl + Enter** (Windows) saves it too.

Phone numbers, email addresses, and web links in a note can be tapped: tap the customer's number to call them.

> [!TIP]
>
> On an estimate, the **Internal note** and the **Customer-facing estimate text** are part of the estimate itself, so they stay on the **Estimate** tab. The **Notes** tab is for talking to your team.

## Put it on the customer, and every job gets it

Write access details on the **customer**, not on each job. A customer note shows on all of that customer's work, now and later: their requests, estimates, jobs and visits, and invoices.

Whoever is sent to the job sees it there, even if they can't open the customer's record. That's how your tech gets the gate code on the visit without calling the office.

**Only want it on some of their work?** On the customer's **Notes** tab, open the note's **⋯** menu and choose **Show on…**. Check or uncheck **Requests**, **Estimates**, **Jobs and visits**, and **Invoices**, then click **Save**. The note stays on the customer either way, and shows a line such as **Also shows on Requests, Invoices** or **Only on the customer**. Whoever wrote the note, the owner, or office staff can change this.

## Where else a note shows up

You don't need to copy notes around. They show where they are useful:

| You write it on | It also shows on |
| - | - |
| A customer | That customer's requests, estimates, jobs (and their visits), and invoices |
| A visit | The job and the customer |
| A job | The customer |
| A request, estimate, or recurring plan | The customer |
| An invoice | Its job (if there is one) and the customer |

A note from somewhere else has a label saying where it came from, like **Visit 2 · Job #1042** or the customer's name.

When an estimate is turned into a job, its notes come along to the job. If the estimate had an **Internal note**, the job gets it as a note starting with **From proposal:**. **Duplicate job** copies a job's notes to the new one.

Crew members who only see their own work (set in **Settings → Team → Roles**, under **Sees all work**: **Assigned only**) see notes from the jobs they're on, not from every job for that customer.

**On the web**, the **All / Only here** switch above the list lets you hide notes that came from somewhere else, and **Search notes** finds a note by its words. Searching a teammate's name also finds notes that tag them, and **Office** or **Assigned** finds notes tagging those groups.

## Tag a teammate

Type **@** in a note and pick who should see it:

| Type | Who gets it |
| - | - |
| **@** and a name | That person |
| **@Assigned** | Everyone working it. On a visit, that visit's crew. On a job, everyone on any of its visits. On a request or recurring plan, whoever it's assigned to. On an estimate, the person it belongs to. On an invoice, the crew on its job |
| **@Office** | Everyone in a role with **Office-wide alerts** turned on (**Settings → Team → Roles**) |

The list only offers people who can open that job, estimate, or customer, so you tag the right people. If someone can't open it, or has left the team, the note still saves and you're told they weren't notified.

**@Assigned** isn't offered on a customer, or before anyone has been assigned.

If you edit a note and add a name, only the new person gets notified.

### When you're tagged

* You get a notification: **\[Name] mentioned you**, with the job or customer and the start of the note. In the phone app it comes as a push notification.
* Tap it and you land on the **Notes** tab with the note highlighted.
* Until you've seen it, the note shows **Mentions you**.
* All your mentions are together under **Notifications → Mentions**, with a count of the ones you haven't read. On the web, **Unread only** hides the rest, and **Mark as read** clears one without opening it.

The notification is in your own language: English, Spanish, or French.

> [!NOTE]
>
> An owner or admin can switch off these notifications for the whole company in **Settings → Team notifications** (**Notes → Mentioned in a note**). Your **Mentions** list still works when they're off.

## See who has read it

A note that tags people tells you who has seen it:

| It says | Meaning |
| - | - |
| **Not read yet** | Nobody you tagged has seen it |
| **Read by Ana** | Ana has seen it |
| **Read by Ana + 2 others** | Ana and two more have seen it |
| **Read by everyone** | Everyone you tagged has seen it |

Tap that line to see each person and when they read it.

"Read" means they actually looked at it: the note was on their screen for a moment, or they opened the notification. Clearing all their notifications without looking doesn't count.

## Pin the important ones

Open the note's **⋯** menu and choose **Pin to top**. A pinned note stays above the rest on that job, customer, or estimate, so the alarm code is the first thing anyone sees. You can pin up to 10 notes per record.

A pin only applies where you pinned it: pinning on a job doesn't pin it on the customer. A customer's note that shows on a job is pinned from the customer.

## Change or remove a note

* **Edit:** only whoever wrote the note can change it. It then shows **Edited**.
* **Delete:** whoever wrote it, the owner, or office staff can delete it. (On estimates and invoices, also anyone whose role can edit estimates or manage invoices.) Field techs can delete only their own notes. **Delete note** removes it everywhere it shows, with its photos and files. You can't undo this.

Some notes are added by Jomioz and show **Added automatically**. They can't be edited. For example: the reason you gave when you put a job on hold (it starts with **\[On hold]**), an estimate's **Internal note** when it becomes a job, and a note when two customers are merged.

On the web, **Copy link** in the **⋯** menu copies a link straight to the note.

## Photos, videos, and files

Put up to 20 files on a note, each up to 750 MB.

| What | Kinds |
| - | - |
| Photos | From your phone's camera or library, or JPEG, PNG, HEIC, WebP, GIF, AVIF |
| Videos | MP4, MOV, WebM |
| Voice and audio | MP3, M4A, AAC, WAV |
| Documents | PDF, Word, Excel, PowerPoint, CSV, text |

* **In the phone app:** the camera button takes a photo or records a video, the photo button picks from your library, and the file button picks documents and audio.
* **On a computer:** click **Add photos, videos or files**, drag files onto the note, or paste them.

Photos show as small pictures. Videos, audio, and documents show an icon with the file type. Tap one to open it.

## No signal on site

In the phone app, you can still write a note, with photos, in a basement or out in the sticks. It shows **Waiting for signal** and sends itself once your phone is back online and Jomioz is open. You can tap **Add note** even if the notes didn't load.

Some things need signal:

* Tagging someone: the list says **Mentions need a connection.**
* Editing, deleting, pinning, and **Show on…**.

Your team sees the note once it has been sent.

## Prices in notes

Crew who aren't allowed to see prices see amounts in a note replaced with **…**. Whoever wrote the note always sees their own note in full.

## Always up to date

When a teammate adds, changes, deletes, pins, or reads a note, the notes you have open update on their own. No need to refresh.

## On the work order and in AI

* The job's work order PDF includes the latest notes on the job, plus the customer's notes that show on jobs.
* The [Jomioz AI](https://support.jomioz.com/help/ai.md) visit brief reads the visit's and job's notes, and the customer's notes that show on jobs.

## Who can add notes

Anyone who can open a job, customer, or estimate can read its notes. Adding notes depends on what your role lets you do:

| On a | You can add notes if your role can |
| - | - |
| Customer | Edit customers |
| Job, visit, request, or recurring plan | Add or edit jobs |
| Estimate | Add or edit estimates |
| Invoice | Manage invoices |

If you can read but not write, you see **You can read notes here but not add them.** Roles are set in **Settings → Team → Roles**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.