Ready

Link

Links are primarily used for simple navigation to another page, or to an anchor within that page. Link text should be brief, and should clearly indicate what the user will be navigating to. A link is typically placed within or following a sentence, but can also be used by itself.

Ready

Link

Links are primarily used for simple navigation to another page, or to an anchor within that page. Link text should be brief, and should clearly indicate what the user will be navigating to. A link is typically placed within or following a sentence, but can also be used by itself.

Ready

Link

Links are primarily used for simple navigation to another page, or to an anchor within that page. Link text should be brief, and should clearly indicate what the user will be navigating to. A link is typically placed within or following a sentence, but can also be used by itself.

Variants

Variants

Variants

  1. Default: Use when a link is in context of, or near a sentence.

  2. Secondary: Use in situations where the link stands alone, or visually needs more differentiation or call out than the underline.

  3. Underline Dotted: Use when you need to display a tooltip on hover, instead of navigating the user away.

  1. Large

  2. Medium

  3. Small

States

States

States

  1. Default

  2. Hover

  3. Disabled

Best Practices

Best Practices

Best Practices

1. Text

Write helpful link text. The link text should describe its purpose and/or destination.²

2. Navigation

Links are use primarily for navigation. If you want a user to take a clickable action or trigger a javascript event use a button.¹ ⁴

3. Style

Use the correct style. Default styled black links should have a black underline and on hover, lose that underline. Secondary blue links should not have an underline by default, but gain one on hover.⁵ These hover states are an accessible way to identify interact-ability, besides the default underline or color.

In tables, when navigating to new pages, use secondary links to add additional emphasis to the link. When opening a modal, default links may be used.

More

More

More

Related Pages

Additional Reading

  1. “Link.” Shopify Polaris, polaris.shopify.com/components/navigation/link.

  2. Patricios, Emma. “Quick Tip: Creating Valid and Accessible Links.” The A11Y Project, a11yproject.com/posts/creating-valid-and-accessible-links/.

  3. “Web Content Accessibility Guidelines (WCAG) 2.0.” W3C, www.w3.org/TR/WCAG20/.

  4. Nils. “Button versus Link - Accessibility Introduction.” Atom, a11y-101.com/design/button-vs-link.

  5. “Web Accessibility Guidelines v1.0 Foundations - Overview.” Buttons & Links | Accessibility Guidelines, web-accessibility.carnegiemuseums.org/content/buttons/.

  6. “Links and HypertextIntroduction to Links and Hypertext.” WebAIM, webaim.org/techniques/hypertext/.

Need more guidance?

Suggest an addition or an edit.

Need more guidance?

Suggest an addition or an edit.

Need more guidance?

Suggest an addition or an edit.

© 2025 Basis Technologies
© 2025 Basis Technologies
© 2025 Basis Technologies