# URL field type

> For the complete documentation index, see [llms.txt](https://doc.ibexa.co/en/5.0/llms.txt).

This field type makes it possible to store and retrieve a URL. It's formed by the combination of a link and the respective text.

| Name  | Internal name | Expected input |
| ----- | ------------- | -------------- |
| `Url` | `ibexa_url`   | `string`       |

## PHP API field type

### Input expectations

| Type     | Description                                   | Example                  |
| -------- | --------------------------------------------- | ------------------------ |
| `string` | Link content provided to the value.           | "<https://www.ibexa.co>" |
| `string` | Text content that represents the stored link. | "Ibexa"                  |

### Value object

#### Properties

The Value class of this field type contains the following properties:

| Property | Type     | Description                                                                                          |
| -------- | -------- | ---------------------------------------------------------------------------------------------------- |
| `$link`  | `string` | This property stores the link provided to the value of this field type.                              |
| `$text`  | `string` | This property stores the text to represent the stored link provided to the value of this field type. |

```php
// Value object content example

/** @var \Ibexa\Core\FieldType\Url\Value $url */
$url->link = 'https://www.ibexa.co';
$url->text = 'Ibexa';
```

#### Constructor

The `Url\Value` constructor initializes a new value object with the provided value. It expects two comma-separated strings, corresponding to the link and text.

```php
// Constructor example
use Ibexa\Core\FieldType\Url;

// Instantiates an Url Value object
$UrlValue = new Url\Value('https://www.ibexa.co/', 'Ibexa');
```

### Hash format

| Key    | Type     | Description   | Example                   |
| ------ | -------- | ------------- | ------------------------- |
| `link` | `string` | Link content. | "<https://www.ibexa.co/>" |
| `text` | `string` | Text content. | "Ibexa"                   |

```php
// Example of the hash value in PHP
$hash = [
    'link' => 'https://www.ibexa.co/',
    'text' => 'Ibexa',
];
```

### Validation

This field type doesn't perform validation.

But some validation can be made afterward, see [External URL validation](https://doc.ibexa.co/en/5.0/content_management/url_management/url_management/#external-url-validation) for more information.

### Settings

This field type doesn't have settings.