# Commenting on Invoices

Source: https://docs.astalty.com.au/guide/finance/invoicing/invoices/commenting-on-invoices

> Record internal notes on an individual invoice so your team can see why it looks the way it does.

## Overview

An [invoice](https://docs.astalty.com.au/guide/finance/invoicing/invoices) often carries context that isn't visible on the invoice itself - the Plan Manager disputed a travel charge, the original email bounced and you resent it, or you're holding off chasing payment until a Participant's plan is reviewed.

**Comments** let you record that context directly on the invoice, so whoever opens it next can see what has already happened.

Every invoice has a **Comments** section at the bottom of the right-hand panel, below the invoice details, emails, and payments. Unlike [batch comments](https://docs.astalty.com.au/guide/finance/invoicing/invoice-batches/commenting-on-invoice-batches), the section is always there - an invoice nobody has commented on shows **No comments yet.** with an **Add Comment** button beside the heading.

> **Comments are internal to Astalty**
>
> Comments are visible only to your team members who can access Finance. They never appear on the invoice PDF or in any Participant or Plan Manager communication, and adding one does **not** notify anyone. If a colleague needs to know something, contact them directly.
>
> The one exception is Xero: if your provider has **Sync invoice comments to Xero** enabled, invoice comments are copied to Xero as history notes. See [Syncing Invoice Comments to Xero](https://docs.astalty.com.au/guide/integrations/xero-integration/syncing-invoice-comments-to-xero). MYOB has nowhere to keep invoice notes, so with the MYOB integration comments always stay in Astalty.

> **The same comments follow the invoice everywhere**
>
> Comments are attached to the invoice, not to the page you opened it from. You'll see the same Comments section whether you open the invoice from **Finance > Invoices**, from inside an [invoice batch](https://docs.astalty.com.au/guide/finance/invoicing/invoice-batches), from a Participant's invoices, from a payment batch, or from the Aged Receivables report.

## Adding a Comment

1. Open the invoice - for example from **Finance > Invoices**, by clicking the relevant invoice.
2. Scroll down the right-hand panel to the **Comments** section.
3. Click **Add Comment** beside the heading.
4. Type your comment and click **Add Comment**.

![An open invoice with an arrow pointing to the Add Comment button in the Comments section of the right-hand panel, which shows No comments yet.](https://docs.astalty.com.au/assets/invoice-comments-add-comment-guide.png)

The drawer title confirms which invoice you're commenting on - for example, *Add Comment on INV-021-0007*.

You can comment on an invoice at any point, including one that has already been paid or voided.

## Reading Comments

The number beside the heading shows how many comments an invoice has - for example **Comments · 3**.

Each comment shows the author's name, their initials, and how long ago it was posted. Comments older than a week show the date instead. Hover over the timestamp to see the exact date and time.

![An open invoice with a comment highlighted in the Comments section of the right-hand panel, which shows a count of 1 beside the heading. The comment shows the author's initials and name, how long ago it was posted, and its text.](https://docs.astalty.com.au/assets/invoice-comments-comment-displayed.png)

> **Only the three most recent comments are shown**
>
> Comments are listed newest first, and only the **three most recent** are shown. If there are older ones, a link appears at the bottom telling you how many are hidden - for example **Show 2 earlier comments**. Click it to read the full history.

### Formatting a Comment

The comment box is a rich text editor, not a plain text field. You can use **bold**, *italic*, headings, bulleted and numbered lists, and hyperlinks to lay out longer notes - handy when you're recording a sequence of steps you took or linking to a related record.

## Editing and Deleting Comments

You can change or remove a comment you wrote:

1. Find the comment in the **Comments** section.
2. Open the **actions menu** (the three dots) on the comment itself.
3. Select **Edit Comment** to change the wording, then click **Save Comment**. Or select **Delete Comment** and confirm.

> **You can only edit or delete your own comments**
>
> The **Edit Comment** and **Delete Comment** options only appear on comments **you** wrote. There is no override for administrators - nobody can edit or delete a colleague's comment, regardless of their role. If a colleague's comment is wrong, ask them to correct it.
>
> **Deleting a comment is permanent** and there is no undo, so check before you confirm.

> **Editing won't change a comment already sent to Xero**
>
> If the comment has already synced to Xero, a notice appears when you edit it - *This comment was added to your accounting platform. Editing it here won't change the note there.* Deleting shows the equivalent warning. See [Syncing Invoice Comments to Xero](https://docs.astalty.com.au/guide/integrations/xero-integration/syncing-invoice-comments-to-xero).

> **Comment changes aren't shown in the invoice audit trail**
>
> Editing or deleting a comment is not recorded in the invoice's **Audit Trail**, and an edited comment isn't flagged as edited. Treat comments as working notes rather than a permanent record - if something needs to be auditable, record it against the Participant instead.

## Who Can Add and See Comments

Comments have no setting of their own. Anyone who can open the invoice, which needs Finance access, can read its comments and add new ones.

There is nothing to switch on to start using comments - they are available on every account.

## Syncing Comments to Xero

If your provider uses the [Xero integration](https://docs.astalty.com.au/guide/integrations/xero-integration), invoice comments can be copied into Xero. With **Sync invoice comments to Xero** enabled, each comment is added to the matching Xero invoice as a history note.

This changes how you should treat comments on invoices that are heading to Xero:

- The comment becomes visible to anyone with access to your Xero account, not just your Finance team.
- Xero notes **can't be edited or removed** once added, so editing or deleting the comment in Astalty won't change what's in Xero.
- If the invoice isn't in Xero yet, the comment waits and goes across when the batch is synced. If the invoice is **already** in Xero, the comment is sent on its own within moments of you saving it - including comments added long after the batch synced.

A small icon beside each comment tells you where it got to: a **green tick** once it's in Xero, or a **yellow warning triangle** if the attempt failed, with the reason on hover. The drawer also warns you before you save when a comment won't go across at all, and batch comments never sync. For the full detail, see [Syncing Invoice Comments to Xero](https://docs.astalty.com.au/guide/integrations/xero-integration/syncing-invoice-comments-to-xero).

## Invoice Comments and Batch Comments Are Separate

An invoice comment and an [invoice batch](https://docs.astalty.com.au/guide/finance/invoicing/invoice-batches) comment are two different things:

- **Invoice comments** sit on a single invoice and are about that invoice - a disputed charge, a bounced email, a payment arrangement.
- **Batch comments** sit on the whole batch and are about the invoicing run - why finalising was delayed, or who is looking after it. See [Commenting on Invoice Batches](https://docs.astalty.com.au/guide/finance/invoicing/invoice-batches/commenting-on-invoice-batches).

Commenting on a batch does not add a comment to any of its invoices, and vice versa.

## Comments Elsewhere in Astalty

For other kinds of notes, see:

- [Commenting on Invoice Batches](https://docs.astalty.com.au/guide/finance/invoicing/invoice-batches/commenting-on-invoice-batches) - internal notes on an invoicing run.
- [Commenting on Shift Broadcasts](https://docs.astalty.com.au/guide/scheduling/commenting-on-shift-broadcasts) - internal notes when filling a broadcast on the Shift Board.
- [Messaging](https://docs.astalty.com.au/guide/chat/messaging) - direct conversations with your team in Chat.
