Skip to main content
Use comments to ask about a reported number and keep the answer next to it. A comment opens a thread on one statement cell, such as an account’s September actual or its variance against the budget. Reviewers reply on the same thread and resolve it when the number is explained, so the discussion stays with the value instead of in email or a spreadsheet.

Where you can comment

Comments work in the Actuals view of the P&L, Functional P&L, Balance Sheet, custom reports, and Cash Flow. On the Cash Flow, use the Monthly, Quarterly, or Half-yearly view; the Summary view has no comments.

Before you begin

  • Open the statement with the period, entities, dimension filters, and transaction categories you want to discuss. These choices are part of what a comment refers to.
  • To comment on a variance, add the comparison with Compare first: a plan, Previous period, or Same period last year.

How a comment attaches to a number

A comment belongs to a number, not to a screen position. Control records the row, the period, the entities, dimension items, counterparty, and transaction categories of the cell, and whether the comment is about the actual or a comparison. The thread appears wherever the same number appears. Period-end balance and Period change show different numbers on the Balance Sheet, so a comment written in one view does not appear in the other.

Add a comment

  1. Open the statement, for example .
  2. Right-click the value cell and choose Comment…. You can also select the cell and press ⌥⌘M on a Mac or Ctrl+Alt+M on Windows.
  3. Type your question or explanation in Comment on this number….
  4. Select Comment, or press ⌘Enter or Ctrl+Enter.
The cell gets a yellow marker in its top-right corner, and the count on the Review button goes up by one. Other people who have the statement open see the new thread without reloading. The popover heading shows the row and the column you commented on. Each thread carries a badge for what it is about: Actual, vs previous period, vs same period last year, or vs followed by the plan’s name.

Reply, resolve, or reopen a thread

  1. Select a cell with a yellow marker, or right-click the cell and choose Comments (n).
  2. Type in Reply… and select Reply. When the cell has several open threads, select Reply on the thread you mean first.
  3. Select Resolve when the question is answered or the number is corrected.
A resolved thread’s marker disappears from the grid, and the thread shows Resolved by and the name of the person who resolved it. Select Reopen to open it again. A reply to a resolved thread, for example from an AI client, reopens it too. To raise a separate question on the same cell, type it and select Start new thread instead of Reply. To change your own comment, hover over it and select the pencil icon; edited comments show (edited). Select the bin icon to delete a comment. Deleting a thread’s only comment deletes the thread.
If the number changed after the thread was opened, the thread shows The value changed since this thread was opened with the old and new values and the currency the comment was written in. Comments are not tied to the display currency, so check that currency before treating the number as changed.

Find comments in the Review panel

Select Review above the statement. The panel lists the threads for the statement’s period range, most recently active first. Turn on Show resolved on the grid to keep grey markers on cells whose threads are resolved. A thread written against a plan that was later deleted shows Plan deleted in the panel. It no longer appears on any grid; read it and resolve or reopen it in the panel.

Comments from an AI client

An AI client connected through Control’s Model Context Protocol (MCP) server can read and write the same threads. Its comments are saved under the name of the person who connected the client and are labelled via MCP. A thread that an AI client opens on a comparison sits on the variance (Δ) cell of that comparison. Writing needs a connection with write access; see Choose AI client access and permissions.

Limits

  • Some cells cannot take comments. The popover says why when you open one: header and total rows, allocation rows, currency translation adjustment (CTA) rows, Unallocated rows, elimination and CTA columns, entity columns while eliminations are split out, plan columns where the plan has no value, and open months that show plan values.
  • Comments are not available with an advanced dimension filter, or when the dimension filter matches items from several dimensions. On the Cash Flow, that means selecting items from more than one dimension.
  • A comment can be up to 4,000 characters. The row and column labels are saved when the thread is opened.
  • Control does not send notifications for comments, and a name typed in a comment does not notify that person. Tell reviewers which statement, period, and comparison to open.
  • Comments are not included in statement exports. An AI client can read them with list_statement_comments.
  • When a period has a very large number of threads, the panel shows only the most recently active ones. Narrow the period to see older threads.

Verify the result

  • The commented cell shows a yellow marker, and the thread appears under In view in the Review panel.
  • After you resolve a thread, the marker disappears, the Review count goes down, and the thread moves to Resolved.

Troubleshooting

Next steps