Skip to content

Commit d59d431

Browse files
docs: improve ListView Command Set grouping article (#10761)
- fix H1, frontmatter metadata, and description - link ListView Command Sets to the getting-started tutorial - add developer preview notice include - fix image alt text and typos - add See also section with related links - move TOC entry next to the ListView Command Set extension entry - swap developer-preview-notice for spfx-prerelease-related include on the ListView Command Set grouping page
1 parent 90ff7ed commit d59d431

2 files changed

Lines changed: 22 additions & 10 deletions

File tree

docs/spfx/extensions/guidance/list-view-command-set-grouping.md

Lines changed: 20 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,27 @@
11
---
22
title: Grouping support with ListView Command Set extension
3-
description: Using grouping with ListView Command Set extensions.
3+
description: Use the group element in a ListView Command Set manifest to build a two-level hierarchy of commands in the SPFx list and library toolbar.
44
ms.date: 03/19/2026
5+
author: VesaJuvonen
6+
ms.author: vesaj
7+
ms.topic: concept-article
8+
ms.service: sharepoint
59
ms.localizationpriority: medium
610
---
7-
# Build your first ListView Command Set extension
811

9-
Starting from the [SharePoint Framework v1.23](../../release-1.23.md), ListView Command Sets also support grouping. You can use `group` element and cross item associations in the ListView Command Set manifest to build a hierarchy of commands which are then grouped in the list and library toolbar and context menu.
12+
# Grouping support with ListView Command Set extension
1013

11-
![Card personalization visible in the dashboard UI](../../../images/123-release/list-view-cmdset-grouping.png)
14+
Starting from the [SharePoint Framework v1.23](../../release-1.23.md), [ListView Command Sets](../get-started/building-simple-cmdset-with-dialog-api.md) also support grouping. You can use `group` element and cross item associations in the ListView Command Set manifest to build a hierarchy of commands that are then grouped in the list and library toolbar and context menu.
1215

13-
Notice that yo can only have two level of grouping as shown in the picture and in the below sample.
16+
[!INCLUDE [spfx-prerelease-related](../../../../includes/snippets/spfx-prerelease-related.md)]
1417

15-
Here's an example extension manifest which uses `group` element and type to define the associations and grouping between the commands.
18+
![ListView Command Set showing two-level grouping in the list toolbar](../../../images/123-release/list-view-cmdset-grouping.png)
1619

17-
``` json
20+
Notice that you can only have two levels of grouping as shown in the picture and in the following sample.
21+
22+
Here's an example extension manifest that uses `group` element and type to define the associations and grouping between the commands.
23+
24+
```json
1825
{
1926
"$schema": "https://developer.microsoft.com/json-schemas/spfx/command-set-extension-manifest.schema.json",
2027

@@ -75,5 +82,10 @@ Here's an example extension manifest which uses `group` element and type to defi
7582
}
7683
}
7784
}
85+
```
86+
87+
## See also
7888

79-
```
89+
- [Build your first ListView Command Set extension](../get-started/building-simple-cmdset-with-dialog-api.md)
90+
- [Migrate from UI extensions to ListView Command Sets](../../../sp-add-ins-modernize/from-ui-extensions-to-listview-command-sets.md)
91+
- [Overview of SharePoint Framework Extensions](../overview-extensions.md)

docs/toc.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -245,6 +245,8 @@
245245
href: spfx/extensions/get-started/building-simple-field-customizer.md
246246
- name: ListView Command Set extension
247247
href: spfx/extensions/get-started/building-simple-cmdset-with-dialog-api.md
248+
- name: Grouping of ListView Command Set extensions
249+
href: spfx/extensions/guidance/list-view-command-set-grouping.md
248250
- name: Search Query extension
249251
href: spfx/building-search-extensions.md
250252
- name: Form customizer
@@ -255,8 +257,6 @@
255257
href: spfx/extensions/basics/tenant-wide-deployment-extensions.md
256258
- name: Pre-allocated placeholders
257259
href: spfx/extensions/basics/preallocated-space-placeholders.md
258-
- name: Grouping of ListView Command Set extensions
259-
href: spfx/extensions/guidance/list-view-command-set-grouping.md
260260
- name: Library components
261261
items:
262262
- name: Overview

0 commit comments

Comments
 (0)