Skip to main content

How to Add a Canvas App to Microsoft Teams from Power Apps

· 7 min read
Jagdish Kumawat
Founder @ Dewiride

To use a canvas app inside Microsoft Teams, add it as a personal app: in Power Apps, select the app's More commands (⋮) > Share > Add to Teams, then Add to Teams in the panel. Teams opens and asks you to Add it, and the app then opens in Teams, in the app bar on the left.

The example is Hello App, a one-screen canvas app whose label says "Hello, " & User().FullName, so it greets whoever opens it.

This adds the app for you only. To give it to your whole organization, a Teams admin uploads it to the organization's app catalog instead (How to Upload a Custom App in the Teams Admin Center).

Prerequisites​

  • Your organization allows custom apps in Teams. Microsoft's article says the Teams custom app policies must allow uploading custom apps.

Step 1: Choose Add to Teams​

At make.powerapps.com, select Apps, find the app, and select its More commands (⋮). Point to Share and select Add to Teams:

The app's More commands menu with Edit, Play, Share, Export package, Wrap, Details, Create agent from app, Settings and Delete, and the Share submenu open with Share and Add to Teams

Step 2: Review the App Details​

The Add to Teams panel opens on the right, with the app's name and description, and a warning: App details can't be changed in Teams once added. Hello App had no description, so the panel said so and offered Edit details, which opens the app in Power Apps Studio to add one:

The Add to Teams panel: Review app details, App details can't be changed in Teams once added, Hello App, the Description Your app doesn't have a description, optionally add one in app settings, Edit details, Advanced settings, and the Add to Teams and Download app buttons

The description is what Teams shows about the app, so for an app other people will see, add one first. Advanced settings holds optional developer details, covered in How to Download a Canvas App as a Teams App Package in Power Apps.

Select Add to Teams.

Step 3: Open Teams​

A new browser tab opens with the choice of Teams app:

The Teams page Stay better connected with the Teams desktop app, with Download the Mac app, Use the web app instead, and Already have the Teams app? Launch it now

Select Launch it now if you have the Teams desktop app, or Use the web app instead for Teams in the browser. I used the web app.

If Teams opens without asking to add the app

The first time, Teams on the web took more than five minutes to finish loading in that tab, and when it did, it showed Teams as usual, without asking about the app, and the app wasn't added. With Teams already open in the browser, I chose Add to Teams in Power Apps again, and this time Teams asked straight away.

Step 4: Add the App​

Teams shows the app's details: its name, Power Apps as the publisher, the description and what it can do, a Personal app and a Tab. Select Add:

The Teams app dialog for Hello App by Power Apps with the Add button, 0 Installs in the last month, Works in Teams, Free, the description Hello App is an app built using Power Apps., and Capabilities in Teams: Personal app and Tab

Teams confirms with Added successfully! and asks where to use the app. Select Open to use it on its own, as a personal app:

The Added successfully! dialog for Hello App: How would you like to use this app today?, the Open button, and Or choose a place to use the app with a search box for a channel or chat

The search box below is for adding it as a tab in a channel or chat instead.

The Result​

The app opens in Teams, under its own name, and its icon is in the app bar on the left. Hello App greeted me by name:

Hello App open in Teams on the web, with its icon highlighted in the app bar on the left, and the label Hello, Admin User

To keep it in the app bar for quick access, pin it (How to Pin an App to the App Bar in Microsoft Teams).

Common Mistakes​

MistakeWhat happensDo this instead
Adding an app with no descriptionTeams has nothing to say about itEdit details and add one first
Expecting colleagues to get it tooThis adds it for you onlyShare the app, and have the admin upload it to the catalog
Selecting a channel instead of OpenIt's added as a tab in that channelOpen, for a personal app

Troubleshooting​

SymptomLikely causeFix
Teams opens but never asks to add the appNot documented; it happened while Teams on the web loaded for the first timeOpen Teams first, then Add to Teams again
No Add to Teams in the menuIt's under SharePoint to Share
Teams won't add itCustom apps aren't allowed for youAsk your Teams admin to check the custom app settings (How to Check If Custom Apps Are Allowed in Microsoft Teams)

FAQ​

Can I change the app's name or description in Teams later?​

Not from Teams: the panel warns that App details can't be changed in Teams once added. Change them in Power Apps and add the app again.

Does the app in Teams update when I publish a new version?​

The Teams app opens the app from its Power Apps web link, which plays the published version. Microsoft's article says to publish a change and then play the app within Teams to test it.

Who else can open it?​

Only people the app is shared with (How to Share a Canvas App with Specific People in Power Apps).

Conclusion​

Select the app's More commands (⋮) > Share > Add to Teams, check the details, select Add to Teams, open Teams, and select Add, then Open. The app runs inside Teams, for you; for everyone, the Teams admin uploads it to the organization's catalog.

Additional Resources​