Customizing the Teams App Name and Icons

Last updated: April 1, 2026

You can customize the Orchestry app's name and icon to be more familiar to your end users. This can be especially useful if you're transitioning from a different provisioning tool or process. 

Configuring the Teams App

  1. Navigate to Settings > Teams ApplicationA new section will appear on the right allowing you to customize your app.

2024-05-10-36

  1. Enable the Custom Teams App feature

2024-05-10-37

  1. Add a new App name. The name must be fewer than 30 characters and should ideally be a single word to be visible on the users' Team App Bar.

2024-05-10-38

  1. Configure a new App Description. The description must be fewer than 80 words.

2024-05-10-39

  1. Populate an App Icon (Outline) 

  • The image must be a PNG

  • The image must be 32px by 32px

  • The icon should be full bleed to the frame

  • The icon must be white (#FFFFFF)

  • The background must be transparent

Note: The app icon will automatically adjust from an inactive state (Dark Grey) to an active state (Teams Purple) when clicked by the user.

2024-05-10-402024-05-10-41

  1. Populate an App Icon (Colour)

  • The image must be a PNG

  • The image must be 192px by 192px

  • The icon should not be full bleed to the frame but allow a safe zone between the frame edge and the icon (see links below from Microsoft) 

  • The icon can have a transparent background, or not

2024-05-10-422024-05-10-43



7. Save your changes

2024-05-10-35
  1. Re-deploy the Teams App with the new customizations. To do this, navigate to https://app.orchestry.com/settings/installation and in the Teams App Install Status, click Install Teams App.

kbimg-Dec-22-2023-10-12-57-1110-PM

Where/How Your Custom Teams App Will be Seen

Your changes will be visible within the Teams experience only but will include the following places:

  1. App Name and Colour Icon when seen in the App Store

  2. App Name and Colour Icon when seen when adding new Tabs to a channel

  3. App Name and Colour Icon when the app is hovered over in some locations

  4. App Name and Colour Icon when the app "About" is clicked

  5. App Name and Colour Icon when seen in Teams Notifications sent via Orchestry

  6. App Name and Outline Icon when seen 'hoisted' on the App Bar

kbimg-Dec-22-2023-10-14-18-6929-PM