Links

Links are used to navigate users to another location.

 

Component checklist

Status

The status of the component

Ready for use!

Figma component

A link to the Figma library where the component lives.

Anatomy

Two images, one showing a link text + icon, the second showing an inline link text alone
  1. Link text: describes what is being linked to.
  2. Icon: Provides additional context about the destination or linked resource. Use the external-link icon when the link navigates to an external destination. Both inline and standalone links can navigate to external destinations. When they do, use the external-link icon. For inline links, enable the External property. For standalone links, other icons may be used to communicate different resource types.

Inline links should be used within a body of text whereas standalone links should exist on their own or placed right after the content block.

 

Do

Open in the current tab when:

  • Internal navigation
  • Moving between pages within the product
  • Most external links
Do

Open in a new tab when:

  • External documentation users may want to reference while continuing their task
  • Downloads
  • Links that would interrupt an in-progress workflow
Don't

Don't open links in a new tab without a clear reason.

 


Frame 2609254

 

Do
  • Should be used within the flow of text.
  • Helps provide context and additional information.
  • Best suited for quick references or supplementary details.
  • Only pair with an icon if it's leading to an external page.
  • Should always be styled with an underline.
Don't
  • Do not use them on their own.

 

context-menu

 

Do
  • Can be used on their own or directly following content.
  • Ideal for navigating to external resources but not only.
  • Use them within tables.
  • Should be paired with an icon - end to better communicate the place of the resource.
  • Use the external-link icon when linking to an external destination
Don't
  • Do not style with an underline (only the hover state uses an underline).
  • Do not place it within a block of text.

 

Best Practices

Inline links are usually placed within a paragraph. Consider using fewer links within a single sentence to reduce cognitive load.

Do
A terms and conditions popover with one inline link within the body

Add one meaningful link to a sentence.

Don't
A terms and conditions popover with three inline links within the body

Avoid overcrowding one sentence with multiple links.

 

The breadcrumbs component uses standalone links as sub-components. Since breadcrumb links navigate within the current product, they should not display the external-link icon.

Do
Grandchild-level breadcrumb links

Use breadcrumbs as they come, with standalone links that have the icon-end hidden.

Don't
Grandchild-level breadcrumb links, each with icons.

Don't pair standalone links within breadcrumbs with icons.

 

 

Buttons should be used for initiating a specific action such as submit, configure settings, etc. whereas links should be used to navigate to a new section or page or for providing additional information.

Do

 

 

Links are used for navigation. Inline buttons are used to trigger lightweight actions without taking users away from their current context. Links and inline buttons may look similar, but they are not interchangeable. In code, links (<a>) navigate users to another location, while inline buttons (<button>) perform actions on the current page. Always choose the component based on its purpose, not its appearance.

Frame 2609275

Opening a Modal

Use an inline button when opening a modal or other in-context interface. Unlike links, which navigate users to another destination, inline buttons trigger actions while keeping users in the same context. This provides clearer interaction expectations and improves accessibility.

 


 

Common Use Cases

User Goal

Component

User Expectations

Navigate to another page within the application

Link

"Take me somewhere"

Navigate to an external website or system

Link

"Take me somewhere"

Open supporting documentation

Link

"Take me somewhere"

Open another application, product, or external system

Link

"Take me somewhere"

Open a modal, drawer, or side sheet, dropdown

In-line Button

"Show something here"

Copy content

In-line Button

“Perform an action”

Retry an action

In-line Button

“Perform an action”

Expand, reveal, or update content in place

In-line Button

“Change something here”

Trigger a workflow without leaving the current page

In-line Button

“Perform an action”

Open contextual details without changing pages

In-line Button

“Show something here”

Show additional information inline ("View details", "Show more")

In-line Button

“Reveal something here”

Open a confirmation dialog

In-line Button

“Confirm an action here”