Others

Fix SPFx Web Part Missing from SharePoint Add an App List

Ayan Masood Sep 27, 2026 868 views

Question details

A custom SharePoint Framework (SPFx) web part does not appear in a site's "Add an app" list, even though it is successfully uploaded to the Apps for SharePoint catalog.

Fix SPFx Web Part Missing from SharePoint Add an App List

Product: Microsoft SharePoint
Device & OS: not provided
Scenario: Deploying a custom SharePoint Framework app or web part for site users.
Observed behavior: The deployed SPFx web part is visible in the tenant's App Catalog but is missing when users attempt to add it via the site-level "Add an app" menu.

Before you start

Ensure you have Site Collection Administrator privileges and access to the central SharePoint App Catalog before modifying tenant-wide app availability or site permissions.

Solution 1Recommended

Re-upload and Configure App Catalog Settings

Verify the package upload process and ensure the web part is configured to be available across all sites.

Often, SPFx web parts fail to appear in the site-level app list because they were not explicitly deployed to all sites during the initial upload to the App Catalog. Re-uploading the package ensures you can select the correct deployment scope.

Navigate to the App Catalog

Go to the SharePoint admin center, click on 'More features', and open the 'Apps' section to access the App Catalog.

Re-upload the SPFx Package

Drag and drop your custom .sppkg file into the Apps for SharePoint library. Choose to replace the existing file if prompted.

Make Available to All Sites

In the deployment prompt, ensure you check the box labeled 'Make this solution available to all sites in the organization' before clicking Deploy.

Verify Site Experience Compatibility

Ensure your SPFx web part configuration in the manifest file supports the specific site experience (modern or classic) where you are trying to add it.

Re-upload and Configure App Catalog Settings

Global Deployment: Checking the global availability option removes the need for site owners to manually install the app on every individual site collection.

Solution 2

Check Site Permissions and Custom Script Settings

Ensure the target SharePoint site allows custom scripts and has the correct site collection features enabled.

Free Microsoft Office alternative

Discover WPS Office for Seamless Document Collaboration

While managing complex SharePoint deployments, you also need reliable tools for everyday documentation. WPS Office is a powerful, lightweight, and entirely free alternative to Microsoft Office. It offers a familiar interface and excellent compatibility with your team's existing workflow.

1. Download WPS Office: Visit the official WPS website and download the free installer for your operating system.
2. Install the Application: Run the installer and follow the on-screen instructions to set up the software quickly.
3. Open Your Documents: Launch WPS Office and open your existing Microsoft Office files seamlessly without any formatting loss.

Fully compatible with Microsoft Word, Excel, and PowerPoint formats (.docx, .xlsx, .pptx).Lightweight application that opens instantly on Windows, Mac, and Linux environments.Built-in PDF editing and cloud sync for easy document sharing and team collaboration.Completely free to use with a familiar, user-friendly tabbed interface that requires zero learning curve.

microsoft office alternative - wps office

Frequently Asked Questions

Why does my SPFx web part work on modern sites but not classic sites?

SharePoint Framework (SPFx) web parts are primarily designed for the modern SharePoint experience. To use them on classic pages, the web part's configuration manifest must explicitly support classic environments, though modern pages are highly recommended by Microsoft.

What happens if I do not select 'Make this solution available to all sites'?

If this option is left unchecked during the App Catalog upload, the SPFx web part will not automatically populate in the 'Add an app' list across your entire tenant. You will need to manually install the app on each specific site collection where it is required.

How do I contact Microsoft Support if the web part is still missing?

If you have verified the App Catalog settings, permissions, and custom scripts but the web part remains unavailable, you can contact Microsoft Support. Go to the Microsoft 365 admin center, click on 'Support' in the left-hand navigation menu, and select 'Help & support' to open a ticket.

Office Quick Solutions