# Link

import Screenshots from '@site/src/components/Screenshots';

The link field allows you to insert or edit a link, which includes a URL, optional title text, an option to open the link in a new tab. You can also select an existing content (post, page, etc.).

## Screenshots

<Screenshots name="link" col1={[
    ['/screenshots/link.png', 'The link field interface']
]} />

## Settings

This field has no additional settings besides the [common settings](https://docs.metabox.io/field-settings/).

This is a sample field settings array when creating this field with code:

```
[
    'name' => 'Social Links',
    'id'   => 'social_links',
    // highlight-next-line
    'type' => 'link',
],
```

## Data

This field saves the value as a serialized array in the database with the following keys:

* `url`: The URL of the link.
* `title`: The link title text.
* `target`: The link target (empty or `_blank`).
* `post_id`: The selected post ID (optional). This is useful when you want to get more details of a selected post.

Example:

```
[
    'url'    => 'https://metabox.io',
    'title'  => 'Meta Box',
    'target' => '_blank',
]
```

If the field is cloneable, then the value is stored as a serialized array in a single row in the database.

## Template usage

**Displaying the link in an `<a>` tag:**

```php
<p>Entered: <?php rwmb_the_value( 'my_field_id' ) ?></p>
```

**Displaying cloneable values:**

```php
<?php $values = rwmb_meta( 'my_field_id' ) ?>
<?php foreach ( $values as $value ) : ?>
    <a href="<?= $value['url'] ?>" target="<?= $value['target'] ?>"><?= $value['title'] ?></a>
<?php endforeach ?>
```