Installing a package

The same four steps install any tool on the shelf. Only the package name and the permission it asks for change.

1. 01Open the SharePoint admin centre and go to more features, then apps, then app catalogue.
2. 02Drag the .sppkg file into the library. SharePoint reads the manifest and shows a trust dialog.
3. 03Decide whether to make the solution available to all sites. Ticking this deploys it tenant wide, so editors do not have to add the app to each site first.
4. 04Choose deploy.

If the tool reads tenant data, uploading it queues a permission request. Nothing works until that request is approved.

1. 01Open the SharePoint admin centre and go to advanced, then API access.
2. 02Find the pending request naming the package.
3. 03Read the scope it asks for and approve it.

1. 01Edit any modern page.
2. 02Open the toolbox and pick the tool by name.
3. 03Open the property pane and configure it. Each tool documents its own settings.
4. 04Publish the page.

Upload the newer .sppkg over the old one in the same app catalogue and deploy it again. Pages using the web part pick up the new version on their next load, and configuration is preserved.

Get-SPOApp -Identity "Rollup" |
  Select-Object Title, AppVersion, IsEnabled