Skip to content

teams tab list

Lists tabs in the specified Microsoft Teams channel


m365 teams tab list [options]


-i, --teamId <teamId>
The ID of the Microsoft Teams team where the channel is located
-c, --channelId <channelId>
The ID of the channel for which to list tabs
-h, --help [help]
Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is full.
--query [query]
JMESPath query string. See for more information and examples
-o, --output [output]
Output type. json,text,csv. Default json
Runs command with verbose logging
Runs command with debug logging


You can only retrieve tabs for teams of which you are a member.

Tabs Conversations and Files are present in every team and therefore not included in the list of available tabs.


List all tabs in a Microsoft Teams channel

m365 teams tab list --teamId 00000000-0000-0000-0000-000000000000 --channelId

Include all the values from the tab configuration and associated teams app

m365 teams tab list --teamId 00000000-0000-0000-0000-000000000000 --channelId --output json


    "id": "34991fbf-59f4-48d9-b094-b9d64d550e23",
    "displayName": "My Contoso Tab",
    "webUrl": "",
    "configuration": {
      "entityId": "surveys_list:19:B3nCnLKwwCoGDEADyUgQ5kJ5Pkekujyjmwxp7uhQeAE1@thread.tacv2:ps67c9jyf3a30j2j5eum72",
      "contentUrl": "{theme}",
      "removeUrl": "{theme}",
      "websiteUrl": "{theme}",
      "dateAdded": "2022-10-31T12:17:58.632Z"
    "teamsApp": {
      "id": "1542629c-01b3-4a6d-8f76-1938b779e48d",
      "externalId": null,
      "displayName": "My Contoso Tab",
      "distributionMethod": "store"
    "teamsAppTabId": "1542629c-01b3-4a6d-8f76-1938b779e48d"
displayName  : My Contoso Tab
id           : 34991fbf-59f4-48d9-b094-b9d64d550e23
teamsAppTabId: 1542629c-01b3-4a6d-8f76-1938b779e48d
34991fbf-59f4-48d9-b094-b9d64d550e23,My Contoso Tab,1542629c-01b3-4a6d-8f76-1938b779e48d