--- title: "What is a portfolio mapping and how do I create one?" slug: "what-are-portfolio-mappings" updated: 2026-07-24T12:26:33Z published: 2026-07-24T12:26:33Z canonical: "support.lusid.com/what-are-portfolio-mappings" stale: true --- > ## 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 a 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 - [Rebalance bands](/v1/docs/defining-rebalance-tolerance-bands) 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 totalling 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 You can set up portfolio mappings using any of the following methods: - Rebalance dashboard in the LUSID web app (recommended) - Property specified on the portfolio or group (for bulk updates or fringe use cases) To set up a portfolio mapping: **Rebalance dashboard** 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?sv=2026-02-06&spr=https&st=2026-11-09T05%3A42%3A08Z&se=2026-11-09T06%3A42%3A08Z&sr=c&sp=r&sig=%2B9efFsmXvo7EZMbUF0XmIo5m9RnjL%2BLLj70GKkWmIh0%3D) 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?sv=2026-02-06&spr=https&st=2026-11-09T05%3A42%3A08Z&se=2026-11-09T06%3A42%3A08Z&sr=c&sp=r&sig=%2B9efFsmXvo7EZMbUF0XmIo5m9RnjL%2BLLj70GKkWmIh0%3D) - 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 tab to specify any of the following: ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-S7ZKMYBJ.png?sv=2026-02-06&spr=https&st=2026-11-09T05%3A42%3A08Z&se=2026-11-09T06%3A42%3A08Z&sr=c&sp=r&sig=%2B9efFsmXvo7EZMbUF0XmIo5m9RnjL%2BLLj70GKkWmIh0%3D) - In the **Model** tab: - 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 - Rebalance bands for acceptable drift zones; [see how to define rebalance bands](/v1/docs/defining-rebalance-tolerance-bands) - In the **Benchmark** tab, one benchmark portfolio - In the **Cash Equitisation** tab, one or more portfolios and targets; [see how to run cash equitisation](/v1/docs/how-do-i-run-cash-equitisation-in-the-rebalance-dashboard) - In the **Currency Exposure** tab, a **Hedging Policy**, **Model**, and **Overlay** 5. Select **Save** to complete your portfolio mapping. **Portfolio property** > [!NOTE] > Note > > Currently, only the following mapping areas can be configured via portfolio property: > > - Recipe ID > - Rebalance configuration ID > - Report currency > - Rebalance band ID 1. Sign in to the [LUSID web app](https://www.lusid.com/app/home) and navigate to **Data Management > Portfolios** or **Portfolio Groups** via the top left menu. Alternatively, you can configure the property [with your preferred method](/v1/docs/how-do-i-add-a-property-to-an-entity). 2. Select **Edit** on the portfolio or group that you want to configure a rebalance mapping for. ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-DV4EYDL5.png?sv=2026-02-06&spr=https&st=2026-11-09T05%3A42%3A08Z&se=2026-11-09T06%3A42%3A08Z&sr=c&sp=r&sig=%2B9efFsmXvo7EZMbUF0XmIo5m9RnjL%2BLLj70GKkWmIh0%3D) 3. Select **Add property** and select the `RebalanceMapping` property **Code** from the `default` **Scope**. ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-7LNWYMVY.png?sv=2026-02-06&spr=https&st=2026-11-09T05%3A42%3A08Z&se=2026-11-09T06%3A42%3A08Z&sr=c&sp=r&sig=%2B9efFsmXvo7EZMbUF0XmIo5m9RnjL%2BLLj70GKkWmIh0%3D) 4. Supply the following **Value** in JSON format: For example: ```json {  "recipeId": {    "scope": "Finbourne-Examples",    "code": "My-Recipe"  },  "rebalanceConfigurationId": {    "scope": "rebalance",    "code": "cashbelow3warning"  },  "reportCurrency": "GBP",  "rebalanceBandSeriesId": {    "scope": "Finbourne-Examples",    "code": "AssetClass"  } } ``` ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-67USF8ET.png?sv=2026-02-06&spr=https&st=2026-11-09T05%3A42%3A08Z&se=2026-11-09T06%3A42%3A08Z&sr=c&sp=r&sig=%2B9efFsmXvo7EZMbUF0XmIo5m9RnjL%2BLLj70GKkWmIh0%3D) - A `recipeId` containing the `scope` and `code` of an existing [recipe](/v1/docs/what-is-a-recipe); this recipe overrides any existing recipe chosen in the Rebalance dashboard - A `rebalanceConfigurationId` containing the `scope` and `code` of an existing [rebalance configuration](/v1/docs/what-are-portfolio-mappings#rebalance-configuration) defining rules for the portfolio or portfolio group; you can retrieve your available configuration IDs by calling the [ListRebalanceConfigurations](https://www.lusid.com/docs/api/web-app/endpoints/rebalance/Rebalance.ListRebalanceConfigurations) API - The default (display) `reportCurrency` for the portfolio or portfolio group; note the report currency can differ from the portfolio currency - A `rebalanceBandSeriesId` containing the scope and code of an existing [rebalance band set](/v1/docs/defining-rebalance-tolerance-bands) 5. Click **Save**. Note that when you select a portfolio with a property-defined rebalance mapping in the Rebalance dashboard, the mapping in the property overrides any existing mapping in the dashboard. 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?sv=2026-02-06&spr=https&st=2026-11-09T05%3A42%3A08Z&se=2026-11-09T06%3A42%3A08Z&sr=c&sp=r&sig=%2B9efFsmXvo7EZMbUF0XmIo5m9RnjL%2BLLj70GKkWmIh0%3D) ### Rebalance configuration The rebalance configuration defines a set of parameters and preferences to apply to your Rebalance dashboard and generated orders. You can create a configuration via the following methods: - Using the Rebalance dashboard in the LUSID web app - Calling the [CreateRebalanceConfiguration](https://www.lusid.com/docs/api/web-app/endpoints/rebalance/Rebalance.CreateRebalanceConfiguration) API #### 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?sv=2026-02-06&spr=https&st=2026-11-09T05%3A42%3A08Z&se=2026-11-09T06%3A42%3A08Z&sr=c&sp=r&sig=%2B9efFsmXvo7EZMbUF0XmIo5m9RnjL%2BLLj70GKkWmIh0%3D) > [!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?sv=2026-02-06&spr=https&st=2026-11-09T05%3A42%3A08Z&se=2026-11-09T06%3A42%3A08Z&sr=c&sp=r&sig=%2B9efFsmXvo7EZMbUF0XmIo5m9RnjL%2BLLj70GKkWmIh0%3D) [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.