Skip to main content
Before using the CWM web parts, upload the .sppkg file to your tenant’s app catalog so they’re available to add to SharePoint pages. You can download the latest version of the CWM package here (direct download).

​
Prerequisites

Before uploading, ensure the following:
  • You have SharePoint Administrator or Site Collection Administrator privileges.
  • The .sppkg file has been generated (e.g., via gulp bundle --ship and gulp package-solution --ship).
  • The App Catalog is already created:
    • Tenant App Catalog: Managed centrally across all sites.
    • Site Collection App Catalog: Scoped to one site collection.

​
Access the app catalog

Tenant App Catalog
  1. Go to:
    https://<your-tenant-name>.sharepoint.com/sites/appcatalog
  2. If this site doesn’t exist:
    • In the SharePoint Admin Center, navigate to
      More features -> Apps -> Open.
    • Click App Catalog and follow the prompts to create one.
Site Collection App Catalog
  1. Go to your specific site collection.
  2. Append /_layouts/15/appcatalog.aspx to the URL, e.g.:
    https://<your-site>.sharepoint.com/sites/<yoursite>/_layouts/15/appcatalog.aspx

​
Upload the .sppkg file

  1. In the App Catalog site, select Apps for SharePoint.
  2. Click Upload.
  3. Browse and select your .sppkg file (usually from sharepoint/solution in your SPFx project).
  4. Click OK.

​
Trust the app

When prompted:
  • Review the app details.
  • Check the box for “Make this solution available to all sites in the organization” if you want it to be globally available (tenant catalog only).
  • Click Deploy.

​
Verify deployment

After deployment:
  • The app should appear in the Apps for SharePoint list.
  • Check the Deployed column -> it should show Yes.
  • Optionally, check the App Catalog -> Apps for SharePoint for version info.

​
Add the app to a site

If not globally deployed:
  1. Go to your site.
  2. Click the Settings (⚙) -> Add an app.
  3. Select your uploaded app.
  4. Wait until installation completes.
  5. Your SPFx web parts/extensions will now be available in the site.