Tab margin changes

This document describes how the removal of margins around all tabs in Microsoft Teams enhances your app building experience. This is an enhancement introduced in Teams in 2021. You can build apps that look more native to Teams by removing the margins around all tabs. Tabs with removed margins align with Microsoft Teams' UI kit designs. Most apps experience enhanced look without margins.

Tab wit and without margins


This feature is not applicable to mobile clients, as the tabs viewed in the mobile clients don't have margins.


Tab margins removal affects your Teams apps that use tabs. In such cases, you can add margins around your tab designs where it's required. App designs in production have an extra padding effect, that is, margins provided by Teams and margins provided by the tab. However, the extra padding is only temporary and goes away in a few weeks, leaving only the app's provided padding.


Is it OK for app chrome, such as header bar or taskbar, to touch the edges of our designs?

Yes, this is fine and Teams encourages such design. It helps the app to feel native.

Is it OK for app content, such as text, logos, and images, to touch the left and right edges of our designs?

No, you must provide your own padding or margins to the left and right of all app content to ensure that it doesn't touch the edges of your UI. You can also add margins at the top of your tab, if necessary.

What's the size of the tab margins that Teams applied previously?

  • Left and right: 20 pixels
  • Top: 16 pixels
  • Bottom: 0 pixels


  • All tabs have their margins removed: personal tabs, (group) chat tabs, meeting tabs, and channel tabs.
  • The tab margin removal change applies to all tabs. There is no way to opt-in or opt-out of the change.
  • Tab margins' change can affect tabs that rely on Microsoft Teams to provide margins surrounding their UI.

See also