# Reports

The Reports View is a tabbed display. The Reports tab is always displayed, and lists all available reports, grouped under the headings listed and described below. You can click > to expand or collapse the specific reports under each heading. When you open any report, it is displayed in an additional tab, labelled with the name of that report.

The list of reports is always sorted first by the group name (by number) and then by report name. Clicking the Reports heading will reverse the sort order. You can also click the Comment header to sort by the report comment instead of name. The report's name and comment can be set or edited on the General tab of the Report Configuration dialog.

## Available Reports

reports view reports view

### Income and Expenses

The reports in this section show your income and expenses either for the current month, for each month in the current year, or for each year. Of course, the duration of the overall report and the duration captured by each column can be configured to your liking. Various Graphs and Pie Charts also may be produced.

### Net Worth

Here there are reports that describe your net worth, either at the current moment, every month for the current year, or every year of your history. In addition, there is a 7-day Cash Flow Forecast and a Net Worth Graph. There are also reports to get the balances for all of your accounts at any given point in time.

### Transactions

This section includes reports that list individual transactions. This is the best way to print your account register for a specific period of time. The transactions printed can be grouped together according to your liking by choosing the appropriate report, such as:

- By Account

- By Category

- By Month or Week

- By Payee

- By Reconciliation Status

- By Tag

### Cash Flow

The Cash Flow report is similar to a Transaction report, but it displays all cash-flow related transactions for the specified period, which defaults to the current month.

### Investments

These reports help you keep track of your investments. They only include investment accounts. There are a variety of presentation filters and styles, as shown in this partial list.

- Investment Transactions: Similar to a Transactions report, but it includes share prices and quantities.

- Investment Holdings by Account: Shows the current shares, prices, and values for each account.

- Investment Holdings by Type: Same as the previous report, but organizes the accounts by type (Stock, Mutual Fund, &etc;)

- Investment Performance by Account: Shows the annualized performance over any period of time. This performs a cash flow analysis of all money coming into and going out of the account. As a result, this is a very accurate picture of how well your investments are doing.

- Investment Performance by Type: Same as the previous report, but organizes the accounts by type (Stock, Mutual Fund, &etc;)

There are also graphs for Investment Prices and Investment Worth.

### Taxes

The tax reports are just like the transactions reports, with the addition that only Tax related categories are included. This allows you to flag certain categories as being tax-related, and then get one big report at the end of the year to see the transactions for those categories all in one place. They may be listed either by Category or by Payee, and for the last fiscal year.

### Budgeting

The budgeting reports are similar to net worth reports, but the reports can display the budget for a given year, or even compare it to the actual income and expenses for the same period.

### Forecast

The forecast reports are just like the net worth reports, but they use the information to display forecast information. You can display the information at various levels and for the time frame of your choosing.

### Information

These reports display non-transaction information about accounts, loans, and schedules.

### Charts

If Charts are enabled, this section lists all the reports which are marked to display a graphical chart as the default. They are also listed in one of the other sections, but they are aggregated here for your easy reference.

### Favorite Reports

This section lists all the reports you have marked as a favorite in the report configuration dialog. They are still listed in one of the other sections, but they are aggregated here for your easy reference. Favorite reports can also be included on the Home View for even easier reference.

## Working With Reports

There are a number of actions you can take on each report. You can access some these by right-clicking the report name in the list of reports, which brings up the Report options context menu. Alternately, once you have run a report, there are buttons across the top of the view to invoke each of these:

- Chart: Only present if the report is capable of displaying a chart. Clicking this option toggles between the report and the chart.

- Configure report: Change the properties of this report. You can customize the report to your liking and save it for future use. See the next section for more details

- New report: Create a new, customized report based on the selected report.

- Export report: Reports can be exported, or saved, in &HTML; or CSV format. &HTML; is intended to preserve the displayed formatting of the report. CSV exports the data underlying the report.

- Delete report: Customized reports can be deleted. The default reports that ship with &kmymoney; cannot be deleted.

- The Close report button was removed in 5.2. To close the current report tab, click the small x to the right of the report name on the tab.

## Configuring Reports

### Working with custom reports

You can configure the default reports or create your own from them by selecting New report, and then configuring the new report. When you click Configure report you will be presented with the Report Tab of the Report Configuration dialog. Initially, the new report it is named the same as the old report with (Customized) added to the end. You can change the name to whatever you want. You can even name your custom reports the same as a default report, or the same as another custom report. You can use the Comment field to further distinguish reports.

The Report Configuration dialog has a Report tab and a Filters tab, which each have a number of subtabs. Each subtab displays options for configuring different aspects of the report. Note that specific subtabs and options within them may not appear if they are not relevant to the report being configured.

### Report Tab

This is where you configure general information about the report as well as controlling details about what data is presented and how it is presented.

#### General subtab

report configuration report tab general subtab report configuration report tab general subtab

Here you set the basic properties of the report.

- Report Name: Choose or edit the name for this report.

- Comment: Enter a comment to help you remember the details of this report and identify it if the name is the same as any other report.

- Convert values to base currency: Select this option to convert all values in the report to your base currency. Leave it unchecked if you'd like to see values in their original currency. If currencies are not converted, then subtotals will not be shown.

- Mark as favorite report: Check this to cause this report to show up on the Home View and in the group of Favorite Reports.

- Skip value if price is zero: This option is only used for investments reports which show prices instead of balances as all other reports do. Selecting this option includes prices only if there is an actual price for the date; otherwise 0 will be shown. In a graph, the value will be skipped. If this option is off, the last existing price is shown for a period. If it is on, in a table 0 is shown, and in a chart a linear interpolation for the missing values will be performed.

#### Rows/Columns subtab

This is where you configure how you would like the rows and columns of the report to be selected and organized. This tab presents different configuration options depending on the style of report you are configuring.

report configuration report tab rows/columns subtab report configuration report tab rows/columns subtab

For income/expense and net worth reports:

- Budgets: If you have any budgets defined, you can select one as well as whether differences between budget and actual amounts should be propagated from one time period to the next

- Totals: Choose whether to display a row and/or column for total amounts.

- Rows: Choose whether to base the report on Income and Expense (Categories) or on Asset and Liability accounts.

- Detail: Choose the level of detail required for this report.

  The following levels of detail are available:

  - All: Show every category or account.

  - Top-Level: Show only the highest-level categories or accounts, and roll up the sums of the subordinate categories or accounts into those values.

  - Groups: Show only the totals of the income and expense or asset and liabilities.

  - Totals: Show only the grand totals.

- In addition you can specify whether or not to include scheduled and/or transfer transactions and unused accounts or categories.

For transaction reports:

- Organize by: Choose how to group the transactions in this report.

- Show Columns: Choose which columns should be shown in the report. The date and transaction amount are always shown.

- Include only Tax Categories: Only show categories which have been marked as tax-related.

- Include only Investment Accounts: Only show transactions from investment accounts.

- Include only Loan Accounts: Only show transactions from loan accounts.

- Include transfers: Unless this is checked, transfer transactions are not included in transaction reports

- Hide Split Transaction Details: When this option is available, it lets you specify that only the total amount of a split transaction is to be displayed.

- Hide totals: Selecting this prevents Total lines from being calculated and displayed

### Chart Subtab

This subtab allows you to configure what the report should look like when it is displayed as a chart. See the Graphs & Charts section for more explanation of the charting functions.

report configuration report tab chart subtab report configuration report tab chart subtab

- Chart Type: The visual format of chart desired.

- Show grid lines: Whether to print horizontal and vertical grid lines on the chart.

- Draw values on chart: Whether to print the data values on the chart itself for chosen data points.

- Show chart by default: Whether this report should first be displayed as a chart when it's opened.

- Logarithmic vertical axis: normally the vertical axis is linear.

- Plot expenses downwards: normally both income and expenses are plotted upwards.

- Line width: The width of data lines on the chart, specified in pixels.

### Range Subtab

The Range subtab has two sections, Date range and Data range for controlling the limits and subdivisions of the displayed data. Note that this only controls the display, to control the data used by &kmymoney; to create the report, see the section on the Filters tab.

report configuration report tab range subtab report configuration report tab range subtab

#### Date range

Selecting one of the descriptive values from the Range dropdown automatically sets the values of the From and To date fields. You can override either or both of those dates, in which case the first dropdown will show User defined.

The Ticks dropdown controls the placement of ticks on the date axis of the chart.

#### Data range

This lets you control the limits, ticks, and labels on the vertical data axis. The default value for the Range dropdown is Automatic, lets &kmymoney; choose reasonable values for the other fields. If you select User defined you need to specify all the other fields. From and To set the lower and upper limits of the axis. Major tick length and Minor tick length control the positioning of larger and smaller tick marks along the axis. Labels Precision controls the number of decimal places used in the numbers displayed along the axis.

### Filters tab

The filters tab has several subtabs, which can be used to filter or limit the data &kmymoney; uses to prepare the report. These are the same subtabs used to control searching for transactions. Please refer to the Search Transactions section for details on those tabs.

### Report Plugin Configuration

Behind the scenes, Reports are actually implemented as a plugin in &kmymoney;, and there are some items which can be configured through the Reports View Plugin Configuration dialog.

report plugin configuration report plugin configuration

Maximum number of legend items to display limits the number of items to list in the legend of the graph or chart display of a report. This can be useful if there are enough items that the legend would otherwise overwhelm the main display.

Charts line width is the default width in pixels of any lines in the chart display of a report.

Charts palette gives some choice in the array of colors used in graphs and chart displays of a report.

Since the graph and chart displays of reports are shown using HTML, the Default CSS file lets you provide a css file to customize these displays.

## Graphs & Charts

### Viewing as a Chart

Many reports can be viewed in either textual form or graphical (chart) form. The same report configuration parameters are used in either case. You can easily jump back and forth between the textual and graphical forms by pressing the Chart or Report buttons along the top of the Report View.

Please pay attention to the amount of data you choose to display on a chart. If you are not careful, using the same configuration for both textual and graphical forms means it's possible to configure a chart to be visually cluttered, unappealing, and uninformative. &kmymoney; will not force you to keep your charts readable and useful! Also be aware that some reports will take a long time to calculate and display if too much is included.

### Available Chart Types

#### Line Graph

A line graph is one of the simplest forms of a chart. There is one line for each series. Usually, a series is data from a single account or category over time; see below for more details. The time periods stretch out along the bottom axis, and the currency values are along the left axis.

The detail level for each line is controlled in the Rows/Columns Subtab of chart configuration. If you choose the Top-Level detail level, there will be one line for each of the top-most accounts or categories, which shows the sum total of all underlying accounts or categories. If you choose Groups, it will instead show one line each for Income, Expenses, Assets, or Liabilities, depending on the other settings.

#### Bar Graph

The bar graph works exactly the same as the line graph, except there is one bar for each series in each time slice.

#### Pie Chart

The pie chart is the simplest chart type available. It shows data from only one time slice, as opposed to showing the values across time. This chart shows only the data from the totals column of whatever report is selected. If your report is configured to NOT convert values to the base currency, there will be no totals column, in which case this report is not useful.

#### Ring Chart

The ring chart is very similar to a pie chart, except there is one ring for each time slice in the report.