'%3e%3cpath%20d='M8%200C12.4183%200%2016%203.58172%2016%208C16%2012.4183%2012.4183%2016%208%2016C3.58172%2016%200%2012.4183%200%208C0%203.58172%203.58172%200%208%200ZM11.6162%204.38379C11.2257%203.99337%2010.5927%203.99338%2010.2021%204.38379L8%206.58594L5.79785%204.38379C5.40732%203.99334%204.77429%203.99329%204.38379%204.38379C3.99331%204.77429%203.99335%205.40733%204.38379%205.79785L6.58594%208L4.38379%2010.2021C3.99348%2010.5927%203.99341%2011.2257%204.38379%2011.6162C4.77426%2012.0066%205.40734%2012.0065%205.79785%2011.6162L8%209.41406L10.2021%2011.6162C10.5927%2012.0066%2011.2257%2012.0067%2011.6162%2011.6162C12.0067%2011.2257%2012.0066%2010.5927%2011.6162%2010.2021L9.41406%208L11.6162%205.79785C12.0066%205.40735%2012.0066%204.77429%2011.6162%204.38379Z'%20fill='%23080E17'%20fill-opacity='0.46'/%3e%3c/g%3e%3cdefs%3e%3cclipPath%20id='clip0_3761_713'%3e%3crect%20width='16'%20height='16'%20fill='white'/%3e%3c/clipPath%3e%3c/defs%3e%3c/svg%3e)
How to Fix SharePoint App Not Appearing After SPPKG Deployment
Question details
The user is attempting to deploy a custom SharePoint Framework (SPFx) application using an SPPKG package, but the app does not show up in the environment after deployment.
- Product
- Microsoft SharePoint
- Device & OS
- not provided
- Scenario
- Deploying a SharePoint Framework app package (SPPKG) to a tenant or site catalog for end-user access.
- Observed behavior
- The application works perfectly during local testing with gulp serve, but fails to appear under Site contents or site navigation after being deployed via the SPPKG file.
Ensure you have SharePoint Administrator or Site Collection Administrator privileges, as these are required to upload, deploy, and approve apps in the SharePoint App Catalog.
Verify App Catalog Deployment and Target Site Installation
This solution ensures the SPPKG file is correctly uploaded, globally or locally deployed, and actively installed on the target SharePoint site.
A common reason for an SPFx app not appearing is an incomplete deployment process. Even if the package is uploaded to the App Catalog, it must be deployed and then specifically added to the target site unless it was configured to be deployed tenant-wide automatically.
Navigate to the SharePoint Admin Center, expand the 'More features' menu, and click on 'Apps' to open your tenant's App Catalog.
Upload your SPPKG file to the 'Apps for SharePoint' library. When prompted, ensure you check the box that says 'Make this solution available to all sites in the organization' if you want it globally accessible, then click 'Deploy'.
Go to the specific SharePoint site where you want to use the app. Click the Gear icon (Settings) in the top right corner and select 'Add an app'.
Search for your custom app under 'Apps you can add' and click on it to install. Once completed, navigate to 'Site contents' to confirm the app appears in the list of installed applications.
Looking for a Reliable and Free Office Suite? Try WPS Office
While resolving Microsoft SharePoint deployment issues, consider optimizing your daily document workflows with WPS Office. It provides a lightweight, highly compatible, and cost-effective alternative to Microsoft Office for your personal and professional needs.
- 1. Download the Installer: Visit the official WPS Office website and click the Free Download button for your operating system.
- 2. Install the Software: Run the downloaded installer file and follow the simple on-screen instructions.
- 3. Start Creating: Open WPS Office and instantly start creating or editing your documents, spreadsheets, and presentations.
Frequently Asked Questions
Why does my SharePoint app work in 'gulp serve' but not in production?
Running 'gulp serve' hosts the application assets on your local machine's web server. Production deployment requires the SPPKG file to be correctly bundled, assets to be hosted (either in Microsoft 365 or a CDN), and the app to be explicitly deployed with the correct tenant permissions.
How do I check if my SPPKG package has deployment errors?
You can view deployment errors by navigating to the App Catalog site, selecting your uploaded app package, and checking the 'App Package Error Message' column in the document library view. This will provide details on what failed during deployment.
Can I deploy an SPPKG file without tenant admin rights?
Generally, you need at least Site Collection Administrator rights to deploy an app to a site-level App Catalog. To deploy an app globally across the entire organization, you must have SharePoint Administrator privileges to access the tenant App Catalog.
