Fix Custom Teams App Uploaded but Not Visible in Microsoft Teams
Question details
The user uploaded a custom application in the Teams admin center, but it fails to show up in the Teams client even though custom app downloads are permitted.

- Product
- Microsoft Teams
- Device & OS
- not provided
- Scenario
- Deploying a custom application for users via the Microsoft Teams admin center.
- Observed behavior
- The newly uploaded custom app does not appear in the Microsoft Teams desktop client for users to access or install.
Ensure you have administrator privileges in the Microsoft Teams admin center and confirm that your organization's global policies allow the uploading of custom apps.
Verify on Web Client, Re-upload, and Clear Cache
Checking the web client isolates the issue. If it works on the web, clearing the desktop cache usually forces the app to synchronize and appear.
The Microsoft Teams desktop client aggressively caches data to improve performance, which can sometimes delay the visibility of newly deployed apps. Testing on the web client bypasses this local cache.
Open your web browser, navigate to the Microsoft Teams web app, and log in to see if the custom app is visible.
If the app appears on the web client but not the desktop client, go to the Teams admin center, remove the custom app, and upload the package again.
Fully quit the Teams desktop client. Press Win + R, type '%appdata%\Microsoft\Teams', and delete all files in this directory. For the 'New Teams' client, go to Windows Settings > Apps > Installed apps > Microsoft Teams > Advanced options > Reset.
Launch the Microsoft Teams desktop client again. The app will rebuild its cache and fetch the latest policies and available custom apps.

Review App Setup Policies in the Admin Center
Verify that the app is properly authorized and assigned to the affected users within the Teams admin center setup policies.
Try WPS Office for Your Document and Collaboration Needs
While you troubleshoot Microsoft Teams, consider WPS Office as a lightweight, highly compatible alternative for your core productivity tasks. It offers robust tools for creating, editing, and sharing Word, Excel, and PowerPoint files without the high costs and heavy resource demands of other enterprise suites.

Frequently Asked Questions
How long does it typically take for a custom app to appear in Microsoft Teams?
While it can occasionally happen within a few minutes, Microsoft states that app deployments and policy changes can take up to 24 hours to propagate completely across the network and appear for all users.
Why is the option to upload a custom app completely missing?
This happens when your account does not have the necessary permissions. The 'Upload custom apps' setting must be explicitly enabled by a Teams administrator in the admin center under the applicable App Setup Policy.
Will clearing my Microsoft Teams cache delete my chat history or files?
No, clearing the Teams cache only removes temporary files, preferences, and session data to resolve sync issues. Your chat history, contacts, and files are securely stored on Microsoft's servers and will reload when you log back in.




