Skip to main content Skip to navigation Skip to search

Buttons allow an application to communicate action and direct user intent.


Clarity comes with three different types of buttons to use. They are provided to give visual distinction between the priority or heirarchy of the buttons in the application.

Solid buttons look heavy on purpose. They direct the user’s attention to the primary action the application is suggesting that the user take.

Outline buttons provide a lighter weight button style. They are used to indicate a secondary action that compliments a primary action or to reduce visual noise when there are many action of equal importance on the page.

Flat buttons are used in multiple scenarios. They are used as tertiary buttons. They can also be used inline because they are different from content in style and recognizable as buttons alongside content.

While buttons and links can both be given similar visual treatments, it is important that you use a link (or anchor element) for anytime clicking the element will navigate you to a different page. Buttons are for interaction in the current page, such as refreshing the content or submitting a form.

Use flat buttons when a user is expected to **take an action**.
Use a link when a user is expected to be **taken to a different page**.


There are two distinct patterns when it comes to the placement of a button.

Z Pattern illustration

Z Pattern

The Z-pattern is a natural way for the user to go through content within a constrained container and when tasks are oriented from the top-left and ending with a primary call to action on the right bottom side of the container. This pattern is reversed for right to left languages.

Modals and Wizards follow the Z Pattern
F Pattern illustration

F Pattern

The F-pattern is a natural way to go through content in an unconstrained container, such as a form on the page itself. The user will go through the content line-by-line, arriving at a call to action at the end.

Forms and Cards follow the F Pattern


Consistent button styles make it easier for a user to recognize areas to take action across an application.


The text inside of buttons is always uppercase. This indicates action by differentiating button text from links and other content on the page. Use descriptive language on buttons relating to the user’s intent.

Typography Don't Example
Use generic language not related to the action and not relating to the intent of the user.
Typography Do Example
Use a call to action on buttons.

Visual Style

Clarity buttons have several distinct properties and design considerations.

Border Radius

Clarity buttons have a border radius of 3px.


Clarity offers two button sizes:

  • Default height of 36px
  • Compact height of 24px

Compact is used in content areas where smaller buttons are needed to de-emphasize calls to action. This is especially true when multiple actions of equal importance are available.

Visualization of button sizes

Primary Color

A primary color provides consistency across an application. It trains the user to look for that color when trying to find an action. Clarity defaults to blue. This “action blue” can be found across all types of buttons, tabs, and other action-related components.

Action-based Color

Different colors may be used based on the severity of an action’s result. For example, using a red button when “deleting” files indicates high severity.

Visualization of button colors


Icon buttons are useful where interface space may be limited. If an icon represents the action well, users can sometimes recognize them quicker than reading text. Lastly, using icon buttons can help in the situation where the use of long labels may be challenging.

We recommend you choose an icon that best describes the action that the user will be doing. Users may avoid unknown or abstract icon buttons.

Types & Sizes

Icon buttons are available in the solid, outline, and flat types. It’s also best to use the normal (36px) sized ones. This makes them easier to recognize and to click.
Use small icon buttons in most cases. They are difficult to see and distinguish what the icon is or represents. They also create smaller click targets, making them harder to click.

With Text

Create Delete
If you have the space, adding text helps users understand the action. Start icon buttons with icons and follow with text.
Create Delete
Start icon buttons with text and follow with icon. This makes them more difficult to scan quickly.

Title Attribute

If your icon button is has no text, we recommend adding the title=" attribute to your icon buttons. This adds some additional context for users unfamiliar with what action your icon button might produce. Hovering over the icon button for a moment will show a tooltip that has the title text. The text should reflect the action being completed.

Visualization of button title attributes

Code & Examples

Solid Buttons


Flat Buttons

Types: Primary,Secondary and Tertiary

States: Info, Success and Danger Outline Buttons

Sizes: Normal, Small, Normal Flat, Small Flat



Normal Flat

Small Flat





Use the clrLoading directive to change the state of the spinner button. The directive can be set to one of the following values:

  • ClrLoadingState.DEFAULT: the default state of the button.
  • ClrLoadingState.LOADING: replaces the button text with a spinner.
  • ClrLoadingState.SUCCESS: briefly shows a check mark, and automatically transition back to the ClrLoadingState.DEFAULT state.