--- title: "Configuring LUSID to enable settlement strategies" slug: "configuring-lusid-to-enable-settlement-strategies" updated: 2026-06-09T07:31:55Z published: 2026-06-09T07:31:55Z canonical: "support.lusid.com/configuring-lusid-to-enable-settlement-strategies" 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. # Configuring LUSID to enable settlement strategies To override the contractual settlement date for a transaction and settle some or all of its units explicitly, you must pre-configure both: 1. The transaction type to which the transaction belongs, for example `Buy`, and 2. The parent portfolio in which it resides, for example one with a scope of `Equities` and code of `UK-Growth`. [More information](/v1/docs/configuring-lusid-to-enable-settlement-strategies#configuring-portfolios). Note that such a change impacts *all* transactions belonging to the nominated transaction type in the parent portfolio. ## Configuring transaction types By default, the settlement mode is `Internal`, to obey the contractual settlement date. You can set the settlement mode to `External` for the following [movement types](/v1/docs/what-movement-types-are-available) to override the contractual settlement date for stock holdings, cash holdings, and/or deferred cash holdings (reclaimed tax): | Holding category | Movement types | | --- | --- | | Stock | `StockMovement` | | Cash | `CashAccrual` `CashCommitment` `CashReceivable` | | Deferred cash/reclaimed tax | `CashDeferred` | LUSID web appLUSID API Call the [SetTransactionType](https://www.lusid.com/docs/api/lusid/endpoints/transaction-configuration/SetTransactionType/) API to set the `settlementMode` fields of applicable movement types to `External`: ```json curl -X PUT 'https://.lusid.com/api/api/transactionconfiguration/types/default/Buy?scope=default'  -H 'Content-Type: application/json-patch+json'  -H 'Authorization: Bearer '  -d '{  "aliases": [    {      "type": "Buy",      "description": "Purchase",      "transactionClass": "Basic",      "transactionRoles": "LongLonger",      "isDefault": false    }  ],  "movements": [    {      "movementTypes": "StockMovement",      "side": "Side1",      "direction": 1,      "settlementMode": "External"    },    {      "movementTypes": "CashCommitment",      "side": "Side2",      "direction": -1,      "settlementMode": "External"    }  ] }' ``` Navigate to the **System Settings > Transaction Types** dashboard, locate the transaction type to configure, and change the **Settlement Mode** of applicable movement types to **External**, for example: ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-ZA577LG5.png?sv=2026-02-06&spr=https&st=2026-11-09T07%3A16%3A14Z&se=2026-11-09T08%3A16%3A14Z&sr=c&sp=r&sig=VJYPW7tt2zLdyrgC4dXEwtPqWjrIDFt4lToJBcUuLMI%3D) ## Configuring portfolios You can enable different settlement methods for stock holdings, cash holdings, and/or deferred cash holdings: - Choose `Automatic` to settle units on the contractual settlement date, as per the default LUSID behaviour, but enable the option to cancel settlement or settle by instruction on an ad-hoc basis. - Choose `Instructed` to negate the contractual settlement date. You must explicitly load one or more settlement instructions. LUSID web appLUSID API To configure an existing portfolio, call the [PatchPortfolioDetails](https://www.lusid.com/docs/api/lusid/endpoints/transaction-portfolios/PatchPortfolioDetails/) API and specify the `settlementConfiguration` object, for example: ```json curl -X POST "https://.lusid.com/api/api/transactionportfolios/Equities/UK-Growth/details"  -H "Authorization: Bearer "  -H "Content-Type: application/json-patch+json"  -d '[  {    "path": "/settlementConfiguration",    "op": "add",    "value": {      "stockSettlement": {"method": "Automatic"},      "cashSettlement": {"method": "Instructed"},      "deferredCashReceipt": {"method": "Instructed"}    },  } ]' ``` Navigate to the **Data Management > Portfolios** dashboard, locate the portfolio to edit and, on the **Details** tab, choose an appropriate **Stock settlement method**, **Cash settlement method** and/or **Deferred cash receipt method**, for example: ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-WMZT03KQ.png?sv=2026-02-06&spr=https&st=2026-11-09T07%3A16%3A14Z&se=2026-11-09T08%3A16%3A14Z&sr=c&sp=r&sig=VJYPW7tt2zLdyrgC4dXEwtPqWjrIDFt4lToJBcUuLMI%3D) ### Overriding the chosen settlement method on an ad-hoc basis You can nominate a property type with a special data type as an override key for a particular settlement method. Consider the example where **Cash settlement method** is set to `Automatic` in a portfolio. You can specify an override key and then, for a particular transaction such as a dividend, add a property of that type with a value of `Instructed` to cancel automatic settlement and require an explicit instruction for just that transaction. To do this: 1. [Create a property type](/v1/docs/how-do-i-create-a-property-type) in the `Transaction` domain with the built-in data type `system/settlementMethod` permitting only the values `Automatic` and `Instructed`, for example: ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-I670DHNU.png?sv=2026-02-06&spr=https&st=2026-11-09T07%3A16%3A14Z&se=2026-11-09T08%3A16%3A14Z&sr=c&sp=r&sig=VJYPW7tt2zLdyrgC4dXEwtPqWjrIDFt4lToJBcUuLMI%3D) 2. Specify the property type as an override key for a particular settlement method in the portfolio, for example: ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-FAGBB5RP.png?sv=2026-02-06&spr=https&st=2026-11-09T07%3A16%3A14Z&se=2026-11-09T08%3A16%3A14Z&sr=c&sp=r&sig=VJYPW7tt2zLdyrgC4dXEwtPqWjrIDFt4lToJBcUuLMI%3D) 3. [Add a property of the type](/v1/docs/how-do-i-add-a-property-to-an-entity) to a particular transaction with the opposite value to the settlement method, either explicitly or via a transaction type or a transaction template, for example: ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-YZ1FBN45.png?sv=2026-02-06&spr=https&st=2026-11-09T07%3A16%3A14Z&se=2026-11-09T08%3A16%3A14Z&sr=c&sp=r&sig=VJYPW7tt2zLdyrgC4dXEwtPqWjrIDFt4lToJBcUuLMI%3D)