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).

Layout

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.

Avatars

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.

See full avatar guidelines (Figma)

Conceptual image of Teams avatars.

Icons

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.

Type

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.

Colors

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.

See full copy and content guidelines—including writing for bots (Figma)

Conceptual image of copy and content.