Про що цей гайд
- Що таке Schema.org і навіщо потрібна мікророзмітка
- Який формат використовувати (JSON-LD)
- Обов’язкові та рекомендовані поля для картки товару
- Покрокові приклади: від простого до просунутого
- Перевірка, інструменти та рекомендації
- Особливості для платформ інтернет-магазинів
1. Що таке Schema.org і навіщо це потрібно
Schema.org — це словник (вендорно-нейтральна схема) для структурованих даних, підтримувана великими пошуковими системами. Розмітка допомагає пошуковикам правильно зрозуміти вміст картки товару та може призвести до розширених сніпетів (ціна, наявність, рейтинг, відгуки, фотографії, а також коректне відображення в соцмережах через Open Graph і Twitter Cards).
Офіційні посилання (рекомендовано):
2. Який формат розмітки використовувати
Google рекомендує JSON-LD. Він не втручається в DOM, його легко вставляти сервером і динамічно генерувати з даних БД.
Існуючі формати: JSON-LD (рекомендовано), Microdata, RDFa — обирайте JSON-LD для інтернет-магазину.
3. Обов’язкові поля для коректної картки товару
Мінімум, потрібний для правильної обробки Google:
- name — назва товару
- image — хоча б одне зображення (URL)
- description — короткий опис
- offers.price — ціна
- offers.priceCurrency — валюта (ISO код, наприклад UAH, USD)
- offers.availability — наявність (https://schema.org/InStock і т.д.)
- offers.url — URL сторінки товару
4. Рекомендовані додаткові поля (повний список корисних атрибутів)
- sku — артикул
- mpn — код виробника
- gtin8 / gtin12 / gtin13 / gtin14 — штрихкод
- brand — бренд
- category — категорія
- color, material, size, weight — характеристики
- aggregateRating — підсумковий рейтинг
- review — відгуки
- itemCondition — стан товару
- additionalProperty — довільні властивості (PropertyValue)
- shippingDetails / OfferShippingDetails — умови доставки
- seller — організація-продавець
5. Прості робочі приклади JSON-LD (мінімум)
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Wireless Headphones X100",
"image": "https://site.com/images/headphones-x100.jpg",
"description": "Бездротові навушники з шумоподавленням.",
"offers": {
"@type": "Offer",
"url": "https://site.com/product/headphones-x100",
"priceCurrency": "UAH",
"price": "2499",
"availability": "https://schema.org/InStock"
}
}
</script>
Примітка: price — відправляйте як число/рядок цифр (без символу валюти). availability використовуйте повний URL із schema.org.
6. Детальна розмітка товару (повний приклад)
Нижче — розмітка з багатьма полями: GTIN, бренд, SKU, кілька зображень, aggregateRating, review, additionalProperty, shippingDetails.
<script type="application/ld+json">
{
"@context": "https://schema.org/",
"@type": "Product",
"name": "Xiaomi Mi Band 7",
"image": [
"https://site.com/upload/mi-band-7-1.webp",
"https://site.com/upload/mi-band-7-2.webp"
],
"description": "Фітнес-браслет з AMOLED-екраном і пульсометром.",
"sku": "MI-BAND-7-BLACK",
"mpn": "MB7-2025",
"gtin13": "6954176850021",
"brand": {
"@type": "Brand",
"name": "Xiaomi"
},
"additionalProperty": [
{"@type": "PropertyValue","name": "Колір","value": "Чорний"},
{"@type": "PropertyValue","name": "Матеріал","value": "Силікон, метал"}
],
"offers": {
"@type": "Offer",
"url": "https://site.com/product/mi-band-7/",
"priceCurrency": "UAH",
"price": "1499",
"priceValidUntil": "2026-12-31",
"availability": "https://schema.org/InStock",
"itemCondition": "https://schema.org/NewCondition",
"seller": {
"@type": "Organization",
"name": "Hotlist.biz"
},
"shippingDetails": {
"@type": "OfferShippingDetails",
"shippingRate": {"@type": "MonetaryAmount","value": "50"}
}
},
"aggregateRating": {"@type": "AggregateRating","ratingValue": "4.8","reviewCount": "238"},
"review": [{"@type": "Review","author": "Олена","datePublished": "2025-02-10","reviewBody": "Чудовий браслет, працює стабільно!","reviewRating":{"@type": "Rating","ratingValue": "5"}}]
}
</script>
7. Варіативні товари (розмір/колір) — підходи
Є два поширені підходи:
- Один головний
Product+ списокoffers(або окреміOfferдля кожного варіанту). - Кілька Product (по одному на унікальну сторінку варіанту) — застосовувати, якщо у варіанту своя сторінка/URL.
Приклад: Product з двома Offer (два кольори, одна сторінка):
<script type="application/ld+json">
{
"@context":"https://schema.org",
"@type":"Product",
"name":"Футболка Classic",
"image":["https://site.com/img/tshirt-red.jpg"],
"description":"Класична футболка",
"sku":"TSHIRT-001",
"brand":{"@type":"Brand","name":"BrandCo"},
"offers":[
{"@type":"Offer","sku":"TSHIRT-001-RED","price":"599","priceCurrency":"UAH","availability":"https://schema.org/InStock","itemCondition":"https://schema.org/NewCondition","color":"Червоний"},
{"@type":"Offer","sku":"TSHIRT-001-BLUE","price":"599","priceCurrency":"UAH","availability":"https://schema.org/OutOfStock","itemCondition":"https://schema.org/NewCondition","color":"Синій"}
]
}
</script>
8. BreadcrumbList (хлібні крихти) — корисно для навігації
Хлібні крихти допомагають пошуковикам показати структуру сайту в сніпеті.
<script type="application/ld+json">
{
"@context":"https://schema.org",
"@type":"BreadcrumbList",
"itemListElement":[
{"@type":"ListItem","position":1,"name":"Головна","item":"https://site.com/"},
{"@type":"ListItem","position":2,"name":"Категорія: Браслети","item":"https://site.com/category/bracelets"},
{"@type":"ListItem","position":3,"name":"Xiaomi Mi Band 7","item":"https://site.com/product/mi-band-7/"}
]
}
</script>
9. Як перевіряти розмітку — інструменти
- Google Rich Results Test — швидко показує помилки та попередження для rich snippets.
- validator.schema.org — детальна валідація схеми.
- Google Search Console — у розділі «Покращення» → «Товари» можна відстежувати помилки після публікації.
10. Best practices та рекомендації
- Генеруйте JSON-LD на сервері з БД — ціна, наявність, sku, зображення повинні бути синхронізовані з контентом сторінки.
- Не використовуйте тестові/фейкові дані в production.
- Якщо показуєте кілька цін (акції), використовуйте
priceValidUntilі вказуйте актуальну ціну вoffers.price. - Вказуйте
priceCurrencyв форматі ISO (UAH, USD, EUR). - Не створюйте конфліктну розмітку (різні ціни у видимому контенті та JSON-LD).
- Для міжнародних магазинів — вказуйте локалі, адресу продавця та shippingDetails.
11. Часті помилки та як їх виправити
- Помилка: price містить символ валюти — виправлення: зберігати і виводити тільки цифри.
- Помилка: відсутність image — виправлення: додати хоча б 1 коректний URL.
- Помилка: несумісні URL — виправлення: використовуйте URL саме поточної сторінки товару в offers.url.
- Помилка: масив review/aggregateRating фальсифікований — виправлення: показуйте тільки реальні відгуки.
12. SEO-підказки
- Додайте структуровані дані на кожну картку товару — це підвищує шанс отримати розширений сніпет.
- Додавайте детальні зображення (ImageObject) з вказанням width/height за можливості.
- Використовуйте
BreadcrumbListтаProductразом — це покращує навігацію у видачі. - Моніторьте Search Console і виправляйте помилки розмітки.
13. Шаблон для вставки в шаблон товару (динамічний)
Нижче — шаблон, де змінні підставляються сервером (PHP/Twig/Smarty). Підставляйте свої змінні замість %VAR%.
<script type="application/ld+json">
{
"@context":"https://schema.org",
"@type":"Product",
"name":"%PRODUCT_NAME%",
"image":[%IMAGE_LIST%],
"description":"%SHORT_DESCRIPTION%",
"sku":"%SKU%",
"brand":{"@type":"Brand","name":"%BRAND%"},
"offers":{
"@type":"Offer",
"url":"%PRODUCT_URL%",
"priceCurrency":"%CURRENCY%",
"price":"%PRICE%",
"priceValidUntil":"%PRICE_VALID_UNTIL%",
"availability":"%AVAILABILITY%"
}
}
</script>
14. Рейтинг товарів (aggregateRating)
Рейтинг дозволяє відображати середню оцінку товару та кількість відгуків у розширеному сніпеті.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Wireless Headphones X100",
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": "4.7",
"reviewCount": "154"
}
}
</script>
Рекомендація: ratingValue — число з десятковою крапкою (наприклад 4.7), reviewCount — ціле число.
15. Відгуки покупців (review)
Відгуки дозволяють детально описувати думку користувачів про товар, включаючи автора, дату публікації та оцінку.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Wireless Headphones X100",
"review": [
{
"@type": "Review",
"author": "Олена",
"datePublished": "2025-05-10",
"reviewBody": "Дуже зручні навушники, відмінний звук!",
"reviewRating": {"@type": "Rating","ratingValue": "5"}
},
{
"@type": "Review",
"author": "Ігор",
"datePublished": "2025-05-12",
"reviewBody": "Хороші, але трохи громіздкі.",
"reviewRating": {"@type": "Rating","ratingValue": "4"}
}
]
}
</script>
Кожен відгук включає автора, дату публікації, текст та рейтинг. Можна додавати будь-яку кількість відгуків.
16. Корисні інструменти та посилання
Важливо для користувачів Hotlist.biz
За замовчуванням платформа Hotlist.biz вже містить коректну базову мікророзмітку (Product, Offer, Price, Availability, BreadcrumbList, ImageObject). Зазвичай достатньо розширювати її додатковими полями (gtin, mpn та іншими) за потреби.
Додатково: на платформі автоматично включені розмітка рейтингу (aggregateRating) та відгуки (review), що дозволяє показувати середню оцінку та реальні відгуки користувачів у розширених сніпетах.