Controls / The visual dictionary

Primary button.

Emphasizes the most important action in the current context.

Also calledmain buttonprimary action
01

See it in context

UI illustration

Primary is a visual priority, not a different browser element. Strong contrast helps people find the next step while the rest of the action group remains less prominent.

When to use it

Give the current task one clear primary action, such as creating the project.

Know the difference

Primary does not mean destructive; destructive actions need a separate warning treatment.

WebiOSiPadOSAndroidmacOSWindowsLinuxwatchOSWear OStvOSAndroid TVvisionOS

Web

Use a native button for an action and an anchor for navigation. Preserve keyboard activation and a visible focus indicator.

iOS · iPadOS · Android

Provide a comfortable touch target, use familiar system symbols when appropriate, and show a clear pressed or selected state.

macOS · Windows · Linux

Keep pointer, keyboard, and focus behavior consistent. Common commands can additionally expose a menu item or keyboard shortcut.

watchOS · Wear OS

On a watch, use a short label and a generous target within the small display. Crown or rotary input can supplement touch for adjustable values.

tvOS · Android TV

On TV, give the focused control a prominent visual state and support remote activation; hover and precise pointer targeting are not assumed.

visionOS

In spatial interfaces, use a comfortably targetable control with a clear focus response for indirect gaze-and-pinch interaction.

Primary documentation for the pattern and its platform conventions.