---
metadata:
- name: generator
content: Diplodoc Platform v5.50.6
alternate:
- https://yandex.ru/support/webmaster/en/json-ld/about.md
- https://yandex.ru/support/webmaster/ru/json-ld/about.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/webmaster/ru/llms.txt
# JSON-LD
[JSON-LD](http://json-ld.org/) — это формат описания контента с помощью объектов словаря [связанных данных](https://ru.wikipedia.org/wiki/Linked_data) (Linked Data, LD). Информация, оформленная таким образом, становится машиночитаемой. Чтобы сделать данные JSON-LD доступными для автоматической обработки на странице, их следует помещать в тег `script`.
Правильность разметки JSON-LD можно проверить в [валидаторе](https://webmaster.yandex.ru/site/tools/microtest/).
Данные, размеченные с помощью JSON-LD, используются:
- Яндекс Почтой;
- при формировании [навигационной цепочки](https://yandex.ru/support/webmaster/ru/supported-schemas/navigation-links.md) для отображения в сниппетах в результатах поиска;
- для структурированного отображения [вопросов и ответов на мобильной выдаче](https://yandex.ru/support/webmaster/ru/supported-schemas/q-and-a.md).
Любые данные в формате JSON-LD, как и в формате [JSON](https://ru.wikipedia.org/wiki/JSON), представляют собой набор пар ключ-значение. В отличие от JSON, формат JSON-LD предусматривает зарезервированные ключи, с помощью которых можно определять контекст описания или связывать объекты различным образом. Например, «@context» определяет словарь объектов, а «@type» — тип описываемой сущности. Полный список зарезервированных ключей приведен в [официальной документации JSON-LD](http://www.w3.org/TR/json-ld/#syntax-tokens-and-keywords).
Абсолютно все ключи и значения в формате JSON-LD чувствительны к регистру.
Основные понятия, унаследованные от JSON:
- _Объект JSON_ — набор пар ключ-значение (0 или больше), разделенных запятыми, заключенный в фигурные скобки. В отличие от JSON, в объектах JSON-LD имена ключей в одном и том же объекте не должны повторяться.
- _Массив_ — набор значений, разделенных запятыми, заключенный в квадратные скобки. В отличие от JSON, массив не считается упорядоченным, если это не указано особо.
- _Строка_ — набор символов Unicode, заключенных в двойные кавычки. При необходимости символы можно указывать с помощью обратных слэшей (\\).
- _Число_ — используется как и в большинстве языков программирования, но при этом не поддерживаются восьмеричное и шестнадцатеричное представления, а также запрещены нули в начале числа.
- _true_ и _false_ — бинарные значения, которые можно использовать для ключей только с двумя вариантами значений (например, прямой перелет или с пересадками, зарегистрирован пассажир или нет, и т. п.).
- _null_ — отсутствующее значение. Обычно используется для очистки данных. Если `null` указан как значение ключа `@value`, `@list`, или `@set` внутри JSON-объекта, этот объект полностью игнорируется.
## Пример использования разметки в письмах от авиакомпаний
```xml
```
В примере показаны три ключа:
- `@context` (зарезервированный) — указывает на то, что в объекте используется словарь [Schema.org](https://yandex.ru/support/webmaster/ru/schema-org/what-is-schema-org.md).
- `@type` (зарезервированный) — указывает на [тип FlightReservation](http://schema.org/FlightReservation), в свойствах которого можно указать данные о бронировании билета на авиарейс.
- `reservationId` — соответствует [свойству reservationId типа FlightReservation](http://schema.org/reservationId) и содержит номер бронирования билета.
Другие примеры использования формата приведены в разделе о разметке [писем с информацией об авиабилетах](https://yandex.ru/support/webmaster/ru/mail/flight.md).
[Написать в службу поддержки Яндекс Почты](https://yandex.ru/support/yandex-360/customers/mail/ru/troubleshooting){.button}
Задайте вопрос Нейровебмастеру — в правом нижнем углу нажмите кнопку .
Если у вас остались вопросы, напишите в чат службы поддержки. Для этого в правом нижнем углу нажмите значок . Чат доступен ежедневно с 8:00 до 00:00 по московскому времени.