Skip to content

Commit 8d081e1

Browse files
committed
Prepping 1.23 release notes advance
1 parent 75eaeb8 commit 8d081e1

3 files changed

Lines changed: 148 additions & 0 deletions

File tree

134 KB
Loading
Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
---
2+
title: Grouping support with ListView Command Set extension
3+
description: Using grouping with ListView Command Set extensions.
4+
ms.date: 03/19/2026
5+
ms.localizationpriority: medium
6+
---
7+
# Build your first ListView Command Set extension
8+
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.
10+
11+
![Card personalization visible in the dashboard UI](../../../images/123-release/list-view-cmdset-grouping.png)
12+
13+
Notice that yo can only have two level of grouping as shown in the picture and in the below sample.
14+
15+
Here's an example extension manifest which uses `group` element and type to define the associations and grouping between the commands.
16+
17+
``` json
18+
{
19+
"$schema": "https://developer.microsoft.com/json-schemas/spfx/command-set-extension-manifest.schema.json",
20+
21+
"id": "5be38d1c-597f-436e-9d1b-c019b3a1a9ed",
22+
"alias": "GroupingCommandSet",
23+
"componentType": "Extension",
24+
"extensionType": "ListViewCommandSet",
25+
26+
// The "*" signifies that the version should be taken from the package.json
27+
"version": "*",
28+
"manifestVersion": 2,
29+
30+
// If true, the component can only be installed on sites where Custom Script is allowed.
31+
// Components that allow authors to embed arbitrary script code should set this to true.
32+
// https://support.office.com/en-us/article/Turn-scripting-capabilities-on-or-off-1f2c515f-5d7e-448a-9fd7-835da935584f
33+
"requiresCustomScript": false,
34+
35+
"items": {
36+
"GROUP_1": {
37+
"title": { "default": "Group One" },
38+
"iconImageUrl": "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 2048 2048'%3E%3Cpath d='M1920 640q27 0 45 19t19 45v1152q0 26-19 45t-45 19H128q-26 0-45-19t-19-45V384q0-26 19-45t45-19h768l256 320h768z' fill='%23333333'%3E%3C/path%3E%3C/svg%3E",
39+
"type": "group"
40+
},
41+
"GROUP_2": {
42+
"title": { "default": "Group Two" },
43+
"iconImageUrl": "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 2048 2048'%3E%3Cpath d='M1152 0l896 896-896 1152L0 896 896 0h256zm0 128H960L128 896l1024 1024 832-1024L1152 128zm-128 640q0 53-37 90t-91 38-90-38-38-90 38-91 90-37 91 37 37 91z' fill='%23333333'%3E%3C/path%3E%3C/svg%3E",
44+
"type": "group"
45+
},
46+
"GROUP_2_1": {
47+
"title": { "default": "Sub group in Group Two" },
48+
"iconImageUrl": "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 2048 2048'%3E%3Cpath d='M128 384h768l256 256h640l-256-256H896L640 128H128Q75 128 37 165T0 256v1408q0 53 37 91t91 38h1664q53 0 91-38t37-91V640H832L576 384H128zm1664 384v896H256l256-896h1280z' fill='%23333333'%3E%3C/path%3E%3C/svg%3E",
49+
"type": "group",
50+
"group": "GROUP_2"
51+
},
52+
"COMMAND_1": {
53+
"title": { "default": "Command One" },
54+
"iconImageUrl": "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 2048 2048'%3E%3Cpath d='M1024 0q141 0 272 37t240 104 207 160 160 208 103 239 38 272q0 141-37 272t-104 240-160 207-208 160-239 103-272 38q-141 0-272-37t-240-104-207-160-160-208-103-239-38-272q0-141 37-272t104-240 160-207 208-160T752 37t272-37zm128 576H896v384H512v256h384v384h256v-384h384V960h-384V576z' fill='%23333333'%3E%3C/path%3E%3C/svg%3E",
55+
"type": "command",
56+
"group": "GROUP_1"
57+
},
58+
"COMMAND_2": {
59+
"title": { "default": "Command Two" },
60+
"iconImageUrl": "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 2048 2048'%3E%3Cpath d='M1664 192l192 192-192 192-192-192 192-192zm-128 320l192 192-960 960H576v-192l960-960zm-960 1088v128H128V128h768v128H256v1344h320z' fill='%23333333'%3E%3C/path%3E%3C/svg%3E",
61+
"type": "command",
62+
"group": "GROUP_2"
63+
},
64+
"COMMAND_3": {
65+
"title": { "default": "Command Three" },
66+
"iconImageUrl": "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 2048 2048'%3E%3Cpath d='M768 256h512v-128H768v128zm-256 0V64q0-27 19-45t45-19h768q27 0 45 19t19 45v192h384v128H128V256h384zM256 512h1536v1408q0 53-37 91t-91 37H384q-53 0-91-37t-37-91V512zm128 128v1280q0 27 19 45t45 19h1152q27 0 45-19t19-45V640H384zm256 256h128v896H640V896zm384 0h128v896h-128V896zm384 0h128v896h-128V896z' fill='%23333333'%3E%3C/path%3E%3C/svg%3E",
67+
"type": "command",
68+
"group": "GROUP_2_1"
69+
},
70+
"COMMAND_4": {
71+
"title": { "default": "Command Four" },
72+
"iconImageUrl": "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 2048 2048'%3E%3Cpath d='M1408 0l640 640-640 640V896q-159 13-289 78t-230 166-168 228-104 275q-4 20-8 40t-7 40q-59-167-88-345t-12-357q22-239 127-447t279-362T1408 128V0z' fill='%23333333'%3E%3C/path%3E%3C/svg%3E",
73+
"type": "command",
74+
"group": "GROUP_2_1"
75+
}
76+
}
77+
}
78+
79+
```

docs/spfx/release-1.23.md

Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
---
2+
title: SharePoint Framework v1.23 preview notes
3+
description: Release notes for the SharePoint Framework v1.23 preview release.
4+
ms.date: 03/25/2026
5+
ms.localizationpriority: high
6+
---
7+
# SharePoint Framework v1.23 release notes
8+
9+
This is an early baseline version for the upcoming SharePoint 1.23 version with initial updates. We are introducing new capabilities as part of the following updates before the general availability of 1.23 version.
10+
11+
[!INCLUDE spfx-release-beta]
12+
13+
beta.0 Released: March 25, 2025
14+
15+
[!INCLUDE spfx-release-notes-common]
16+
17+
## Install the latest version
18+
19+
Install the latest preview release of the SharePoint Framework (SPFx) by using the **@next** tag
20+
21+
```console
22+
npm install @microsoft/generator-sharepoint@next --global
23+
```
24+
25+
## Upgrading projects to v1.23 preview version
26+
27+
The upgrade steps required to convert a [gulp-based toolchain](toolchain/sharepoint-framework-toolchain.md) SPFx project to the [Heft-based toolchain](toolchain/sharepoint-framework-toolchain-rushstack-heft.md) are detailed in the following article: [Migrate from the Gulp Toolchain to Heft Toolchain](toolchain/migrate-gulptoolchain-hefttoolchain.md).
28+
29+
## New features and capabilities
30+
31+
### Grouping support for list view command sets
32+
33+
Starting with the SPFx 1.23, we will be also supporting grouping of list view command sets in the toolbar and in the context menu. This provides more control on how the list view commands are rendered in lists and libraries.
34+
35+
![Card personalization visible in the dashboard UI](../images/123-release/list-view-cmdset-grouping.png)
36+
37+
> This feature is currently in progress to rollout in production and will be enable in all tenants by early April.
38+
39+
See more details on this upcoming change from the following documentation:
40+
41+
- [Grouping in ListView Command Set extensions](./extensions/guidance/list-view-command-set-grouping.md)
42+
43+
### Preview of new SPFx CLI and open-sourced templates
44+
45+
We're excited to provide a first preview version of upcoming SPFx CLI (Command Line Interface) which will eventually replace the current usage of Yeoman generator. We're also open-sourcing the used solution templates that the SPFx CLI tool is using for the solution creation.
46+
47+
SPFx CLI can be used to scaffold SPFx solutions in the same way as SPFx Yeoman generator previously. Used templates are open-source and you can also configure the CLI to use alternative templates that you're storing in another location. This enables ecosystem to build replacement templates or project specific templates, optimized for the use case.
48+
49+
SPFx CLI and templates are available in [GitHub](https://github.com/SharePoint/spfx) as open-source solution and we welcome Pull Requests and suggestions on the needed changes.
50+
51+
We are in progress of publishing first version of the CLI to NPMjs in upcoming days and we will share more documentation on the usage at this time. Current schedule for General Availability of SPFx CLI is June 2026.
52+
53+
Your feedback is welcome. Let us know your first impressions and provide suggestions.
54+
55+
### Addressing npm audit issues
56+
57+
When installing the SharePoint Framework Yeoman generator, we have worked on the reported `npm audit` issues. Addressing vulnerabilities is a moving target, which we keep on addressing with all releases.
58+
59+
We're also looking into addressing deprecated packages in the following releases of SharePoint Framework.
60+
61+
## Deprecations
62+
63+
No new updates.
64+
65+
## Feedback and issues
66+
67+
We're interested in your feedback about the release and if you find any issues, share them using the [sp-dev-docs repository issue list](https://aka.ms/spfx/issues). We're also tracking any other [discussions](https://github.com/SharePoint/sp-dev-docs/discussions) if you simply want to have a discussion with the engineering team on this release. Thank you for your input advance.
68+
69+
Happy coding! Sharing is caring! 🧡

0 commit comments

Comments
 (0)