# HtmlDocument::setExtraField()

URL: https://chugunov.pro/api-bitrix/main/urlpreview/htmldocument/setextrafield/
Проверено на 1С-Битрикс 25.x, обновлено 03.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией 1С-Битрикс.

Класс: [`\Bitrix\Main\UrlPreview\HtmlDocument`](https://chugunov.pro/api-bitrix/main/urlpreview/htmldocument/)
Модуль: Main.
Свойства элемента: method, public.

## Сигнатура

```php
public setExtraField(string $fieldName, string $fieldValue) : void
```

## Описание

Устанавливает дополнительное поле метаданных.

## Параметры

- `$fieldName` `string` — обязательный. Имя поля. Ожидаемые значения:
  
  FAVICON: $fieldValue должен содержать url favicon документа
  
  IMAGES: $fieldValue должен быть массивом url изображений, обнаруженных в документе
  
  В остальных случаях $fieldValue должен содержать простой текст.
- `$fieldValue` `string` — обязательный. Значение поля.

## Возвращаемое значение

`void`

Оригинал в официальной документации: https://docs.1c-bitrix.ru/api/classes/Bitrix-Main-UrlPreview-HtmlDocument.html