---
title: "How do I override exposure calculations in the Rebalance dashboard?"
slug: "how-do-i-override-exposure-calculations-in-the-rebalance-dashboard"
updated: 2026-09-03T11:42:39Z
published: 2026-09-03T11:42:39Z
canonical: "support.lusid.com/how-do-i-override-exposure-calculations-in-the-rebalance-dashboard"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.lusid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How do I override exposure calculations in the Rebalance dashboard?

In the Rebalance dashboard, you have the option to configure how LUSID calculates exposure for your instruments.

To do this, you must [set an exposure override](/v1/docs/how-do-i-override-exposure-calculations-in-the-rebalance-dashboard#step-1-create-a-derivedvaluation-property); LUSID then:

- Uses the address key you specify - instead of `Valuation/InstrumentExposureInReportCcy` - to provide a unit exposure value for each instrument.
- Calculates holding exposure using the instrument exposure (including the effect of proposed and open orders); LUSID then uses the holding exposure value to calculate the weights shown in the dashboard. [Read more.](/v1/docs/how-do-i-override-exposure-calculations-in-the-rebalance-dashboard#how-lusid-calculates-holding-exposure)
- Continues to calculate the cash offset for an order using `Valuation/InstrumentPV`. Overriding exposure does not override instrument PV, so cash offsets the Rebalance dashboard generates for exposure-overridden instruments will not necessarily offset the orders exactly.

You can hover over the **Exposure** and **Weight** column names to see how LUSID is currently calculating the value: ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-E42TCT9W.png?sv=2026-02-06&spr=https&st=2026-11-09T06%3A06%3A26Z&se=2026-11-09T07%3A06%3A26Z&sr=c&sp=r&sig=B4aLSjaYA35bxRkL1aJWa90A3xfOkxGz7NVO1LQ1%2FVQ%3D)

> [!WARNING]
> Important
> 
> Overriding exposure using the following steps is a powerful domain-wide configuration. Verify that the change will not unintentionally impact other processes.

## Step 1: Create a DerivedValuation property

[Follow these steps](/v1/docs/how-do-i-create-a-derived-property-type) to create an address key in the `DerivedValuation` scope that defines how LUSID should calculate exposure.

The formula should return the exposure for a unit of the instrument in the instrument’s domestic currency, including:

- Contract size
- Other relevant factors

> [!NOTE]
> Note
> 
> You must specify a formula that works for all instrument types, for example by using an `if` statement to determine the value based on the instrument type.

For example, you could specify the formula `if(AddressKeys[Instrument/InstrumentType] in 'FxForward') then 0 else AddressKeys[Valuation/InstrumentExposure]` to set the value of FX forwards to `0`. ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-V213TBKQ.png?sv=2026-02-06&spr=https&st=2026-11-09T06%3A06%3A26Z&se=2026-11-09T07%3A06%3A26Z&sr=c&sp=r&sig=B4aLSjaYA35bxRkL1aJWa90A3xfOkxGz7NVO1LQ1%2FVQ%3D)

## Step 2: Supply your property in the Configuration Store

1. Navigate to **System Settings > Configuration Store** and select the **Shared Keys** tab.
2. Click **Edit** on the configuration set with scope `system` and code `LUSID-Rebalance`. ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-DSC57V62.png?sv=2026-02-06&spr=https&st=2026-11-09T06%3A06%3A26Z&se=2026-11-09T07%3A06%3A26Z&sr=c&sp=r&sig=B4aLSjaYA35bxRkL1aJWa90A3xfOkxGz7NVO1LQ1%2FVQ%3D)
3. Set the `UnitExposureAddressKeyOverride` value to your derived valuation property and click **Save**. ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-2NNTO37Q.png?sv=2026-02-06&spr=https&st=2026-11-09T06%3A06%3A26Z&se=2026-11-09T07%3A06%3A26Z&sr=c&sp=r&sig=B4aLSjaYA35bxRkL1aJWa90A3xfOkxGz7NVO1LQ1%2FVQ%3D)

> [!NOTE]
> Note
> 
> You can remove the override at any time by setting the `UnitExposureAddressKeyOverride` value to `-`.

## How LUSID calculates holding exposure

Once you configure an override address key, LUSID uses it to calculate a holding’s exposure as follows:

1. Queries your configured address key for the instrument (which should return the unit exposure in the instrument’s domestic currency).
2. Converts the value to report currency by multiplying it by `Quotes/FxRate/DomReport`.
3. Multiplies the result by `Holding/Units` to get the holding’s total exposure in report currency.

> [!NOTE]
> Note
> 
> If your configured address key returns a `null` value for a holding, the Rebalance dashboard reverts to the default behaviour for that particular holding and calculates its exposure using `Valuation/InstrumentExposureInReportCcy`.