Skip to content

[Doc Improvement][Tab Revamp][3668160] #11904

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 114 commits into
base: main
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
114 commits
Select commit Hold shift + click to select a range
7657534
tab revamp
v-shalinir Dec 9, 2024
9515c06
Update what-are-tabs.md
v-shalinir Dec 9, 2024
d4d0073
updates
v-shalinir Dec 9, 2024
9070713
Update TOC.yml
v-shalinir Dec 9, 2024
b2fddbf
Update TOC.yml
v-shalinir Dec 9, 2024
9feb4d5
Update TOC.yml
v-shalinir Dec 9, 2024
74de662
Update TOC.yml
v-shalinir Dec 9, 2024
8fb84d3
Updates
v-shalinir Dec 9, 2024
24f512e
Update create-personal-tab.md
v-shalinir Dec 9, 2024
f367f3d
Update create-personal-tab.md
v-shalinir Dec 9, 2024
be693fe
Update what-are-tabs.md
v-shalinir Dec 9, 2024
92acf07
Merge branch 'main' into tab-revamp
v-shalinir Dec 12, 2024
98c92dd
Update TOC.yml
v-shalinir Dec 12, 2024
6cf5e9a
Update access-teams-context.md
v-shalinir Dec 18, 2024
a799f3c
Merge branch 'main' into tab-revamp
v-shalinir Dec 18, 2024
967e7d2
Merge branch 'main' into tab-revamp
v-shalinir Dec 20, 2024
bd283c5
Merge branch 'main' into tab-revamp
v-shalinir Jan 2, 2025
9505353
added folder for tab revamp and files in it
v-shalinir Jan 3, 2025
0e21c4a
Update create-a-tab-app.md
v-shalinir Jan 3, 2025
f3f4167
Update create-a-tab-app.md
v-shalinir Jan 6, 2025
e9cc9e8
Update create-a-tab-app.md
v-shalinir Jan 6, 2025
89d1c3c
Update create-a-tab-app.md
v-shalinir Jan 6, 2025
bb38450
Update create-a-tab-app.md
v-shalinir Jan 6, 2025
cda3777
Merge branch 'main' into tab-revamp
v-shalinir Jan 6, 2025
b116a73
updates
v-shalinir Jan 6, 2025
9c2cf13
Update create-a-tab-app.md
v-shalinir Jan 6, 2025
f084eb9
Merge branch 'main' into tab-revamp
v-shalinir Jan 7, 2025
54b2da2
Update tab-features.md
v-shalinir Jan 7, 2025
12d16dc
Update TOC.yml
v-shalinir Jan 7, 2025
53837d0
Update tab-features.md
v-shalinir Jan 7, 2025
426b373
Update TOC.yml
v-shalinir Jan 7, 2025
22fe03b
Update TOC.yml
v-shalinir Jan 7, 2025
eaf9105
Update TOC.yml
v-shalinir Jan 7, 2025
6d1d1ae
Update TOC.yml
v-shalinir Jan 7, 2025
f35bb21
Merge branch 'main' into tab-revamp
v-shalinir Feb 11, 2025
0253a51
Update TOC.yml
v-shalinir Feb 11, 2025
cad2011
Merge branch 'main' into tab-revamp
v-shalinir Feb 20, 2025
5c22d7d
Merge branch 'main' into tab-revamp
v-shalinir Feb 24, 2025
feb036a
Update what-are-tabs.md
v-shalinir Feb 24, 2025
ba5d266
Update what-are-tabs.md
v-shalinir Feb 24, 2025
ecbf236
Update what-are-tabs.md
v-shalinir Feb 24, 2025
dc64cc1
Update what-are-tabs.md
v-shalinir Feb 24, 2025
3705c82
Update what-are-tabs.md
v-shalinir Feb 24, 2025
584d417
Update what-are-tabs.md
v-shalinir Feb 24, 2025
ab9318d
Merge branch 'main' into tab-revamp
v-shalinir Feb 25, 2025
acdf300
Merge branch 'main' into tab-revamp
v-shalinir Feb 27, 2025
ec8dcb3
Update what-are-tabs.md
v-shalinir Feb 27, 2025
fae1a17
Update what-are-tabs.md
v-shalinir Feb 27, 2025
01abdc0
Update what-are-tabs.md
v-shalinir Feb 27, 2025
16d0bfb
Update what-are-tabs.md
v-shalinir Feb 27, 2025
1ced337
Update what-are-tabs.md
v-shalinir Feb 27, 2025
1f955d4
Update what-are-tabs.md
v-shalinir Feb 27, 2025
c3fecf3
Update create-personal-tab.md
v-shalinir Feb 27, 2025
e6beead
Update what-are-tabs.md
v-shalinir Feb 27, 2025
b93cee8
Update what-are-tabs.md
v-shalinir Feb 27, 2025
7c42aed
Update tab-requirements.md
v-shalinir Feb 27, 2025
d807aff
Update TOC.yml
v-shalinir Feb 27, 2025
d4497de
Update tab-requirements.md
v-shalinir Feb 27, 2025
778d904
Updates
v-shalinir Feb 27, 2025
2d51ceb
Update what-are-tabs.md
v-shalinir Feb 27, 2025
4e04f42
Update what-are-tabs.md
v-shalinir Feb 27, 2025
3067adc
Update what-are-tabs.md
v-shalinir Feb 27, 2025
29a018e
Update what-are-tabs.md
v-shalinir Feb 28, 2025
7121544
Updates
v-shalinir Feb 28, 2025
97e3c55
Updates
v-shalinir Feb 28, 2025
d7f2244
Update what-are-tabs.md
v-shalinir Feb 28, 2025
45291e7
Update what-are-tabs.md
v-shalinir Feb 28, 2025
228d79b
Update what-are-tabs.md
v-shalinir Feb 28, 2025
8aada5c
Update what-are-tabs.md
v-shalinir Feb 28, 2025
4d3313c
Update what-are-tabs.md
v-shalinir Feb 28, 2025
670b27f
Update what-are-tabs.md
v-shalinir Feb 28, 2025
4c03351
Update what-are-tabs.md
v-shalinir Feb 28, 2025
2a53b83
Update what-are-tabs.md
v-shalinir Feb 28, 2025
30dd0e7
Update what-are-tabs.md
v-shalinir Feb 28, 2025
f27ce64
Update what-are-tabs.md
v-shalinir Feb 28, 2025
4b1d106
Merge branch 'main' into tab-revamp
v-shalinir Mar 4, 2025
2f80342
Update what-are-tabs.md
v-shalinir Mar 4, 2025
569cb35
Update what-are-tabs.md
v-shalinir Mar 4, 2025
b86147b
Update what-are-tabs.md
v-shalinir Mar 4, 2025
1bd6ebe
Update what-are-tabs.md
v-shalinir Mar 4, 2025
85456f7
Update what-are-tabs.md
v-shalinir Mar 4, 2025
fa500fd
Update what-are-tabs.md
v-shalinir Mar 4, 2025
d209041
Update what-are-tabs.md
v-shalinir Mar 4, 2025
28abadd
Update what-are-tabs.md
v-shalinir Mar 4, 2025
cab43c3
Update TOC.yml
v-shalinir Mar 5, 2025
b8adc24
Update TOC.yml
v-shalinir Mar 5, 2025
6badd06
images tested
v-shalinir Mar 5, 2025
94e1d1e
Update tab-features.md
v-shalinir Mar 5, 2025
a8fb511
image updated
v-shalinir Mar 5, 2025
8f42386
Images updated
v-shalinir Mar 5, 2025
bb01dac
Update create-personal-tab.md
v-shalinir Mar 6, 2025
0f0ed92
Update tab-features.md
v-shalinir Mar 6, 2025
1c773aa
Merge branch 'main' into tab-revamp
v-shalinir Mar 10, 2025
2d3f1de
Update TOC.yml
v-shalinir Mar 10, 2025
c648abf
Update create-a-tab-app.md
v-shalinir Mar 10, 2025
30a3bb0
Updates
v-shalinir Mar 10, 2025
cef652c
Update create-a-tab-app.md
v-shalinir Mar 10, 2025
f7e96ab
Updates
v-shalinir Mar 10, 2025
84f895f
Update create-personal-tab.md
v-shalinir Mar 10, 2025
a96ac5b
Update whats-new.md
v-shalinir Mar 10, 2025
b2c7eb2
Update create-personal-tab.md
v-shalinir Mar 10, 2025
d1b707c
Updates
v-shalinir Mar 10, 2025
7157f06
Merge branch 'main' into tab-revamp
v-shalinir Mar 19, 2025
c9f4dc5
Update whats-new.md
v-shalinir Mar 19, 2025
8c33bbe
links updates
v-shalinir Mar 19, 2025
0e8b1c9
links fixes
v-shalinir Mar 19, 2025
78f4d1e
Update what-are-tabs.md
v-shalinir Mar 19, 2025
d84d561
Update what-are-tabs.md
v-shalinir Mar 19, 2025
07f1cea
Update what-are-tabs.md
v-shalinir Mar 19, 2025
5f9b6dc
Update what-are-tabs.md
v-shalinir Mar 20, 2025
37753f4
Merge branch 'main' into tab-revamp
v-shalinir Mar 24, 2025
9cb9015
example workflow
v-shalinir Mar 24, 2025
e36017e
Update what-are-tabs.md
v-shalinir Mar 24, 2025
af1632d
Update tab-tools-user-story.png
v-shalinir Mar 24, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .vscode/settings.json
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@
"blazorapp",
"botid",
"Chatbots",
"Codespaces",
"commandbot",
"Contoso",
"debugcheck",
Expand Down
49 changes: 49 additions & 0 deletions msteams-platform/TOC.yml
Original file line number Diff line number Diff line change
Expand Up @@ -378,6 +378,55 @@
displayName: loop
- name: Action extensions
href: resources/messaging-extension-v3/create-extensions.md
- name: Build tabs-revamp
items:
- name: Overview
href: tabs/what-are-tabs.md
displayName: Webpages embedded in Teams, declare custom tab in app manifest, contentUrl, web apps, device permissions for tabs, clickjacking, device permissions for tabs
- name: Prerequisites
href: tabs/how-to/tab-requirements.md
displayName: clickjacking, device permissions for tabs
- name: Create a tab app
href: tabs/how-to/create-a-tab-app.md
- name: Tab features
href: tabs/how-to/tab-features.md
- name: Advanced tab features
items:
- name: Build a tab app
href: tabs/how-to/create-personal-tab.md
displayName: App generator, Reorder static personal tabs, channel, or group custom tab, offline tab
- name: Open content in stage view
href: tabs/open-content-in-stageview.md
displayName: Tab in Stageview, Collaborative Stageview, Stageview Multi-window, Stageview Modal, Teams multiwindow
- name: Create a content page
href: tabs/how-to/create-tab-pages/content-page.md
displayName: Loading indicator, showLoadingIndicator, personal-scoped custom tab, channel or group custom tab
- name: Create a configuration page
href: tabs/how-to/create-tab-pages/configuration-page.md
displayName: configurationUrl
- name: Tabs on mobile
href: tabs/design/tabs-mobile.md
displayName: Teams Store apps approved by Microsoft for mobile
- name: Build apps for shared channels
href: concepts/build-and-test/shared-channels.md
displayName: Cross-tenant notifications, context for shared channel, apps and permissions in shared channels
- name: Send activity feed notifications
href: /graph/teams-send-activityfeednotifications
displayName: activity feed, notification, customize notification
- name: App caching for your tab app
href: tabs/how-to/app-caching.md
displayName: App caching, caching, launch time, cache
- name: Legacy tab features
items:
- name: Create a configurable tab
href: tabs/how-to/create-channel-group-tab.md
displayName: Create a channel tab or group tab, Create a custom channel or group tab with ASP.NET Core, Build your first app using Blazor
- name: Create a removal page
href: tabs/how-to/create-tab-pages/removal-page.md
displayName: Reconfigure tab, register remove handler
- name: Build a dashboard tab app
href: tabs/how-to/Build-a-dashboard-tab-app.md
displayName: Dashboard, widget, Graph API call
- name: Build tabs
items:
- name: Tabs overview
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ It’s common for an app to support multiple scenarios in Microsoft Teams, but y

When a user installs an app from Microsoft Teams Store or uploads a custom app, the user has the option to open the app in either personal or shared scope:

* Personal scope: If an app supports personal scope, the **Open** option in the scope selection dialog allows to open the app in personal scope.
* Personal scope: If an app supports personal scope, the **Open** option in the scope selection dialog allows to open the app in personal scope.

* Shared scope: If an app supports shared scopes, all the supported scopes such as channel, chat, and meeting are listed to select the required scope. If your app is configured with a default install scope, a **Recommended** label appears adjacent to the respective scope.

Expand Down Expand Up @@ -316,7 +316,7 @@ The following example demonstrates opening an app with tab as default landing ca

---

The `staticTabs` property is also used to pin personal tabs and [reorder tabs](../../tabs/how-to/create-personal-tab.md#reorder-tabs). For more information, see [app manifest](../../resources/schema/manifest-schema.md#statictabs).
The `staticTabs` property is also used to pin personal tabs and [reorder tabs](../../tabs/how-to/tab-features.md#reorder-tabs). For more information, see [app manifest](../../resources/schema/manifest-schema.md#statictabs).

## Block apps by default for users until an admin approves

Expand All @@ -341,7 +341,6 @@ If you don't want your app to be blocked by default, update the `defaultBlockUnt
|----------------|-----------------|--------------|----------------|-----------|-----------|
| Hello world | This sample demonstrates how to configure default landing capability for an app that supports both bot and tab capabilities in personal scope. | [View](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/app-hello-world/csharp) | [View](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/app-hello-world/nodejs) | [View](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/app-hello-world/csharp/demo-manifest/app-hello-world.zip)|


## Next step

> [!div class="nextstepaction"]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -586,7 +586,7 @@ The object is an array with all elements of the type `object`. This block is req

**Optional** – Array

Defines a set of tabs that can be pinned by default, without the user adding them manually. Static tabs declared in `personal` scope are always pinned to the app's personal experience. However, the pinned tabs can be reordered by adding the details of the tab in the same desired order. For more information, see [reorder static personal tabs](../../tabs/how-to/create-personal-tab.md#reorder-tabs).
Defines a set of tabs that can be pinned by default, without the user adding them manually. Static tabs declared in `personal` scope are always pinned to the app's personal experience. However, the pinned tabs can be reordered by adding the details of the tab in the same desired order. For more information, see [reorder static personal tabs](../../tabs/how-to/tab-features.md#reorder-tabs).

This property also enables you to set the default landing capability for an app supporting both tab and bot capabilities in personal scope. For more information, see [configure default landing capability](../../concepts/deploy-and-publish/add-default-install-scope.md#configure-your-apps-default-landing-capability).

Expand Down
2 changes: 1 addition & 1 deletion msteams-platform/resources/schema/manifest-schema.md
Original file line number Diff line number Diff line change
Expand Up @@ -595,7 +595,7 @@ Used when your app experience has a team channel tab experience that requires ex

**Optional** – Array

Defines a set of tabs that can be pinned by default, without the user adding them manually. Static tabs declared in `personal` scope are always pinned to the app's personal experience. However, the pinned tabs can be reordered by adding the details of the tab in the same desired order. For more information, see [reorder static personal tabs](../../tabs/how-to/create-personal-tab.md#reorder-tabs).
Defines a set of tabs that can be pinned by default, without the user adding them manually. Static tabs declared in `personal` scope are always pinned to the app's personal experience. However, the pinned tabs can be reordered by adding the details of the tab in the same desired order. For more information, see [reorder static personal tabs](../../tabs/how-to/tab-features.md#reorder-tabs).

This property also enables you to set the default landing capability for an app supporting both tab and bot capabilities in personal scope. For more information, see [configure default landing capability](../../concepts/deploy-and-publish/add-default-install-scope.md#configure-your-apps-default-landing-capability).

Expand Down
Loading