You created a Copilot Studio agent and published it, but it does not show up in the Microsoft Teams app store. This prevents your team from installing and using the agent inside Teams chats and channels. The problem usually comes from missing deployment steps, incorrect permissions, or a misconfigured app manifest. This article explains the root causes and provides a step-by-step fix to make your agent visible in the Teams app store.
Key Takeaways: Making a Copilot Studio Agent Visible in Teams
- Copilot Studio > Publish > Channels > Microsoft Teams: You must explicitly enable the Teams channel before the agent appears in the app store.
- Teams admin center > Manage apps > Allow: A tenant-level admin must allow the agent for all users or specific groups.
- App manifest > icon and description: Missing or malformed app icons and descriptions block the agent from appearing in search results.
Why the Copilot Studio Agent Is Missing from the Teams App Store
When you publish a Copilot Studio agent, it does not automatically become available in the Teams app store. The agent must be deployed to a specific channel, and Teams is one of several possible channels. If you did not select the Teams channel during publishing, the agent remains invisible to Teams users. Additionally, the agent must be approved by a Teams administrator. Even if the channel is enabled, the app may be blocked by default in the Teams admin center. A third common cause is an incomplete app manifest. Copilot Studio generates a manifest for Teams, but if the icon images exceed size limits or the description contains invalid characters, Teams rejects the submission and the agent never appears.
Channel Configuration
In Copilot Studio, each agent can be published to multiple channels: a demo website, Microsoft Teams, Microsoft Copilot, and others. The Teams channel is not selected by default. You must manually toggle it on. If you skip this step, the agent is published but not registered with Teams.
Administrator Approval
Teams has a built-in app governance system. New apps, including Copilot agents, are blocked by default unless an administrator explicitly allows them. The app appears in the Teams admin center under Manage apps, but it shows a status of Blocked. Until an admin changes the status to Allowed, the agent does not appear in any user’s app store.
Manifest Validation
The manifest is a JSON file that tells Teams how to display and run the agent. Copilot Studio generates this file automatically, but if you modified it manually or if the agent uses custom icons, the manifest may fail validation. Teams requires icons in PNG format, 192×192 pixels for the full icon and 32×32 for the outline icon. If the icons are missing, too large, or the wrong format, the manifest is rejected silently and the agent never appears.
Steps to Fix the Missing Copilot Studio Agent in Teams
Follow these steps in order. After each step, check the Teams app store to see if the agent appears. You may need to wait up to 24 hours for changes to propagate.
- Enable the Teams channel in Copilot Studio
Go to Copilot Studio and open your agent. Select Publish from the left navigation. Click Channels. Find Microsoft Teams in the list. Toggle the switch to On. Click Save and then Publish. This registers the agent with the Teams platform. - Verify the agent in Teams admin center
Sign in to the Microsoft 365 admin center. Go to Teams admin center > Teams apps > Manage apps. Search for your agent by name. If it appears with a status of Blocked, proceed to the next step. If it does not appear at all, wait 30 minutes and refresh the page. If it still does not appear, re-publish the agent from Copilot Studio. - Allow the agent for your organization
In the Manage apps page, click the agent name. Click the Allow button. Optionally, select specific users or groups under Assign to. Click Save. The agent status changes to Allowed. Users can now see the agent in the app store. - Check the app manifest for errors
In Copilot Studio, go to Publish > Channels > Microsoft Teams. Click Download manifest. Open the ZIP file and extract the manifest.json file. Open it in a text editor. Verify the icons section points to valid PNG files. Check that the description is under 128 characters and contains no special characters like quotes or backslashes. If you find errors, correct them in Copilot Studio by editing the agent details, then re-publish. - Clear the Teams client cache
On the user’s machine, close Teams completely. Open File Explorer and go to %appdata%\Microsoft\Teams. Delete all files in this folder. Restart Teams. This forces Teams to reload the app manifest from the server. The agent should now appear in the app store.
If Copilot Studio Agent Still Does Not Appear
If the agent remains invisible after completing the main steps, check these additional factors.
Agent Is Published to the Wrong Environment
Copilot Studio agents are environment-scoped. If you published the agent in a development environment but users are in a production environment, the agent does not appear. Go to Copilot Studio and check the environment selector in the top-right corner. Switch to the correct environment and re-publish.
Teams App Setup Policy Blocks the Agent
Even if the app is Allowed, an app setup policy may prevent specific users from seeing it. In the Teams admin center, go to Teams apps > Setup policies. Check the policy applied to your users. Ensure the agent is not listed under Blocked apps. If it is, remove it from the blocked list and save the policy.
Copilot Studio Agent Exceeds Teams App Size Limits
The Teams app store has a size limit of 50 MB for the entire app package. If your agent includes large files like custom images or audio, the package may exceed this limit. In Copilot Studio, reduce the size of any uploaded files. Re-publish the agent.
Copilot Studio Agent Visibility in Teams: Before and After Fix
| Item | Before Fix | After Fix |
|---|---|---|
| Teams channel enabled | No | Yes |
| Admin approval status | Blocked | Allowed |
| Manifest icon | Missing or oversized | 192×192 PNG, 32×32 PNG |
| App store visibility | Not listed | Listed in search results |
After applying the steps above, your Copilot Studio agent should appear in the Teams app store. Test by searching for the agent name in the Teams Apps section. If the agent still does not appear, verify that all users have the correct app setup policy and that the agent is published to the production environment. For advanced scenarios, use the Teams admin center audit log to check when the app was allowed and by which administrator.