Components / Actions
Link
stableNavigational text — to another page in the product, or out to an external URL.
External
In context
Read the design tokens before building a new screen.
| Prop | Type | Default | Required | Description |
|---|---|---|---|---|
href | string | — | Yes | Destination — internal path or external URL. |
variant | 'standalone' | 'inline' | 'standalone' | No | standalone has no underline until hover; inline is always underlined. |
muted | boolean | false | No | Uses secondary text colour instead of primary. |
external | boolean | false | No | Forces the external-link treatment even for a relative href. |
Do
- Use inline within a sentence when the link is part of prose.
- Let external links show the outbound-arrow icon automatically — never hide it.
- Write link text that describes the destination ("View invoice"), not "click here."
Don't
- Use a Link where a Button belongs (an action, not a navigation).
- Rely on colour alone — the underline on hover is part of the affordance, not decoration.
- Open an internal link in a new tab.