Report Designer: Working with variables

Alerts and notices
Leave feedback

Contact information (optional):

Leave this blank:

Please tell us how we can make this information more helpful.

Characters left:

You can use variables to customize your reports in the Report Designer and create a "global" definition that can be used in multiple reports and for multiple clients. For example, you can insert a text variable such as [Client.Name] and/or [Firm.Name] in a report, financial statement, or letter for your clients, without the need to manually enter that information in each document. The data for the selected variable is pulled into the report or on-screen preview from other areas of the program.

You can insert variables that pertain to the client's general information, Chart of Accounts data, firm information, and much more. The easy-to-use Variables tree view provides a comprehensive list of categories and variables that can be easily inserted into the selected report.

Note: Predefined (standard) reports that are available in the Report Designer contain report-specific variables that are best suited for the report's purpose. You may not need to add any new variables, but only to modify the ones that already exist. Using the Design Tools frame, you can modify such items as, period, amount type, and generally how the variable is presented in the report.

See also: Report Designer overview, Working with formulas

Inserting a variable

Follow these steps to insert a variable into a report that is open in the Report Designer.

  1. Within the design grid, select a cell, row, or column in one of the regions in which to insert a variable. Choose Insert > Variable to open the Variable tree view in the Design Tools frame.
  2. Expand the tree view categories and double-click or drag and drop a variable to insert it into the selected cell(s) of the report.


  • To insert variables into a letter, drag it from the Design Tools frame into the desired region of the letter. Double clicking a selected variable works for regular reports only.
  • Once you have inserted the variable, you can right-click in the cell and choose Format Cells from the context menu to modify the contents or the appearance of the cell as needed.
  • You can access the variable tree view from the Variables section of the Design Tools frame, when you click the Formula Insert Formula button button next to the Contents field in the, Cell, Row, or Column sections, or next to the Formula field at the top of the design grid. The variable tree can also be accessed from the Insert > Formula dialog.
  • We recommend as a best practice to make sure that variables on the same row of the report come from the same section of the variables tree.

Variable view

Print distinct values

For variables to repeat for each unique instance of the variable data, mark the Print distinct values checkbox in either the Row or Cell Properties sections of the Design Tools frame.

Print distinct values checkbox

Column A in the following comparison chart that displays a page in the Account Groupings report depicts the report with the Print distinct values checkbox marked so that each account grouping description variable prints in a single instance for all accounts before moving to the next account grouping description. Alternatively, when the Print distinct values checkbox is cleared as in Column B, all instances of a single account grouping description variable is printed for each account until there are no more to print.

Print distinct values comparison

Related topic: Reporting and Report Designer: Procedures

Top of page

Share This