--- metadata: - name: generator content: Diplodoc Platform v5.66.1 alternate: - https://yandex.ru/support/webmaster/en/json-ld/about.md - https://yandex.ru/support/webmaster/ru/json-ld/about.md - href: https://yandex.ru/support/webmaster/ru/json-ld/about.md type: text/markdown title: Markdown version - href: https://yandex.ru/support/webmaster/ru/llms.txt?revision=r22014549 rel: describedby --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/webmaster/ru/llms.txt?revision=r22014549 # 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}



Также вы можете перейти на сервис

[![](../_assets/logo/logo-pic.svg)](https://webmaster.yandex.ru/) [![](../_assets/logo/logo-ru.svg)](https://webmaster.yandex.ru/)