---
schema_version: "1"
id: 6988da7a700300c6fc2469360a10896e4dbe7efb93b3974f02bce2c0486a7075
title: Related List User Preferences Input
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/uiapi/ui_api_requests_related_list_user_preferences_input.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.uiapi.meta/uiapi/ui_api_requests_related_list_user_preferences_input.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 316b389e40b7977a2ffc167e3ed3335837ffeb1514a91bc22d3541f67dc6870d
description: User preferences to update for a related list.
---
# Related List User Preferences Input

User preferences to update for a related list.

JSON 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
  }\]
}

Properties

| Property Name | Type | Description | Filter Group and Version | Available Version |
| --- | --- | --- | --- | --- |
| columnWidths | Map<String, Integer> | Column width preferences for the related list. \-1 indicates default width. | Small, 55.0 | 55.0 |
| columnWrap | Map<String, Boolean> | Indicates whether the column text wraps. | Small, 55.0 | 55.0 |
| orderedBy | [List Order By Input](https://developer.salesforce.com/docs/atlas.en-us.uiapi.meta/uiapi/ui_api_requests_list_order_by_input.htm "Information describing how to order a related list. This request body supports sorting related lists only by one field. Use this request body to update a related list.")\[\] | Ordering information for the related list. In API version 63.0 and later, you can sort by up to five fields. | Small, 55.0 | 55.0 |

#### See Also

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