---
title: Link
description: >-
  Link makes text interactive so customers can perform an action, such as
  navigating to another location.
api_version: 2025-07
api_name: checkout-ui-extensions
source_url:
  html: >-
    https://shopify.dev/docs/api/checkout-ui-extensions/2025-07/components/actions/link
  md: >-
    https://shopify.dev/docs/api/checkout-ui-extensions/2025-07/components/actions/link.md
---

# Link

Link makes text interactive so customers can perform an action, such as navigating to another location.

## LinkProps

* accessibilityLabel

  string

  A label used for buyers using assistive technologies. When set, any `children` supplied to this component will not be announced to screen reader users.

* activateAction

  'auto' | 'copy'

  Default: 'auto' - a default action for the target component.

  Sets the action the `activateTarget` should take when this pressable is activated.

  Supported actions by component:

  | Component | Supported Actions | Default ('auto') |
  | - | - | - |
  | [`ClipboardItem`](https://shopify.dev/docs/api/checkout-ui-extensions/latest/clipboarditem) | 'copy' | 'copy' |

* activateTarget

  string

  ID of a component that should respond to activations (e.g. clicks) on this pressable.

  See `activateAction` for how to control the behavior of the target.

* appearance

  Extract\<Appearance, 'monochrome'>

  Specify the color of the link. `monochrome` will take the color of its parent.

* external

  boolean

  Open the link in a new window or tab. If the link points to a domain other than your Storefront, it will always open in a new tab.

* id

  string

  Unique identifier.

  Typically used as a target for another component’s controls to associate an accessible label with an action.

* language

  string

  Indicate the text language. Useful when the text is in a different language than the rest of the page. It will allow assistive technologies such as screen readers to invoke the correct pronunciation. [Reference of values](https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry) ("subtag" label)

* onPress

  () => void

  Callback when pressed. If `to` is set, it will execute the callback and then navigate to the location specified by `to`.

* overlay

  RemoteFragment

  An overlay component to render when the user interacts with the component.

* to

  string

  Destination to navigate to. You must provide either this property, `onPress`, or both.

* toggles

  string

  The component's identifier whose visibility will be toggled when this component is actioned.

### Appearance

```ts
'base' | 'accent' | 'decorative' | 'interactive' | 'subdued' | 'info' | 'success' | 'warning' | 'critical' | 'monochrome'
```

### Examples

* #### Basic Link

  ##### React

  ```tsx
  import {
    reactExtension,
    Link,
  } from '@shopify/ui-extensions-react/checkout';

  export default reactExtension(
    'purchase.checkout.block.render',
    () => <Extension />,
  );

  function Extension() {
    return (
      <Link to="https://www.shopify.ca/climate/sustainability-fund">
        Sustainability fund
      </Link>
    );
  }
  ```

  ##### JS

  ```js
  import {extension, Link} from '@shopify/ui-extensions/checkout';

  export default extension('purchase.checkout.block.render', (root) => {
    const link = root.createComponent(
      Link,
      {to: 'https://www.shopify.ca/climate/sustainability-fund'},
      'Sustainability fund',
    );

    root.appendChild(link);
  });
  ```

## Preview

![](https://shopify.dev/images/templated-apis-screenshots/checkout-ui-extensions/2025-07/link-default.png)

## Appearance

| Value | Description |
| - | - |
| `"monochrome"` | Takes the color of its parent. |

## Best Practices

* If the link isn’t in a paragraph, then consider using a plain button instead for a larger hit area.

* Use links primarily for navigation and use buttons primarily for actions.

* The HTML that renders for the Button and `Link` components includes style and accessibility information. Use these components intentionally and consistently to provide a more inclusive experience for assistive technology users and a more cohesive visual experience for sighted users.

## Related

[Component - Button](button)