Skip to content

spo list view add

Adds a new view to a SharePoint list

Usage

m365 spo list view add [options]

Options

-u, --webUrl <webUrl>
URL of the site where the list is located.
--listId [listId]
ID of the list to which the view should be added. Specify either listId, listTitle or listUrl but not multiple.
--listTitle [listTitle]
Title of the list to which the view should be added. Specify either listId, listTitle or listUrl but not multiple.
--listUrl [listUrl]
Relative URL of the list to which the view should be added. Specify either listId, listTitle or listUrl but not multiple.
--title <title>
Title of the view to be created for the list.
--fields <fields>
Comma-separated list of case-sensitive internal names of the fields to add to the view.
--viewQuery [viewQuery]
XML representation of the list query for the underlying view.
--personal
View will be created as personal view, if specified.
--default
View will be set as default view, if specified.
--paged
View supports paging, if specified (recommended to use this).
--rowLimit [rowLimit]
Sets the number of items to display for the view. Default value is 30.
-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

We recommend using the paged option. When specified, the view supports displaying more items page by page (default behavior). When not specified, the rowLimit is absolute, and there is no link to see more items.

Examples

Add a view called All events to a list with specific title.

m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "My List" --title "All events" --fields "FieldName1,FieldName2,Created,Author,Modified,Editor" --paged

Add a view as default view with title All events to a list with a specific URL.

m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl "/Lists/MyList" --title "All events" --fields "FieldName1,Created" --paged --default

Add a personal view called All events to a list with a specific ID.

m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/project-x --listId 00000000-0000-0000-0000-000000000000 --title "All events" --fields "FieldName1,Created" --paged --personal

Add a view called All events with defined filter and sorting.

m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "My List" --title "All events" --fields "FieldName1" --viewQuery "<OrderBy><FieldRef Name='Created' Ascending='FALSE' /></OrderBy><Where><Eq><FieldRef Name='TextFieldName' /><Value Type='Text'>Field value</Value></Eq></Where>" --paged