Skip to main content

How to Download a Canvas App as a Teams App Package in Power Apps

· 6 min read
Jagdish Kumawat
Founder @ Dewiride

Power Apps can save a canvas app as a Teams app package: a .zip file with the app's Teams manifest and two icons. Select the app's More commands (⋮) > Share > Add to Teams, then Download app. The package is what a Teams admin uploads to put the app in the organization's app catalog.

The example is Hello App, a one-screen canvas app that greets whoever opens it.

Step 1: Open the Add to Teams Panel​

At make.powerapps.com, select Apps, then the app's More commands (⋮) > Share > Add to Teams, the same menu as How to Add a Canvas App to Microsoft Teams from Power Apps. The Add to Teams panel opens on the right.

Step 2: Check the Details That Go into the Package​

The panel shows the app's name and description, which become the app's name and description in Teams. Check them now: App details can't be changed in Teams once added. To change them, select Edit details, which opens the app in Power Apps Studio.

Select Advanced settings for the optional details:

The Add to Teams panel for Hello App with Advanced settings open: Developer information (optional), Make sure the website is a valid https URL., boxes for Name, Website, Terms of Use and Privacy Policy, Add a partner ID (optional) with an MPN ID box, and the Add to Teams and Download app buttons

SettingWhat it's for
NameThe developer's name, shown as the app's publisher in Teams
Website, Terms of Use, Privacy PolicyLinks Teams shows with the app; each must be a valid https URL
MPN IDA Microsoft Partner Network ID, to track the app's usage

I left them all empty. The package then names PowerApps as the developer, with Power Apps' own website, privacy and terms links.

Step 3: Download the App​

Select Download app. The browser saves a .zip file named after the app, here Hello App.zip, and the panel explains what to do with it:

The Add to Teams panel after downloading: Uploading your app to Teams, Go to your Apps page in Teams where you'll find an option to Upload a custom app. Upload your app's .zip file and follow the prompts. Otherwise, if you're unable to upload a custom app yourself, send the .zip file to your Teams admin. Learn more

Select Close.

What's in the Package​

Hello App.zip held three files:

FileSizeWhat it is
manifest.json2,197 bytesThe app's Teams manifest: its name, description, icons, and the tabs that open the app
color.png4,714 bytesThe full-color icon, 192 × 192 pixels
outline.png531 bytesThe outline icon, 32 × 32 pixels

The manifest uses manifest version 1.8. It has a personal tab, which opens the app from Power Apps' web player, and a tab for teams and group chats. The two icon sizes are the ones Microsoft's app icon article asks for.

Where the Package Goes​

Common Mistakes​

MistakeWhat happensDo this instead
Downloading before adding a descriptionThe package carries no useful descriptionAdd one with Edit details first
Renaming the files inside the .zipTeams can't find what the manifest namesKeep manifest.json, color.png and outline.png as they are
Downloading a package for an app nobody can openTeams shows it, but people can't use itShare the app too

Troubleshooting​

SymptomLikely causeFix
You can't find the .zipIt went to the browser's download folderOpen the browser's list of downloads
The admin center refuses the packageIt asks for a newer manifest versionSee the Fixed post above
The description is cut short in TeamsTeams' short description holds at most 80 charactersShorten the app's description

FAQ​

Is the package the app itself?​

No. It tells Teams how to show the app; the app still runs from Power Apps, for the people it's shared with.

Why is my description cut off?​

The manifest has a short and a full description, and the manifest schema allows at most 80 characters in the short one. Power Apps cuts a longer description at 80 characters for it.

Do I download again after changing the app?​

Not for changes inside the app, which Teams opens from Power Apps. Download again only to change what the package holds, such as the name, description or icon.

Conclusion​

Select the app's More commands (⋮) > Share > Add to Teams, check the details and Advanced settings, and select Download app. You get a .zip with manifest.json and two icons, ready for your Teams admin.

Additional Resources​