# Core/Link - Design

Links are navigational elements that take users to a new page.

## Properties

### Text

The text representing the link should describe its destination.

### isExternal

External links display an icon at the trailing end of the link. They navigate to a page outside the product and open
in a new tab.

### Client-side Routing

Links support client-side routing out of the box when Capra's `RouterProvider` is used. See the
[Conventions](/docs/conventions--docs#client-side-routing) page for more details.

## Best Practices

**Do**

<p>
  Do clearly indicate the destination of a link through its text.
</p>

**Don't**

<p>
  Don't use vague instructions, such as “click here”, for links.
</p>

## Accessibility

### Keyboard interaction

All links exist in the page's natural tab sequence, reachable via TAB and SHIFT+TAB keys. Pressing ENTER activates
the focused link.

### External links

External links should announce themselves as opening in a new tab. For example: "Link text, opens in a new tab."

### Keyboard focus indicator

Links inherit the standard focus indicator standard to all focusable elements.

## Accessibility

* Meaningful link text: describe the destination, not "click here" or "read more".
* External links: announce the new-tab behavior in the link text or `aria-label` (e.g., "Opens in new tab").

## Related components

* [Button](?path=/docs/core-button--design)
* [Anchor](?path=/docs/core-anchor--design)