Microsoft Teams app design system

Quickly learn about the fundamentals of Teams app design. You can find comprehensive guidance and examples in the Microsoft Teams UI Kit (Figma).


Teams relies on a grid layout to ensure consistent and elegant relationships between design components. The grid’s 4-pixel base unit allows components to scale consistently across all display sizes in Teams.

Conceptual image of Teams layout.


An avatar is a graphical representation of a person, team, bot, or entity in Teams. An avatar group is often used to convey live activity or a represent a roster in a way that preserves vertical space.

Conceptual image of Teams avatars.


Your app's primary icon can go a long way in conveying your brand to Teams users. Getting your icon design right is also important for publishing your app to the Microsoft Teams Store.

You also can use Fluent UI icons throughout your app:

Conceptual image of Teams icons.


Teams uses Segoe UI for its type ramp and different font sizes and weights to help create hierarchy and ensure readability.

Conceptual image of Teams typography.


Teams web and desktop supports default (light), dark, and high-contrast themes, while Teams mobile supports light and dark themes. Each theme has its own color scheme.

Concept image of Teams colors.

Shape and elevation

You can use shape and elevation to create additional hierarchy in your app.

Conceptual of shape and elevation.

Copy and content

To feel part of Teams, your app copy in general should follow these Microsoft voice principles: warm and relaxed, crisp and clear, and ready to lend hand.

Conceptual image of copy and content.