Skip to content

spo field set

Updates existing list or site column

Usage

m365 spo field set [options]

Options

-u, --webUrl <webUrl>
Absolute URL of the site where the field is located
--listId [listId]
ID of the list where the field is located (if list column). Specify listTitle or listId but not both
--listTitle [listTitle]
Title of the list where the field is located (if list column). Specify listTitle or listId but not both
-i, --id [id]
ID of the field to update. Specify id or title but not both
-t, --title [title]
Title or internal name of the field to update. Specify id or title but not both
-n, --name [name]
(deprecated. Use title instead) Title or internal name of the field to update. Specify id or name but not both
--updateExistingLists
Set, to push the update to existing lists. Otherwise, the changes will apply to new lists only
-h, --help
output usage information
--query [query]
JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
Output type. json,text,csv. Default json
--verbose
Runs command with verbose logging
--debug
Runs command with debug logging

Remarks

Specify properties to update using their names, eg. --Title 'New Title' --JSLink jslink.js.

Examples

Update the title of the site column specified by its internal name and push changes to existing lists

m365 spo field set --webUrl https://contoso.sharepoint.com/sites/project-x --title 'MyColumn' --updateExistingLists --Title 'My column'

Update the title of the list column specified by its ID

m365 spo field set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'My List' --id 330f29c5-5c4c-465f-9f4b-7903020ae1ce --Title 'My column'

Update column formatting of the specified list column

m365 spo field set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'My List' --title 'MyColumn' --CustomFormatter '`{"schema":"https://developer.microsoft.com/json-schemas/sp/column-formatting.schema.json", "elmType": "div", "txtContent": "@currentField"}`'