# Link

A link navigates users to other pages or sections of content.


## Overview

### Usage

Use links for navigation whether it’s within the same page, across pages, or to external sites. A good link is easy to recognize, descriptive, and accessible. It should clearly communicate where it will take the user, even when read out of context (for example, by a screen reader). Avoid using links for actions such as submitting forms or opening modals use buttons instead.

### Variants

#### Leading icon

Use when an icon helps reinforce the meaning of the link (e.g., a document or download icon before the text).

#### Trailing icon

Use for links that lead to another page or outside the current application, such as external websites.

#### Text decoration

Used when a stronger visual indication is needed for example, in long bodies of text or when links need to stand out clearly from surrounding content.

### Do’s and don’ts


## UX Guidelines

### Writing UX text for links

### Only include necessary words

### Placing links

### Links within text

### Link outside of the text

### Links before a form component

### Add items to a list
