> ## Documentation Index
> Fetch the complete documentation index at: https://helpdocs.getthread.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Upgrade your Legacy Teams App

> Upgrade legacy Thread Teams App deployments before Microsoft's deprecation deadline to enable full SSO, auto-updates, and uninterrupted client support.

## **Overview**

This guide will walk you through the process of upgrading your Legacy Teams App deployments. You can check to see if you have Legacy Teams apps deployed by navigating to Thread Admin Panel > [**Clients**](https://admin.getthread.com/dashboard/clients/companies). **If you see the following banner, you need to upgrade all Teams apps before March 31st, 2026, or they will** **could functioning for your clients**\*\*.\*\*

<Warning>
  We are now past the deadline and Microsoft can and will choose to depreciate the legacy app at any time. If you do not Upgrade your app, you could lose service at ANY TIME.
</Warning>

<Frame>
  <img src="https://mintcdn.com/thread/XL4w2StwzALuT8Pw/images/670b42bf-2025-12-11-09-29-56.png?fit=max&auto=format&n=XL4w2StwzALuT8Pw&q=85&s=e1be853372edc6755503c186a3c93ca8" alt="Thread Admin Panel banner prompting a legacy Teams app upgrade" width="1631" height="402" data-path="images/670b42bf-2025-12-11-09-29-56.png" />
</Frame>

You need to upgrade your legacy teams Apps because Microsoft is deprecating older authentication methods due to security vulnerabilities.

The new Teams app includes several new features that will improve your client experience:

* **Full SSO** - Clients will no longer need to sign in with their Microsoft Credentials when opening the application the first time.
* **Auto-Update Capability** - You shouldn't need to update your apps again; they will stay up-to-date automatically.

Below is step by step guild on how to update your Teams apps.

### **Preliminary Steps**

<Steps>
  <Step title="Open an incognito browser session">
    Open a separate browser session in incognito mode to ensure you sign into the correct Microsoft Teams environment.
  </Step>

  <Step title="Sign in to the Thread Admin Panel">
    Sign in to the [Thread Admin Panel](https://admin.getthread.com/) and Navigate to the [Clients](https://admin.getthread.com/dashboard/clients/companies) tab.

    <Frame>
      <img src="https://mintcdn.com/thread/XL4w2StwzALuT8Pw/images/7a4ad904-2025-12-10-15-44-50.png?fit=max&auto=format&n=XL4w2StwzALuT8Pw&q=85&s=6471679553ddcca9b8db90ecb201e238" alt="Clients tab in the Thread Admin Panel" width="3826" height="1610" data-path="images/7a4ad904-2025-12-10-15-44-50.png" />
    </Frame>
  </Step>
</Steps>

<Note>
  If you have lots of Legacy Apps to upgrade we recommend exporting list to CSV to share the upgrade work to multiple people.  The csv will give you Client Name and direct link to App Deployment page of that client.
</Note>

<Frame>
  <img src="https://mintcdn.com/thread/XL4w2StwzALuT8Pw/images/68b33b3c-2025-12-10-15-46-04.png?fit=max&auto=format&n=XL4w2StwzALuT8Pw&q=85&s=a4f4c00937625c5757a103fb8aa89e51" alt="Exporting the list of legacy apps to CSV" width="378" height="149" data-path="images/68b33b3c-2025-12-10-15-46-04.png" />
</Frame>

### **Deployment Process**

<Steps>
  <Step title="Open the client's App Deployment page">
    You can click on the Legacy Service Bot from the Clients page or use the direct link from the csv if you downloaded it.Both ways will end you up on the following page below:

    <Frame>
      <img src="https://mintcdn.com/thread/juCyEL4f0qmxDa7M/images/1fae04c6-2025-12-10-15-46-46.png?fit=max&auto=format&n=juCyEL4f0qmxDa7M&q=85&s=0291b0b3322668c4b772fe1c09f464c2" alt="Client App Deployment page for the Legacy Service Bot" width="330" height="121" data-path="images/1fae04c6-2025-12-10-15-46-46.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/thread/XL4w2StwzALuT8Pw/images/74e78d4b-2025-12-10-15-47-43.png?fit=max&auto=format&n=XL4w2StwzALuT8Pw&q=85&s=690de83e5f5e8eaff60c90bfeacf258d" alt="Legacy Service Bot deployment details" width="1251" height="1417" data-path="images/74e78d4b-2025-12-10-15-47-43.png" />
    </Frame>
  </Step>

  <Step title="Click Update Now">
    Click on Update Now button You will get the following pop-up just warning you that if you do the upgrade during your clients business hours they may lose the ability to use the Teams Support app for a few hours.

    <Frame>
      <img src="https://mintcdn.com/thread/XL4w2StwzALuT8Pw/images/70a984f4-2025-12-10-15-48-13.png?fit=max&auto=format&n=XL4w2StwzALuT8Pw&q=85&s=a8df3c0350b98a52c10dbceefeabaa6b" alt="Update Now confirmation pop-up warning of possible downtime" width="1027" height="405" data-path="images/70a984f4-2025-12-10-15-48-13.png" />
    </Frame>

    <Note>
      We recommend doing this outside of business hours
    </Note>
  </Step>

  <Step title="Click Continue">
    Click Continue you will see the screen below:

    <Frame>
      <img src="https://mintcdn.com/thread/wn6TrV7GJB-j5H1g/images/c17a644a-2025-12-10-15-48-53.png?fit=max&auto=format&n=wn6TrV7GJB-j5H1g&q=85&s=aa5080603389fca902bbec3f14f5a8b7" alt="Screen shown after clicking Continue on the upgrade" width="1142" height="924" data-path="images/c17a644a-2025-12-10-15-48-53.png" />
    </Frame>
  </Step>

  <Step title="Copy the Magic Link and authenticate">
    Click "**Copy link**" next to the **Magic Link** and paste it into a new tab in your current incognito browser session. When you navigate to the Magic Link, you'll be prompted to authenticate with an Administrator account in the customer's Microsoft 365 tenant. Enter the username for that account and click **Next**.
  </Step>

  <Step title="Enter the password and complete MFA">
    Enter the password and complete any required MFA (multi-factor authentication).

    <Frame>
      <img src="https://mintcdn.com/thread/XL4w2StwzALuT8Pw/images/89622124-2025-12-10-15-50-28.png?fit=max&auto=format&n=XL4w2StwzALuT8Pw&q=85&s=97109f6118740af9fa8863a6db5c6182" alt="Microsoft 365 password and MFA prompt" width="1004" height="773" data-path="images/89622124-2025-12-10-15-50-28.png" />
    </Frame>
  </Step>

  <Step title="Grant permissions for the bot">
    You will be prompted to grant permissions for the bot. Click **Accept**.If this step was successful, you will see a confirmation screen similar to below:

    <Frame>
      <img src="https://mintcdn.com/thread/wn6TrV7GJB-j5H1g/images/ee043f80-2025-12-10-15-50-51.png?fit=max&auto=format&n=wn6TrV7GJB-j5H1g&q=85&s=6233d30f3fa547af7c3f34b9faec3f6e" alt="Prompt to grant permissions for the bot" width="604" height="1404" data-path="images/ee043f80-2025-12-10-15-50-51.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/thread/wn6TrV7GJB-j5H1g/images/d0af102e-2025-12-10-15-51-07.png?fit=max&auto=format&n=wn6TrV7GJB-j5H1g&q=85&s=4092cab643869cbb0c49b9d8205a9c4c" alt="Confirmation screen after granting permissions" width="685" height="733" data-path="images/d0af102e-2025-12-10-15-51-07.png" />
    </Frame>
  </Step>

  <Step title="Open the Teams Admin Center setup policies">
    Navigate to the **Teams Admin Center** ( [https://admin.teams.microsoft.com](https://admin.teams.microsoft.com)) -> Teams apps -> [Setup policies](https://admin.teams.microsoft.com/policies/app-setup).

    <Frame>
      <img src="https://mintcdn.com/thread/XL4w2StwzALuT8Pw/images/5fd3dd9c-image.png?fit=max&auto=format&n=XL4w2StwzALuT8Pw&q=85&s=34f528a11fc7a66c70183a44c3a1f872" alt="Teams Admin Center setup policies page" width="1920" height="1052" data-path="images/5fd3dd9c-image.png" />
    </Frame>
  </Step>

  <Step title="Select the Global (Org-wide default) policy">
    Click **Global (Org-wide default)**. The Global policy will apply to all users in the environment, but if you want to limit who in your customer's environment can use and interact with the application, you can set up your own policy assignment here. Follow our guide on [How to roll out the Teams Service app to specific users](/messenger/how-to-roll-out-the-teams-service-app-to-specific-users) here.

    <Frame>
      <img src="https://mintcdn.com/thread/XL4w2StwzALuT8Pw/images/6f26c536-image.png?fit=max&auto=format&n=XL4w2StwzALuT8Pw&q=85&s=b73e1d876a222bde77ae0a3165693528" alt="Global (Org-wide default) setup policy" width="1540" height="348" data-path="images/6f26c536-image.png" />
    </Frame>
  </Step>

  <Step title="Add the app under Installed apps">
    Under the **Installed apps** section, click the **Add apps** button

    <Frame>
      <img src="https://mintcdn.com/thread/wn6TrV7GJB-j5H1g/images/cdfe1460-image.png?fit=max&auto=format&n=wn6TrV7GJB-j5H1g&q=85&s=3be4ed0871bea98b0400c76de5dbd3a5" alt="Add apps button under the Installed apps section" width="1920" height="1052" data-path="images/cdfe1460-image.png" />
    </Frame>
  </Step>

  <Step title="Find and add the installed app">
    An **Add installed apps** sidebar will appear. Search for the app based on the **Teams app name** you defined when building your custom teams app. **Find the app**, click **Add** and **Add** again at the bottom of the panel.

    <Frame>
      <img src="https://mintcdn.com/thread/XL4w2StwzALuT8Pw/images/9d4a5976-image.png?fit=max&auto=format&n=XL4w2StwzALuT8Pw&q=85&s=890d99148f0d958356fbcff3b5dba381" alt="Add installed apps sidebar searching for the custom Teams app" width="474" height="1039" data-path="images/9d4a5976-image.png" />
    </Frame>
  </Step>

  <Step title="Add the app under Pinned apps">
    Under the **Pinned apps** section, click the **+ Add apps** button.

    <Frame>
      <img src="https://mintcdn.com/thread/XL4w2StwzALuT8Pw/images/6cd33349-image.png?fit=max&auto=format&n=XL4w2StwzALuT8Pw&q=85&s=70d18c0eb016e4211b8c17d541673b1d" alt="Add apps button under the Pinned apps section" width="1583" height="592" data-path="images/6cd33349-image.png" />
    </Frame>
  </Step>

  <Step title="Pin the app and save">
    Search for the app based on the **Teams app name** you defined when building your custom teams app. **Find the app**, click **Add** and **Add** again at the bottom of the panel.You will see the app under Pinned apps. If you want the app to feature prominently in your users Teams, you can move it up or down and click **Save** when done.

    <Frame>
      <img src="https://mintcdn.com/thread/wn6TrV7GJB-j5H1g/images/cc8f36ca-image.png?fit=max&auto=format&n=wn6TrV7GJB-j5H1g&q=85&s=7b64c7dc607ec37a29004be86ee32aa7" alt="Custom app listed under Pinned apps" width="474" height="1035" data-path="images/cc8f36ca-image.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/thread/juCyEL4f0qmxDa7M/images/177198b9-image.png?fit=max&auto=format&n=juCyEL4f0qmxDa7M&q=85&s=67cd9a597533355f5f28e944ab1961f1" alt="Saved pinned app order in the setup policy" width="671" height="693" data-path="images/177198b9-image.png" />
    </Frame>
  </Step>
</Steps>

Congrats you have upgraded your Legacy Teams app in your customer's Microsoft 365 tenant. After a short wait period, your end users are ready to start using Messenger.

<Note>
  It may take time for the app to show up in users' Teams environment, due to Microsoft internal publishing process. Allow up to 24 hours for these changes to complete.
</Note>


## Related topics

- [Cloning a Legacy Teams App](/messenger/cloning-a-legacy-teams-app.md)
- [Webroot Legacy AV](/skill-library/vendor-runbooks/webroot-legacy-av.md)
- [How Notifications Work for your Team](/notifications/how-will-notifications-work-internally.md)
