---
title: "What is a portfolio mapping and how do I create one?"
slug: "what-are-portfolio-mappings"
updated: 2025-12-08T16:49:38Z
published: 2025-12-08T16:49:38Z
canonical: "support.lusid.com/what-are-portfolio-mappings"
---

> ## 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.

# What is a portfolio mapping and how do I create one?

A portfolio mapping is preselected set of configuration options for a [portfolio](/v1/docs/portfolios) or [portfolio group](/v1/docs/what-is-a-portfolio-group) in the Rebalance dashboard.

You can create a portfolio mapping for a portfolio or portfolio group once and specify:

- A valuation recipe
- A rebalance configuration
- A currency
- One or more models and/or benchmarks

The Rebalance dashboard thereafter populates the mapping values automatically when a user selects that particular portfolio or portfolio group.

> [!NOTE]
> **Note**
> 
> When you add a mapping to a portfolio group, LUSID treats the group as a single portfolio in the Rebalance dashboard:
> 
> - The Rebalance dashboard displays the portfolio group as a single row in the [summary grid](/v1/docs/using-the-rebalance-dashboard#portfolio-summary)
> - Instead of treating each underlying portfolio individually with its own weights totaling 100%, LUSID aggregates the weights of holdings across all portfolios in the group to total 100%,
> - If a portfolio group contains at least one child portfolio group with a portfolio mapping, LUSID treats all direct child portfolio groups as single portfolios, as above

## Setting up a portfolio mapping

To set up a portfolio mapping:

1. Sign in to the [LUSID web app](https://www.lusid.com/app/home) and navigate to **Portfolio Management > Rebalance** via the top left menu.
2. Select **Add mapping**. ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image(758).png)
3. Specify a portfolio mapping **Display Name** and select the following:

![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image(500).png)
  - An existing [**recipe**](/v1/docs/what-is-a-recipe); this recipe overrides any existing recipe chosen in the Rebalance dashboard
  - A **Rebalance Configuration** containing rules for the portfolio or portfolio group; [read more](/v1/docs/what-are-portfolio-mappings#rebalance-configuration)
  - The default (display) **Currency** for the portfolio or portfolio group; note the default currency can differ from the portfolio currency
4. Optionally, select the corresponding headers to specify any of the following:

![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image(504).png)
  - Under **Model**, one or more portfolio models and their weightings; you can select both [reference](/v1/docs/what-is-a-reference-portfolio) and [transaction](/v1/docs/what-is-a-transaction-portfolio) portfolio types
  - Under **Benchmark**, one benchmark portfolio
  - Under **Cash Equitisation**, one or more portfolios and targets; [see how to run cash equitisation](/v1/docs/how-do-i-run-cash-equitisation-in-the-rebalance-dashboard)
  - A currency exposure **Hedging Policy**, **Model**, and **Overlay**
5. Select **Save** to complete your portfolio mapping.

Once saved, your Rebalance dashboard populates the relevant columns according to your selections: ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image(506).png)

### Rebalance configuration

The rebalance configuration defines a set of parameters and preferences to apply to your Rebalance dashboard and generated orders.

#### General

**Equivalent security identifier**: Select a property to use as the lowest-level grouping for tradeable rows in the Rebalance dashboard.

For example, if you set the value to `Instrument/Finbourne-Examples/AssetClass` the Rebalance dashboard groups instruments (decorated with a value for the property) by asset class: ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-4U49TR16.png)

> [!NOTE]
> Note
> 
> If a portfolio group contains one or more portfolios with differing rebalance configuration mappings, the Rebalance dashboard disables the **Equivalent security identifier** grouping.

#### Tolerance rules

Configure absolute and model-relative tolerance values that trigger an auto-rebalance if exceeded. You can configure the rules to apply to:

- All holdings in the dashboard
- Holdings with a particular property

#### Rounding rules

Choose how LUSID should round your instrument lot sizes; [see how to add lot sizes to instruments](/v1/docs/trading-conventions).

#### Absolute rules

For each rule, you can specify:

- An upper or lower limit for the amount in an order (in the portfolio currency)
- Which instruments to apply the order limit to

LUSID prioritises rules in the order you specify, for example rule 1 takes precedence over rule 4.

#### Cash rules

You can configure one or more cash rules to have LUSID warn you when you try to create an order that will bring your cash balance to below a certain amount or percentage.

#### Custom values

**Order presets**: Pre-populate each order in the order generation form with particular properties and values for the **Type** and **Time in force** fields. You can modify these values on-the-fly when necessary.

## Rebalancing to your portfolio mapping models

To rebalance based on your portfolio mapping models, select the desired instruments and use the control panel to generate orders as usual. [See how to use the Rebalance dashboard control panel.](/v1/docs/configuring-rebalancing-use-cases-in-the-rebalance-dashboard)

![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image(505).png)

[See a full tutorial on how to add a portfolio mapping and run a cash equitisation rebalance, from start to finish.](/v1/docs/how-do-i-run-cash-equitisation-in-the-rebalance-dashboard)

A recipe is a hierarchical, modular set of rules that govern numerous LUSID operations. A recipe configures conditional pricing models, aggregation, where to source market data from, fallback rules, and much more.