---
schema_version: "1"
id: 29d5178fbc1afaad1b7b15d7cb3ca2fc1fa85ce9c3cc510089e478dc1eb77fff
title: Update Related List User Preferences
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/uiapi/ui_api_resources_related_list_preferences_patch.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.uiapi.meta/uiapi/ui_api_resources_related_list_preferences_patch.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 1d808fcf8a955e60fb2793ac80a09b9f7e2f7764a4eea3fe558495a84eb9df97
description: Updates user preferences for a related list.
---
# Update Related List User Preferences

Updates user preferences for a related list.

Resource

/ui-api/related-list-preferences/${preferencesId}

- preferencesId—The ID of user preferences for a related list, for example, Account.RelatedContactList.

Available Version

57.0

HTTP Method

PATCH

Example

To update user preferences for a Contact related list on an Account, use this request with a request body.

PATCH /services/data/v68.0/ui-api/related-list-preferences/Account.RelatedContactList

{ 
  "columnWidths" : {
    "Name" : 200
  },
  "columnWrap" : {
     "Name" : false
  },
  "orderedBy" : \[{ 
    "fieldApiName": "Name",
    "isAscending" : true
  }\]
}

Request Parameters

| Parameter Name | Type | Description | Required or Optional | Available Version |
| --- | --- | --- | --- | --- |
| relatedListUser​PreferencesInput | [Related List User Preferences Input](https://developer.salesforce.com/docs/atlas.en-us.uiapi.meta/uiapi/ui_api_requests_related_list_user_preferences_input.htm "User preferences to update for a related list.") | The related list user preferences to update. | Required | 57.0 |

Response Body

[Related List User Preferences](https://developer.salesforce.com/docs/atlas.en-us.uiapi.meta/uiapi/ui_api_responses_related_list_user_preferences.htm "User preferences for a related list.")