Application Manifest


This guide is only relevant for Native Teams bots. If you are using the Web Teams bot, you do not need to do this.

This guide will go over the application manifest. Below is a base template for a simple manifest. The manifest will be used to install the Teams Application (not azure application) locally to your sandbox organization.

You can distribute the manifest to your users, but they will need to be an admin to install it throughout the organization. Instead we recommend publishing your application to the Microsoft Teams App Store.

Zip the manifest along with any assets it references to install it.

    "$schema": "",
    "manifestVersion": "1.11",
    "version": "1.0.0",
    "id": "<uuid>",
    "packageName": "",
    "developer": {
        "name": "<company>",
        "websiteUrl": "<website>",
        "privacyUrl": "<privacy>",
        "termsOfUseUrl": "<tos>"
    "icons": {
        "color": "color.png",
        "outline": "outline.png"
    "name": {
        "short": "<name_short>",
        "full": "<name_full>"
    "description": {
        "short": "<desc_short>",
        "full": "<desc_long>"
    "accentColor": "#FFFFFF",
    "staticTabs": [],
    "bots": [
            "botId": "<bot_id>",
            "scopes": [ "team", "groupchat", "personal" ],
            "supportsFiles": false,
            "isNotificationOnly": false
    "permissions": [],
    "validDomains": []


This table doesn't describe every property. You can get better documentation here.

versionstringApplication version following semantic versioning.
idguid/uuidAzure Application Id.
icons.colorstringFilename of a 192x192 PNG full color icon. Needs to be included in the ZIP archive.
icons.outlinestringFilename of a 32x32 PNG transparent greyscale icon. Needs to be included in the ZIP archive.
name.shortstringName of the bot. Max of 30 characters.
bots.[].idguid/uuidAzure Application Id.

Installing the application locally


Microsoft offers many clients for teams, and steps may not be accurate for all of them, this guide uses the web teams client.

  1. Find the Apps tab and Manage your apps menu item.
  1. Publish an app and select Upload a custom app. Then submit the zipped manifest and assets.
1373 682

Removing the application locally

Navigate to the following webpage:
Expand the "Teams Apps" sidebar tab, and click on "Manage apps"


Find your bot in the list, and click on it


Click on the 3 dots at the side of the title card, then enter the "Actions" dropdown category to find the "Delete" button. Click the delete button.