JSON-LD — основной формат структурированной разметки для сайтов в 2025–2026. Если на проекте делается SEO или GEO-оптимизация, разметка организации, авторов, статей, продуктов или услуг идёт через JSON-LD. Альтернативные форматы (Microdata, RDFa) остались для legacy-проектов.
Как это работает
JSON-LD — это блок кода в HTML-странице, который описывает сущности страницы (организация, автор статьи, продукт, услуга, событие) в формате JSON по словарю Schema.org. Поисковики и AI-сервисы парсят этот блок отдельно от визуального HTML и используют для построения knowledge graph.
Минимальный пример — разметка организации:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Клиника X",
"url": "https://klinika-x.ru/",
"telephone": "+7 495 ...",
"address": {
"@type": "PostalAddress",
"streetAddress": "Тверская, 10",
"addressLocality": "Москва",
"postalCode": "125009",
"addressCountry": "RU"
}
}
</script>Этот блок вставляется в <head> или <body> страницы. Браузер его игнорирует (тип application/ld+json — не исполняемый). Поисковики и AI его читают и добавляют сущность в свой индекс.
JSON-LD vs Microdata vs RDFa
Три способа разметить страницу по Schema.org:
- JSON-LD — отдельный JSON-блок, не зависит от вёрстки. Рекомендация Google с 2014. Самый популярный формат в 2025–2026
- Microdata — атрибуты
itemscope,itemtype,itempropпрямо в HTML-тегах. Старее, используется в legacy-проектах - RDFa — атрибуты
vocab,typeof,propertyв HTML-тегах. Чаще встречается в академических проектах и Drupal-сайтах
На один сайт можно использовать только один формат (либо смешивать осторожно). JSON-LD выигрывает за счёт того, что разметку можно поддерживать отдельно от вёрстки — программист не зависит от дизайнера, и обновление шаблонов не ломает SEO.
Зачем это нужно
- Knowledge Panel в Google. Карточка справа от выдачи (фото, контакты, отзывы) строится из Schema.org-разметки, чаще всего JSON-LD
- Rich snippets в поиске. FAQPage, HowTo, Product, Recipe Schema через JSON-LD могут помогать получить расширенное представление в выдаче, если тип поддерживается поисковиком и сайт соответствует требованиям. По состоянию на 2025 Google заметно ограничил показ FAQ rich results — они отображаются преимущественно для государственных и медицинских сайтов; HowTo rich results тоже сильно урезаны
- Entity-сборка для AI. Без JSON-LD AI-системы парсят только текст страницы, без структурированных данных. С JSON-LD у каждой сущности есть «карточка» с атрибутами, которую AI читает легче, чем неструктурированный текст
- NAP-консистентность. JSON-LD-разметка организации становится «source of truth» для NAP-данных. Если в шапке сайта телефон обновили, а в JSON-LD забыли — поисковик будет видеть JSON-LD-версию
Основные типы JSON-LD для бизнеса
Organization/LocalBusiness/MedicalOrganization— для самой компанииPerson— для авторов статей, врачей, экспертовArticle/BlogPosting— для статей и постовFAQPage— для страниц с вопросами и ответамиHowTo— для пошаговых инструкцийService/Product— для услуг и товаровBreadcrumbList— для хлебных крошекWebSite/SearchAction— для главной страницы + sitelinks-поиск
Как валидировать JSON-LD
- Schema.org Validator — официальный валидатор от консорциума Schema.org (https://validator.schema.org/)
- Google Rich Results Test — показывает, какие rich snippets получит страница (https://search.google.com/test/rich-results)
- Yandex Webmaster — структурированные данные — для проверки в индексе Яндекса (раздел «Структурированные данные» в Вебмастере)
- Расширения браузера — Structured Data Tester, JSON-LD viewer
Частые ошибки
1. Дублируется один и тот же Organization на каждой странице. Полная разметка организации нужна один раз на главной + в <head> лендингов, но не повторять её на странице каждой статьи. Достаточно ссылаться через mainEntityOfPage.
2. Разметка не соответствует видимому контенту. Google считает это «spammy structured data» и может санкционировать страницу. В JSON-LD-разметке статьи должны быть те же автор/дата/заголовок, что видны на странице.
3. Не обновляют JSON-LD при смене контактов. Обновили телефон в подвале сайта — а в JSON-LD старый. Поисковики и AI больше доверяют разметке, и обновлять её критично важно.
4. Используют устаревший контекст. "@context": "http://schema.org" устарел, нужно "https://schema.org" (с https). Старая разметка может игнорироваться.
5. Забывают про sameAs. Голая разметка Organization без sameAs-связок к Wikidata, соцсетям, картам — это половина возможной пользы. sameAs — почти бесплатная часть JSON-LD, которая удваивает entity-сборку.
