# (link: …)

Creates a link

****

- Source: <https://github.com/getkirby/kirby/tree/5.5.3/config/tags.php#L194>

****

## Attributes

In addition to the main `link` option, the tag supports the following attributes: `class`, `lang`, `rel`, `role`, `target`, `title`, `text`

| Attribute | Description | Default |
|---- | ---- | ---- |
| class | The class which is added to link element | `null` |
| lang | The language for link to a page in another language (only on multi-language sites) | `null` |
| rel | The rel attribute that is added to link element | `null` |
| role | The role attribute that is added to link element | `null` |
| target | The target attribute that is added to link element | `null` |
| title | The title attribute that is added to link element | `null` |
| text | The text that is added to link element | `null` |

### Attribute defaults from config

You can customize the defaults of this tag's attributes via the <a href="https://getkirby.com/docs/reference/system/options/kirbytext#link">`kirbytext.link` config option</a>.

## Examples

### Link with link text

```kirbytext
(link: http://wikipedia.org text: Wikipedia)
```

### Relative link

```kirbytext
(link: some/page text: Link to some internal page)
```

### Link to page in a specific language

```kirbytext
(link: some/page lang: de)
```

### Link to an anchor

```kirbytext
(link: #some-section text: Link to some section on the same page)
```

### Specifying the target for the link

```kirbytext
(link: http://wikipedia.org text: Wikipedia target: _blank)
```

### Link with a `title` attribute

```kirbytext
(link: http://wikipedia.org text: Wikipedia title: Go to Wikipedia)
```

### Link with a `rel` attribute

```kirbytext
(link: http://yourdomain.com text: My website rel: me)
```

### Link with a custom CSS class

```kirbytext
(link: http://wikipedia.org text: Wikipedia class: mylink)
```

### Link to a page in another language (only on multi-language sites)

```kirbytext
(link: some/page text: Some page in German lang: de)
```

### Link with a `role` attribute

```kirbytext
(link: delete-account text: Delete my account role: button)
```