> ## Documentation Index
> Fetch the complete documentation index at: https://docs.investsync.co.nz/llms.txt
> Use this file to discover all available pages before exploring further.

# Dashboard

> Review portfolio value, allocation, activity, news, goals, and watchlist items from one place

## Overview

The Dashboard is the first place to review an organisation. It brings together headline portfolio values, recent activity, allocation, currency exposure, planning goals, investment updates, and watched securities.

Use it for daily review, month-end checks, and quick preparation before investment meetings.

## Before you start

Make sure the organisation has investments, transactions, and any categories or tags you want to review. If the dashboard looks incomplete, check whether the date range or filters are narrowing the view.

## Basic and advanced use

* **Basic use**: review headline value, top holdings, recent activity, allocation, and currency exposure.
* **Advanced use**: filter by entity, category, subcategory, listed status, or tags, then personalise the dashboard for a meeting or recurring review.
* **Compact use**: choose the Compact view when you want more figures, rows, and summaries on screen at once.

## Choose the review period

Use the date range controls at the top of the Dashboard to set the period you want to review.
When you first open the Dashboard without a saved or shared date range, it starts at **Year to date** so the view covers the current calendar year up to today.

Check the period before relying on:

* Portfolio movement.
* Recent transactions.
* Value comparison charts.
* Allocation and exposure views.
* Report or meeting commentary.

If the start date is later than the end date, InvestSync presents the range in the correct order.

If today's daily value has not finished syncing, the headline portfolio value and value chart carry each holding's latest confirmed value forward to today. This keeps the Dashboard and mobile overview steady while the current day's values are being updated.

On the mobile app, the Dashboard may reopen with recently viewed information while the latest figures refresh. This helps repeat visits load faster, especially when switching back to the app during the same review session.

## Filter the dashboard

Filters help you focus on a specific part of the organisation.

You can filter by:

* Entity.
* Currency.
* Category.
* Subcategory.
* Listed or unlisted investments.
* Tags.

Use filters when you need a view for one trust, one mandate, one investment currency, one asset class, or one reporting treatment.

If an investment is shared between entities using ownership weights, an entity filter shows only that entity's percentage share of value, gains and losses, income, fees, and recent activity. The full organisation view still shows the investment once at its full value.

## Key dashboard areas

<CardGroup cols={2}>
  <Card title="Key metrics" icon="chart-line">
    Review market value, cost, unrealised results, realised gains or losses,
    realised FX, and other headline figures. The first metric compares market
    value with cost basis so you can quickly see value against invested cost.
  </Card>

  <Card title="Period ROI" icon="percent">
    Review return on invested capital at the top of the dashboard for the
    selected period. Loan repayments and capital repayments are shown as capital
    adjustments, not performance losses.
  </Card>

  <Card title="Top holdings" icon="bar-chart">
    See the largest positions and their current contribution to the portfolio.
  </Card>

  <Card title="Recent transactions" icon="receipt">
    Check the latest buys, sells, income, fees, and other activity.
  </Card>

  <Card title="Recent news" icon="newspaper">
    Review new investment updates and items that may need action.
  </Card>

  <Card title="Recent planning threads" icon="message-square">
    See the latest notes, decisions, and follow-ups linked to investments,
    entities, custodians, documents, or wider planning topics.
  </Card>

  <Card title="Category allocation" icon="pie-chart">
    See how market value is split across categories and subcategories. Switch to
    the stacked pie view when you want categories in the centre and
    subcategories around the outside.
  </Card>

  <Card title="Currency exposure" icon="globe">
    Review the original investment currencies behind the portfolio.
  </Card>

  <Card title="Bank balances" icon="wallet">
    If Xero bank accounts are syncing, review current cash balances alongside
    the rest of the dashboard.
  </Card>

  <Card title="Benchmarks" icon="bar-chart-3">
    Compare portfolio value growth with saved targets such as S\&P 500, a listed
    stock, CPI plus a margin, or a fixed annual return.
  </Card>
</CardGroup>

In the mobile app, Top holdings includes a compact trend line beside each
holding so you can quickly compare recent movement without opening the full
holding detail.

## Remove transactions from recent activity

If you have the **Bulk delete transactions** permission, you can tidy up the recent activity list directly from the Bold view.

<Steps>
  <Step title="Start selecting">
    In the Recent transactions area, choose **Select**. A tick box appears
    beside each transaction.
  </Step>

  <Step title="Choose the transactions">
    Tick each transaction you want to remove. The toolbar shows how many you
    have selected.
  </Step>

  <Step title="Delete and confirm">
    Choose **Delete**, then confirm. InvestSync permanently removes the selected
    transactions and refreshes affected daily values. This cannot be undone.
  </Step>
</Steps>

If you do not see the **Select** option, ask an owner or an administrator to grant you the bulk delete permission from your member page in Organisation Settings.

## Personalise your view

Use the view switcher in the Dashboard header to choose the layout that suits the task:

* **Classic** for the standard dashboard experience.
* **Bold** for a larger visual review with customisable modules.
* **Compact** for a denser power-user view with more holdings, transactions, allocation figures, watchlist items, goals, and news visible at once.

Classic, Bold, and Compact views start with the Period ROI snapshot, then show realised P/L and realised FX alongside the open-position metrics, so you can distinguish return, income, repayments, unrealised movements, and gains or losses on closed positions. The snapshot shows current value for context, rather than the return basis used behind the ROI calculation. In the Bold view, Period ROI is also included in the Pulse strip for quick scanning.

In the Bold view, the Pulse strip stays directly below the chart because choosing a Pulse item changes the chart above it. The Period ROI tile includes a small ROI trend for the selected period, with the ending figure matching the Period ROI snapshot. The other Bold modules can still be shown, hidden, moved, or resized below the strip.

Use the information icon beside Period ROI to see the formula and figures used: ROI equals return divided by return basis.

When cash or Xero-linked bank accounts are included, the return basis counts the shared cash balance once. This keeps the dashboard from overstating the capital base when interest and balances are held in separate cash records.

In the Compact view, the headline metrics run across the full page so you can scan the key figures before moving into the detailed panels. The Period ROI module shows return, income, capital adjustments, and the main contributors for the selected range. Use the small chart toggles to switch between value, gain or loss, FX, and cost trends without leaving the dashboard. The Unrealised P/L headline follows the selected review period, so it shows how much the unrealised result changed over that date range. Hover over a chart, or move keyboard focus to it, to see the latest value, starting value, change, and range.

When Xero bank accounts are linked and syncing, the Compact view also shows a bank balances panel with total cash and the latest synced account balances.

In the Compact view, use **Customise dashboard** to choose which modules are shown, drag them into your preferred order, resize them, and adjust each module's settings. For example, you can choose which headline metrics appear, which transaction columns are shown, and how many rows a module displays. As you drag a module, the surrounding modules move aside so you can see where it will land. Your Compact dashboard choices are saved for your user and follow you across devices.

Use **Customise dashboard** to enter edit mode. In edit mode, the Dashboard shows a light grid so you can arrange the page directly.

The first time you customise a dashboard, InvestSync guides you through the main choices:

* Show or hide modules for the review you are preparing.
* Drag modules on the page into the order you prefer.
* Pull the right edge of a module to resize it on the grid.
* Choose whether each module is compact, standard, wide, or full width.

Some detailed modules cannot be made too narrow. This keeps tables, charts, and account lists readable.

Charts resize with their modules, so portfolio value, allocation, exposure, holdings, and watchlist views stay readable while you adjust the dashboard.

Use **Modules** while editing to open the module list. Use **Done** when the view is ready.

Common personal views include:

* A portfolio review view with key metrics, top holdings, allocation, and currency exposure.
* An operations view with recent transactions, recent news, recent planning threads, and planning goals.
* A research view with starred watchlist items and favourite reports.
* A performance review view with benchmarks, value comparison, key metrics, and
  period ROI.

Dashboard preferences are saved for the organisation, so the same view is ready the next time you return.

The Dashboard follows your display preference, including dark mode, and keeps cards on a consistent background so the view is easier to scan.

## Compare with benchmarks

Use the Benchmarks module to compare portfolio value growth with the targets
your organisation has saved. Benchmarks can include market indexes, listed
stocks, CPI plus a margin, or a fixed annual percentage.

Owners and admins manage the saved benchmark list from **Planning > Benchmarks**.
Benchmarks marked for the dashboard appear in the Benchmarks module.

The benchmark comparison starts from the portfolio value at the beginning of the
selected dashboard period. It then shows what that starting value would have
grown to if it followed each benchmark. This keeps the comparison simple and
easy to discuss in review meetings.

If a benchmark cannot be calculated for the selected period, the dashboard keeps
the portfolio information visible and marks that benchmark as unavailable.

## Good practice

<Steps>
  <Step title="Start with the date range">
    Confirm the review period before discussing performance or recent activity.
  </Step>

  <Step title="Use filters for focused reviews">
    Apply entity, category, or tag filters before preparing a view for a
    specific audience.
  </Step>

  <Step title="Check recent news">
    Review high-importance or action-required updates before meetings.
  </Step>

  <Step title="Keep the dashboard tidy">
    Hide sections you do not use regularly so important information is easier to
    scan.
  </Step>
</Steps>
