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
- Open the statement, for example .
- 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.
- Type your question or explanation in Comment on this number….
- Select Comment, or press ⌘Enter or Ctrl+Enter.
Reply, resolve, or reopen a thread
- Select a cell with a yellow marker, or right-click the cell and choose Comments (n).
- Type in Reply… and select Reply. When the cell has several open threads, select Reply on the thread you mean first.
- Select Resolve when the question is answered or the number is corrected.
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
- Drill down from a financial statement to explain a value before you comment on it.
- Review budget variances with comments through an AI client.
- Explain budget values and attach source files so reviewers can see why the plan has its numbers.