Others

Fix SPFx App Catalog Missing the Deploy Option in SharePoint

Steve KSteve K Nov 2, 2026 868 views

Question details

The user is unable to deploy an SPFx web part package because the trust and deploy dialog or the 'Deploy' option is missing in the SharePoint site collection app catalog.

How to Fix SPFx App Catalog Missing the Deploy Option
Product
Microsoft SharePoint
Device & OS
not provided
Scenario
Uploading a custom SPFx web part package to a SharePoint app catalog for deployment.
Observed behavior
The 'Deploy' option or the trust and deploy dialog does not appear after the package is uploaded.
Before you start

Ensure you have the necessary site collection administrator privileges and that your SharePoint app catalog is properly configured before deploying custom SPFx packages.

Solution 1Recommended

Verify Site Collection App Catalog and Upload Method

Ensure the app catalog is correctly configured and use the drag-and-drop upload method to properly trigger the deployment prompt.

In many cases, using the classic 'Upload' button in the SharePoint library can bypass the modern deployment trigger script, resulting in the missing dialog.

1
Navigate to the App Catalog

Open your SharePoint site collection and navigate to the 'Apps for SharePoint' library.

2
Drag and drop the package

Instead of clicking the 'Upload' button, drag your .sppkg file directly from your local folder into the library window.

3
Confirm the deploy dialog

Wait for the upload to complete. The 'Do you trust...' deployment dialog should now appear automatically.

Verify Site Collection App Catalog and Upload Method
Tip: If the dialog still does not appear, try clearing your browser cache or using an incognito window to ensure no cached scripts are interfering.
Free Microsoft Office alternative

Looking for a Lightweight Alternative to Microsoft Office?

While SharePoint and SPFx require specialized Microsoft environments, everyday document, spreadsheet, and presentation tasks don't have to be complicated. WPS Office provides a free, lightweight, and highly compatible alternative to Microsoft Office for your daily productivity needs.

  1. 1. Download WPS Office: Visit the official WPS website and download the free installation package for your operating system.
  2. 2. Install the software: Run the downloaded installer and follow the simple on-screen instructions to complete the setup.
  3. 3. Open and edit files seamlessly: Launch WPS Office to easily open, edit, and save your existing Microsoft Office files without any formatting issues.
Fully compatible with Microsoft Word, Excel, and PowerPoint file formats (.docx, .xlsx, .pptx).Lightweight installation with a familiar, easy-to-use tabbed interface.Includes powerful built-in PDF editing and conversion tools.Free to use with seamless cross-platform syncing.
microsoft office alternative - wps office

Frequently Asked Questions

Why does the deploy dialog not appear when I click Upload?

Sometimes the classic upload button in SharePoint bypasses the modern deployment trigger script. Dragging and dropping the .sppkg package directly into the library often resolves this issue.

Who can deploy SPFx web parts to a site collection app catalog?

You must be assigned Site Collection Administrator privileges to successfully upload, trust, and deploy custom SPFx packages to a site collection app catalog.

What should I do if my site doesn't have an app catalog?

A SharePoint Administrator or Global Administrator must first create and configure the App Catalog site for your tenant before you can deploy any custom SPFx web parts.