Updates default value of 'paged' option of command 'spo list view add'. Closes #6741

Author: Jwaegebaert

docs/docs/cmd/spo/list/list-view-add.mdx

@@ -63,8 +63,8 @@ m365 spo list view add [options]
 `--default`
 : View will be set as default view, if specified.
 
-`--paged`
-: View supports paging, if specified (recommended to use this).
+`--paged [paged]`
+: View supports paging. Valid values are `true`, `false`. Defaults to `true`.  
 
 `--rowLimit [rowLimit]`
 : Sets the number of items to display for the view. Default value is 30.
@@ -76,7 +76,7 @@ m365 spo list view add [options]
 
 :::tip
 
-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.
+We recommend using the `paged` option. Paging is enabled by default: the view shows items page by page, up to the specified `rowLimit` per page. To disable paging, set `paged` to `false`; in a non-paged view, the `rowLimit` is absolute and there is no link to see more items.
 
 :::
 
@@ -85,43 +85,43 @@ We recommend using the `paged` option. When specified, the view supports display
 Add a list view called to a list with specific title.
 
 ```sh
-m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Customers" --title "All customers" --fields "LinkTitle,Country,Sector,Country,Address,Contact" --paged
+m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Customers" --title "All customers" --fields "LinkTitle,Country,Sector,Country,Address,Contact"
 ```
 
 Add a gallery view as default view to a list with a specific URL.
 
 ```sh
-m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listUrl "/Lists/Customers" --title "All customers" --type gallery --fields "LinkTitle,Country,Sector,Country,Address,Contact" --paged --default
+m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listUrl "/Lists/Customers" --title "All customers" --type gallery --fields "LinkTitle,Country,Sector,Country,Address,Contact" --default
 ```
 
 Add a view with defined filter and sorting.
 
 ```sh
-m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Customers" --title "Transport customers" --fields "LinkTitle,Country,Country,Address,Contact" --viewQuery "<OrderBy><FieldRef Name='LinkTitle' Ascending='TRUE' /></OrderBy><Where><Eq><FieldRef Name='Sector' /><Value Type='Text'>Transportation</Value></Eq></Where>" --paged
+m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Customers" --title "Transport customers" --fields "LinkTitle,Country,Country,Address,Contact" --viewQuery "<OrderBy><FieldRef Name='LinkTitle' Ascending='TRUE' /></OrderBy><Where><Eq><FieldRef Name='Sector' /><Value Type='Text'>Transportation</Value></Eq></Where>"
 ```
 
 Add a gallery view as personal view.
 
 ```sh
-m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Customers" --title "All customers" --type gallery --fields "LinkTitle,Country,Sector,Country,Address,Contact" --paged --personal
+m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Customers" --title "All customers" --type gallery --fields "LinkTitle,Country,Sector,Country,Address,Contact" --personal
 ```
 
 Add a calendar view with month layout.
 
 ```sh
-m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Events" --title "All events" --type calendar --fields "EventType,InternalExternal" --calendarStartDateField EventStartDate --calendarEndDateField EventEndDate --calendarTitleField LinkTitle --paged
+m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Events" --title "All events" --type calendar --fields "EventType,InternalExternal" --calendarStartDateField EventStartDate --calendarEndDateField EventEndDate --calendarTitleField LinkTitle
 ```
 
 Add a calendar view with week layout and subtitle.
 
 ```sh
-m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Events" --title "All events" --type calendar --fields "EventType,InternalExternal" --calendarStartDateField EventStartDate --calendarEndDateField EventEndDate --calendarTitleField LinkTitle --calendarSubTitleField Location --calendarDefaultLayout week --paged
+m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Events" --title "All events" --type calendar --fields "EventType,InternalExternal" --calendarStartDateField EventStartDate --calendarEndDateField EventEndDate --calendarTitleField LinkTitle --calendarSubTitleField Location --calendarDefaultLayout week
 ```
 
 Add a Kanban board view.
 
 ```sh
-m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Tasks" --title "All tasks" --type kanban --fields "Title,AssignedTo" --kanbanBucketField Status --paged
+m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Tasks" --title "All tasks" --type kanban --fields "Title,AssignedTo" --kanbanBucketField Status
 ```
 
 ## Response
@@ -252,7 +252,7 @@ m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --lis
   <TabItem value="Markdown">
 
   ```md
-  # spo list view add --webUrl "https://contoso.sharepoint.com" --listTitle "Test" --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 "true"
+  # spo list view add --webUrl "https://contoso.sharepoint.com" --listTitle "Test" --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>"
 
   Date: 2/20/2023
 

docs/docs/sample-scripts/spo/manage-news-page-types/assets/sample.json

@@ -21,7 +21,7 @@
     "metadata": [
       {
         "key": "CLI-FOR-MICROSOFT365",
-        "value": "6.4.0"
+        "value": "11.0.0"
       }
     ],
     "thumbnails": [

docs/docs/sample-scripts/spo/manage-news-page-types/index.mdx

@@ -33,13 +33,13 @@ The following script shows how to create custom views to differentiate News type
     }
 
     Write-Host "Creating view - All News"
-    m365 spo list view add --webUrl $WebUrl --listTitle $ListTitle --title "All News" --fields "Title,Name,Editor,Modified" --viewQuery "<Where><Eq><FieldRef Name='PromotedState'></FieldRef><Value Type='Number'>2</Value></Eq></Where>" --paged | Out-Null
+    m365 spo list view add --webUrl $WebUrl --listTitle $ListTitle --title "All News" --fields "Title,Name,Editor,Modified" --viewQuery "<Where><Eq><FieldRef Name='PromotedState'></FieldRef><Value Type='Number'>2</Value></Eq></Where>" | Out-Null
 
     Write-Host "Creating view - SharePoint News"
-    m365 spo list view add --webUrl $WebUrl --listTitle $ListTitle --title "SharePoint News" --fields "Title,Name,Editor,Modified" --viewQuery "<Where><And><Eq><FieldRef Name='PromotedState' /><Value Type='Number'>2</Value></Eq><Eq><FieldRef Name='PageLayoutType' /><Value Type='Text'>Article</Value></Eq></And></Where>" --paged | Out-Null
+    m365 spo list view add --webUrl $WebUrl --listTitle $ListTitle --title "SharePoint News" --fields "Title,Name,Editor,Modified" --viewQuery "<Where><And><Eq><FieldRef Name='PromotedState' /><Value Type='Number'>2</Value></Eq><Eq><FieldRef Name='PageLayoutType' /><Value Type='Text'>Article</Value></Eq></And></Where>" | Out-Null
 
     Write-Host "Creating view - News Link"
-    m365 spo list view add --webUrl $WebUrl --listTitle $ListTitle --title "News Link" --fields "Title,Name,Editor,Modified" --viewQuery "<Where><And><Eq><FieldRef Name='PromotedState' /><Value Type='Number'>2</Value></Eq><Eq><FieldRef Name='PageLayoutType' /><Value Type='Text'>RepostPage</Value></Eq></And></Where>" --paged | Out-Null
+    m365 spo list view add --webUrl $WebUrl --listTitle $ListTitle --title "News Link" --fields "Title,Name,Editor,Modified" --viewQuery "<Where><And><Eq><FieldRef Name='PromotedState' /><Value Type='Number'>2</Value></Eq><Eq><FieldRef Name='PageLayoutType' /><Value Type='Text'>RepostPage</Value></Eq></And></Where>" | Out-Null
   }
   catch {
     Write-Host -f Red "Error generating test documents: " $_.Exception.Message

docs/docs/v11-upgrade-guidance.mdx

@@ -16,6 +16,15 @@ The [spo homesite set](./cmd/spo/homesite/homesite-set.mdx) command has been upd
 - **For adding new home sites**: Use the new [spo homesite add](./cmd/spo/homesite/homesite-add.mdx) command instead
 - **For updating existing home sites**: Continue using [spo homesite set](./cmd/spo/homesite/homesite-set.mdx) as before with required option `siteUrl`.
 
+### `spo list view add` default paged option changed
+
+The [spo list view add](./cmd/spo/list/list-view-add.mdx) command has been updated to change the default value of the `paged` option from `false` to `true`. This change reflects the common usage pattern where most views allow paging and fetch new items while scrolling down.
+
+#### What action do I need to take?
+
+- **If you want paged views (most common)**: No action required as this is now the default behavior.
+- **If you want static views**: Explicitly specify `--paged false` when creating views that should not fetch new items while scrolling.
+
 ## Teams
 
 ### Ensure list output for `teams report` commands

src/m365/spo/commands/list/list-view-add.spec.ts

@@ -336,6 +336,28 @@ describe(commands.LIST_VIEW_ADD, () => {
     assert.strictEqual(actual.success, true);
   });
 
+  it('correctly sets default paged value when paged option is not specified', async () => {
+    const postStub = sinon.stub(request, 'post').callsFake(async (opts) => {
+      if (opts.url === `${validWebUrl}/_api/web/lists/getByTitle('${formatting.encodeQueryParameter(validListTitle)}')/views/add`) {
+        return viewCreationResponse;
+      }
+
+      throw 'Invalid request';
+    });
+
+    await command.action(logger, {
+      options: {
+        webUrl: validWebUrl,
+        listTitle: validListTitle,
+        title: validTitle,
+        fields: validFieldsInput
+      }
+    });
+
+    // Verify that Paged defaults to true when not specified
+    assert.strictEqual(postStub.lastCall.args[0].data.parameters.Paged, true);
+  });
+
   it('correctly logs an output', async () => {
     sinon.stub(request, 'post').callsFake(async (opts) => {
       if (opts.url === `${validWebUrl}/_api/web/lists/getByTitle('${formatting.encodeQueryParameter(validListTitle)}')/views/add`) {
@@ -383,7 +405,7 @@ describe(commands.LIST_VIEW_ADD, () => {
       Query: undefined,
       PersonalView: false,
       SetAsDefaultView: false,
-      Paged: false,
+      Paged: true,
       RowLimit: 30
     });
   });
@@ -418,7 +440,7 @@ describe(commands.LIST_VIEW_ADD, () => {
       ViewData: '<FieldRef Name="Status" Type="KanbanPivotColumn" />',
       PersonalView: false,
       SetAsDefaultView: false,
-      Paged: false,
+      Paged: true,
       RowLimit: 30,
       ViewType2: 'KANBAN'
     });
@@ -454,7 +476,7 @@ describe(commands.LIST_VIEW_ADD, () => {
       Query: undefined,
       PersonalView: false,
       SetAsDefaultView: false,
-      Paged: false,
+      Paged: true,
       RowLimit: 100,
       ViewType2: 'TILES'
     });
@@ -492,7 +514,7 @@ describe(commands.LIST_VIEW_ADD, () => {
       CustomFormatter: undefined,
       PersonalView: false,
       SetAsDefaultView: false,
-      Paged: false,
+      Paged: true,
       RowLimit: 30,
       ViewType2: 'MODERNCALENDAR'
     });
@@ -534,7 +556,7 @@ describe(commands.LIST_VIEW_ADD, () => {
       CustomFormatter: JSON.stringify({ someProperty: 'someValue' }),
       PersonalView: false,
       SetAsDefaultView: false,
-      Paged: false,
+      Paged: true,
       RowLimit: 30,
       ViewType2: 'MODERNCALENDAR'
     });

src/m365/spo/commands/list/list-view-add.ts

@@ -129,7 +129,7 @@ class SpoListViewAddCommand extends SpoCommand {
             Query: args.options.viewQuery,
             PersonalView: !!args.options.personal,
             SetAsDefaultView: !!args.options.default,
-            Paged: !!args.options.paged,
+            Paged: args.options.paged ?? true,
             RowLimit: args.options.rowLimit ?? 30,
             CustomFormatter: args.options.customFormatter
           }