Як додати FAQ-розмітку Schema.org – приклад коду JSON-LD
FAQ-розмітка Schema.org – це блок JSON-LD на сторінці, у якому питання й відповіді описані машинозрозумілою мовою (тип FAQPage). Щоб її додати, достатньо вставити один <script type="application/ld+json"> у код сторінки, де текст у розмітці дослівно збігається з видимим текстом для користувача. Вона майже не дає розширених сніпетів у Google, але допомагає пошуковим системам і ШІ-асистентам точно зрозуміти, на які питання відповідає ваша сторінка.
Що таке FAQ-розмітка Schema.org
Schema.org – це спільний словник типів даних, який розуміють Google, Bing, Yandex та багато інших сервісів. Тип FAQPage означає: «на цій сторінці є список питань і відповідей, автором яких є сам сайт».
Розмітка не змінює вигляд сторінки для користувача. Вона лише дублює вже наявний контент у структурованому вигляді, щоб машині не доводилося здогадуватися, де питання, а де відповідь.
Найпоширеніший формат – JSON-LD: окремий скрипт, який не втручається у верстку. Google рекомендує саме його, а не мікророзмітку в атрибутах HTML.
Чи дає FAQ-розмітка сніпети в Google зараз?
У 2023 році Google суттєво обмежив показ FAQ-сніпетів: розширені результати з питаннями тепер показуються переважно для авторитетних урядових і медичних сайтів. Для комерційних сайтів очікувати блок із розкривними питаннями у видачі не варто.
Це не означає, що розмітка стала марною. Вона залишається валідною за стандартом Schema.org, її й далі зчитують краулери, агрегатори та системи, що будують відповіді на основі вебу.
Простіше кажучи, мотивація змістилася: ви додаєте FAQPage не заради картинки у видачі, а заради точності машинного розуміння сторінки. Тому й критерій якості інший – не «чи з'явився сніпет», а «чи правильно система зрозуміла, що ви відповідаєте саме на це питання».
Навіщо FAQ-розмітка для ШІ-відповідей
ШІ-пошукові системи (ChatGPT Search, Perplexity, Gemini, Google AI Overviews, Copilot) працюють з текстом сторінки, а не з розміткою напряму. Публічно жодна з них не підтверджувала, що FAQPage є ранжувальним фактором – про це варто говорити чесно.
Водночас структурований блок питань і відповідей дає дві практичні переваги. По-перше, сам формат «питання – коротка самодостатня відповідь» ідеально лягає у відповідь асистента: модель може процитувати абзац без переписування. По-друге, розмітка змушує вас сформулювати питання тими словами, якими їх ставлять люди, – а це і є запити, на які шукають відповідь у ШІ.
Тобто виграш дає поєднання: видимий FAQ-блок у тексті + JSON-LD, що його дублює. Самої розмітки без тексту на сторінці не досить – і це прямо суперечить правилам Google.
Як виглядає готовий код JSON-LD для FAQPage?
Базовий приклад із трьома питаннями. Замініть текст на свій і вставте в код сторінки:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "Скільки триває доставка по Україні?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Замовлення, оформлені до 14:00, ми передаємо перевізнику того ж дня. Доставка у відділення триває 1–2 робочі дні по великих містах і 2–3 дні в інші населені пункти."
}
},
{
"@type": "Question",
"name": "Чи можна повернути товар?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Так, товар належної якості можна повернути протягом 14 днів з моменту отримання, якщо збережено товарний вигляд і пакування. Вартість зворотної пересилки оплачує покупець."
}
},
{
"@type": "Question",
"name": "Які способи оплати ви приймаєте?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Оплата карткою на сайті, безготівковий розрахунок для ФОП і ТОВ, а також накладений платіж при отриманні."
}
}
]
}
</script>
У полі text дозволено обмежений HTML: <h1>–<h6>, <br>, <ol>, <ul>, <li>, <a>, <p>, <div>, <b>, <strong>, <i>, <em>. Лапки всередині тексту треба екранувати через \", а переноси рядків – не ставити «живими», лише через <br> або \n.
Приклад відповіді зі списком і посиланням:
{
"@type": "Question",
"name": "Що входить у базовий тариф?",
"acceptedAnswer": {
"@type": "Answer",
"text": "<p>У базовий тариф входить:</p><ul><li>до 500 сторінок перевірки;</li><li>щомісячний звіт у PDF;</li><li>підтримка електронною поштою.</li></ul><p>Деталі – на <a href=\"https://example.com/pricing\">сторінці тарифів</a>.</p>"
}
}
Якщо на сторінці вже є інша розмітка (наприклад, Article чи Product), додавати FAQ можна окремим скриптом – це коректно. Альтернатива – об'єднати все в масив @graph:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@graph": [
{ "@type": "Article", "headline": "Назва статті", "datePublished": "2025-01-20" },
{ "@type": "FAQPage", "mainEntity": [] }
]
}
</script>
Куди вставляти код на сайті?
Скрипт можна розмістити у <head> або в будь-якому місці <body> – для JSON-LD це не має значення. Головне, щоб він потрапив у HTML, який бачить краулер, а не додавався пізніше через складний клієнтський JavaScript.
- WordPress. Через плагін SEO (у блоках Schema), через хук у
functions.phpабо вставкою в шаблон сторінки. Для окремої сторінки підійде блок «HTML» у редакторі. - Власна CMS або фреймворк. Генеруйте JSON-LD на сервері з тих самих даних, з яких виводите видимий FAQ-блок, – так тексти не розійдуться.
- Конструктори (Tilda, Wix, Shopify тощо). Є поле для вставки довільного коду в
<head>сторінки або блок HTML. Якщо доступ є лише до глобального<head>, перевірте, щоб FAQ-розмітка не потрапила на всі сторінки сайту одразу. - Через Google Tag Manager. Технічно працює, але розмітка з'являється лише після виконання скриптів – не всі краулери й ШІ-боти її побачать. Краще вставляти в HTML.
Після вставки обов'язково подивіться вихідний код сторінки (Ctrl+U) і знайдіть там свій скрипт. Якщо його немає в початковому HTML – розмітки для частини ботів не існує.
Які правила треба дотримати, щоб розмітка була валідною
- Весь текст питань і відповідей має бути видимим на сторінці. Прихований FAQ, який є лише в JSON-LD, – порушення правил.
- Відповіді пише власник сайту, а не користувачі. Для контенту з відповідями спільноти є окремий тип –
QAPage. - Одна сторінка – один блок
FAQPage. Не дублюйте однакові питання на десятках сторінок. - Не ставте у FAQ рекламні, образливі чи юридично чутливі формулювання – це причина для ручних санкцій.
- Текст у розмітці має збігатися з текстом на сторінці дослівно (допустимо лише прибрати HTML-теги).
FAQPage, QAPage чи HowTo – що обрати?
| Тип | Коли використовувати | Хто пише відповідь | Типовий приклад |
|---|---|---|---|
FAQPage | Список питань і відповідей від імені сайту | Власник сайту | Блок «Часті питання» на сторінці послуги |
QAPage | Сторінка з одним питанням і відповідями користувачів | Спільнота, користувачі | Форум, розділ «питання про товар» |
HowTo | Покрокова інструкція з досягнення результату | Власник сайту | «Як замінити фільтр у кавоварці» |
Article + підзаголовки | Довгий матеріал без формату «питання–відповідь» | Автор | Аналітична стаття |
Якщо сумніваєтеся – дивіться на структуру контенту, а не на бажаний сніпет. Розмітка має описувати те, що реально є на сторінці.
Як перевірити, що розмітка працює?
- Відкрийте Schema Markup Validator (validator.schema.org) і вставте URL або код. Він покаже синтаксичні помилки й те, як типи зчиталися.
- Прогоніть сторінку через Google Rich Results Test. Він покаже, чи Google розпізнав
FAQPage, навіть якщо сніпет не відображатиметься. - У Google Search Console перевірте звіт про структуровані дані після індексації – там видно помилки на масштабі всього сайту.
- Подивіться на сторінку з вимкненим JavaScript або через «Переглянути код» – переконайтеся, що скрипт є в HTML.
- Перевірте збіг текстів: відповідь у коді й відповідь на сторінці мають бути однакові.
Типові помилки, через які FAQ-розмітка не спрацьовує
Найчастіша – невалідний JSON: зайва кома після останнього елемента, неекрановані лапки, «розумні» лапки («…») замість прямих після копіювання з Word. Валідатор ловить це за секунду.
Друга за частотою – розмітка на сторінках без видимого FAQ-блоку. Так роблять, щоб «швидше», але це пряме порушення і ризик ручних санкцій.
Третя – надто загальні питання на кшталт «Чому ми?» з відповіддю-рекламою. Такий блок не допомагає ні користувачу, ні ШІ: у ньому немає фактів, які можна процитувати.
Четверта – дублювання одного й того самого FAQ на всіх сторінках сайту. Це розмиває тематичність і не додає жодної нової інформації.
Як сформулювати питання й відповіді, щоб їх цитували
Ставте питання так, як їх формулює людина вголос: «Скільки коштує доставка в Київ?», а не «Доставка: вартість». Довгі розмовні запити – саме те, що вводять у ШІ-асистенти.
Перше речення відповіді має бути самодостатнім: конкретне число, термін, умова чи однозначне «так/ні». Далі – одне-два речення з деталями й винятками. Відповідь на 40–60 слів зручно процитувати цілком.
Додавайте факти, яких немає в загальних джерелах: ваші терміни, зони обслуговування, формат гарантії, обмеження. Саме унікальні деталі змушують систему послатися на ваш сайт, а не переповісти загальне знання.
Уникайте займенників без контексту («у нас», «це», «вона») – витягнутий з контексту абзац має залишатися зрозумілим.
Часті питання
Чи допоможе FAQ-розмітка потрапити в Google AI Overviews?
Прямого підтвердження від Google немає, і коректно казати саме так. Розмітка допомагає системі однозначно зрозуміти структуру сторінки, але вирішальним залишається сам контент: чи є на сторінці чітка, конкретна відповідь на запит.
Скільки питань додавати в FAQPage?
Технічних обмежень немає. На практиці 5–10 питань на сторінку – розумний обсяг: достатньо, щоб покрити реальні запити, і не настільки багато, щоб блок перетворився на звалище.
Чи можна додавати FAQ-розмітку на головну сторінку або сторінку товару?
Так, якщо на цих сторінках справді є видимий блок питань і відповідей. Для товарів FAQ добре поєднується з розміткою Product – вони не конфліктують.
Що робити, якщо валідатор показує попередження, а не помилки?
Попередження стосуються рекомендованих, але необов'язкових полів – розмітка з ними залишається валідною. Виправляти в першу чергу треба саме помилки (errors), вони блокують зчитування.
Чи потрібна FAQ-розмітка, якщо відповіді вже є в тексті статті?
Не обов'язково, але бажано винести ключові питання в окремий блок наприкінці матеріалу й розмітити його. Так ви отримуєте і зрозумілу структуру для машин, і зручну навігацію для читача.
Якщо хочете побачити, які сторінки вашого сайту вже мають коректну структуровану розмітку, а де її бракує, запустіть безкоштовну перевірку в Згадці: сервіс покаже GEO- і SEO-оцінки, а у звіті будуть готові файли – robots.txt, llms.txt, schema.org і FAQ – разом із планом дій.