Text Link

Figma | Storybook

Overview

Text links take users to another place in or outside of the application. Text links act as references or directions to an external or internal resource.

Other names: Link, Anchor, Hyperlink


Behaviors

Focus

A focus state replaces the browser default focus state for text links.

Example of text link focus state.


Visited

Our applications don't use a visited state for text links. Websites use them as a helpful indicator to show when you've already visited a page, but users in applications don't use links as regularly.


Usage guidelines

General use

Text links are commonly used for the following purposes:

  • Navigating to an external or internal page
  • Performing some type of action
  • Directing users to another area in the product or system, like a form field

Content guidelines

Text links need to be clear about where they'll take the user. The link itself should be 3 or fewer words.

👍

Try this

Learn more about Password Management.

❗️

Not this

Click here to learn more.


Text links can be title case when they're standalone and only a few words. Text links should not be capitalized when they're part of a sentence unless they're a proper noun.

👍

Try this

❗️

Not this

  • Contact Your Administrator To Learn More
  • If you'd like help setting up an API account, Read Our Guidelines.

Position

Standalone text links are by themselves, usually directly after a piece of content. Standalone links shouldn't be so long that they wrap.

Inline text links are inside a paragraph or sentence.


Text links with icons

Adding an icon to a text link can help users to understand its purpose. External links can have a “pop-out” icon to show that it will take the user out of the application.

Text link icons are smaller than regular icons (no bigger than 16px by 16px) to match the text they're paired with. Icons are to the right of the text link.


Related

Referenced in this section:

Colors guidelines

Icon component

Tooltip component

Typography guidelines

Components and patterns that use text links:

Breadcrumb component

Data grid component

Toast component