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

# How to Add Custom Tabs to Your Microsoft Teams App

> By default, the MSP Process Client Portal Teams app includes several standard tabs. However, there may be times when you want to add additional custom tabs…

By default, the MSP Process Client Portal Teams app includes several standard tabs. However, there may be times when you want to add additional custom tabs so your customers can access external resources, such as a knowledge base, training content, or invoices directly within Microsoft Teams. This guide will walk you through modifying the Teams app package to include these custom tabs.

## Downloading and Extracting the App Package

1. Login to MSP Process ([https://app.mspprocess.com](https://app.mspprocess.com)) as an Admin-level user

2. Navigate to the **AI Service Desk -> Client Portal ->** **Teams Bot Configuration** page

3. ![](https://mintcdn.com/triggr/-njaXAnAb5AWpJCy/images/msp-process-kb/66a903484987.png?fit=max\&auto=format\&n=-njaXAnAb5AWpJCy\&q=85\&s=0c11ebf55d10b299463476f75f7bbfc7)

4. Click the **Get Zip File** button located at the bottom right of the configuration form to download the app package.

5. ![](https://mintcdn.com/triggr/o9r5jEtjdR2oUtiW/images/msp-process-kb/d6baa69de664.gif?s=757c84329c91a068a96081c06290d727)

6. Locate the downloaded zip file on your computer and extract its contents.

7. ![](https://mintcdn.com/triggr/o9r5jEtjdR2oUtiW/images/msp-process-kb/be05482cabcc.png?fit=max\&auto=format\&n=o9r5jEtjdR2oUtiW\&q=85\&s=98cff808f41c13b3cd85ce1a25bd03f3)

8. Open the extracted folder. You will see a simple structure consisting of two image files (icons) and a `manifest.json` file.

9. ![](https://mintcdn.com/triggr/o9r5jEtjdR2oUtiW/images/msp-process-kb/cdb59c02e36a.png?fit=max\&auto=format\&n=o9r5jEtjdR2oUtiW\&q=85\&s=874dc8e69aa6876151aa0ca52adc9a59)

## Modifying the Manifest File

1. Open the `manifest.json` file using a code editor (such as Visual Studio Code) or a standard text editor.

2. ![](https://mintcdn.com/triggr/qgn0c5cLkGKqcauq/images/msp-process-kb/88dc4877413e.png?fit=max\&auto=format\&n=qgn0c5cLkGKqcauq\&q=85\&s=38497c11a8c0a3c48fc6d88ea0ef07fd)

3. Scroll through the JSON structure to locate the section named `staticTabs`.

4. ![](https://mintcdn.com/triggr/-njaXAnAb5AWpJCy/images/msp-process-kb/6d02a06459e3.png?fit=max\&auto=format\&n=-njaXAnAb5AWpJCy\&q=85\&s=96e1de186baa28b1bcbbfd013042bdcd)

5. Select the entire JSON object representing the first tab (from the opening curly brace to the closing curly brace) and copy it.

6. ![](https://mintcdn.com/triggr/-njaXAnAb5AWpJCy/images/msp-process-kb/76ffb29dd7a9.gif?s=c41e093e6e11a9266c64d3e0ed6428d8)

7. Add a comma at the end of the first object, then paste the copied JSON object directly below it.

8. ![](https://mintcdn.com/triggr/o9r5jEtjdR2oUtiW/images/msp-process-kb/b54a2015ae49.gif?s=1266f4d72605724ba125007a29f7a5aa)

9. Customize the newly pasted tab object for your external resource by updating the **contentUrl** to the URL of the website or resource you want to display.

10. ![](https://mintcdn.com/triggr/qgn0c5cLkGKqcauq/images/msp-process-kb/87abdf0fa8fd.png?fit=max\&auto=format\&n=qgn0c5cLkGKqcauq\&q=85\&s=bcf08fb193da548b195e83a5adaa8b5b)

11. Update the **name** value to the title you want displayed at the top of the tab in Teams.

12. Update the **entityId** to a unique internal reference name for the tab.

13. Save your changes to the `manifest.json` file.

## Repackaging and Deploying the App

1. In your file explorer, select the modified `manifest.json` file along with the two original icon files.

2. Right-click the selected files and choose **Compress** (or your operating system's equivalent) to create a new zip file.

3. ![](https://mintcdn.com/triggr/-njaXAnAb5AWpJCy/images/msp-process-kb/74925d8bc041.webp?fit=max\&auto=format\&n=-njaXAnAb5AWpJCy\&q=85\&s=0498046af54a014b9dc7fea58cbacf68)

4. Upload this newly created zip file to your Teams environment for testing, or deploy it to your customer's Teams environment for production use.

Once deployed, the Teams app will display both the standard MSP Process tabs and your newly added custom tabs, allowing you to present whatever content you need directly to your customers.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.