Panduan ItemList Schema

TL;DR — ItemList adalah sebuah bit dari schema.org code itu says “ini halaman adalah a list dari hal, di ini order.” (terjemahan) “ini halaman adalah sebuah list dari hal, di ini order.” dua penting bagian adalah list dari entries (itemListElement) dan sebuah peringkat angka pada setiap satu (position). oleh itself ini melakukan tidak mendapatkan Anda sebuah fancy penelusuran hasil — Google’s swipeable Carousel adalah dibangun pada top dari ItemList, dan hanya menampilkan up ketika Anda pair ini dengan satu dari sebuah sedikit spesifik konten jenis (recipes, movies, courses, restaurants). ini tidak akan help Anda peringkat lebih tinggi, either.

Apa ItemList schema adalah

Ketika Anda bangun “Top 10” (terjemahan) “Top 10” halaman, atau sebuah recipe roundup, atau sebuah list dari courses, Anda dapat see ini adalah sebuah list. sebuah mesin pencari mostly sees sebuah wall dari text dan beberapa HTML. ItemList adalah sebuah kecil block dari structured-data code itu spells ini out: “ini adalah a list, di sini adalah itu items, dan di sini’s itu order they go di.” (terjemahan) “ini adalah sebuah list, di sini adalah items, dan di sini’s order mereka go di.”

Schema.org mendeskripsikan ini sebagai “A list dari items dari any sort—misalnya, Top 10 Movies Tentang Weathermen, atau Top 100 Party Songs.” (terjemahan) “sebuah list dari items dari apa pun sort—misalnya, Top 10 Movies tentang Weathermen, atau Top 100 Party Songs.” ini juga menambahkan sebuah clarifying line worth remembering: “Tidak untuk menjadi confused dengan HTML lists, yang adalah sering digunakan hanya untuk formatting.” (terjemahan) “Tidak untuk menjadi confused dengan HTML lists, yang adalah sering digunakan hanya untuk formatting.” sebuah ordinary <ol> atau <ul> membuat sebuah list look like sebuah list; ItemList membuat ini berarti sebuah list untuk sebuah machine.

Dua properties melakukan hampir semua berfungsi:

• itemListElement — list dari entries. setiap entry adalah biasanya sebuah ListItem.
• position — sebuah angka starting di 1 itu says di mana setiap entry peringkat di list.

satu hal everyone mendapatkan wrong

menambahkan ItemList oleh itself melakukan tidak mendapatkan Anda sebuah special penelusuran hasil. ini adalah top misconception, so ini adalah worth stating plainly. ItemList adalah mechanism; terlihat payoff — sebuah swipeable set dari cards di Google’s hasil — adalah sebuah terpisah fitur called sebuah Carousel. dan sebuah carousel hanya muncul ketika Anda combine ItemList dengan satu dari sebuah pendek, Google-controlled list dari konten jenis (untuk classic carousel: Course list, Movie, Recipe, Restaurant). sebuah generic “Top 10 blog posts” (terjemahan) “Top 10 blog posts” halaman marked up dengan plain ItemList tidak earn itu display.

ada juga sebuah family connection itu surprises orang: breadcrumbs gunakan yang sama mechanism. BreadcrumbList — schema behind itu “Home › Category › Halaman” (terjemahan) “Home › Category › halaman” trails — adalah technically sebuah jenis dari ItemList. sama itemListElement, sama position. setelah Anda learn satu, Anda’ve mostly learned lainnya.

mengapa ini penting (dan apa ini tidak melakukan)

• ini dapat membuat Anda eligible untuk sebuah carousel — jika Anda memiliki sebuah didukung konten jenis dan semuanya else adalah right. Eligible tidak yang sama sebagai guaranteed, either: Google says plainly ini tidak jaminan itu fitur consuming data terstruktur akan sebenarnya tampilkan up di hasil pencarian.
• ini helps machines memahami Anda halaman adalah sebuah structured list. itu’s container’s job — I’m tidak going untuk claim sebuah lebih luas “helps AI sistem baca Anda halaman” (terjemahan) “helps AI sistem baca Anda halaman” payoff pada top dari itu tanpa Google penerbitan sesuatu spesifik untuk poin untuk.
• ini melakukan tidak meningkatkan Anda rankings. Like semua data terstruktur, ItemList adalah tidak sebuah peringkat factor. Google memiliki telah consistent pada ini untuk tahun.

ingin penuh picture — dua implementation patterns, tepat didukung jenis, newer geo-limited beta carousel, bagaimana BreadcrumbList fits di, dan umum validation failures? Switch untuk Advanced tab.

TL;DR — ItemList adalah schema.org’s generic ordered-list container; itemListElement

• sebuah 1-based position melakukan berfungsi, dengan itemListOrder dan numberOfItems sebagai lesser-digunakan extras (numberOfItems penting untuk paginated lists). ini adalah tidak itself sebuah rich hasil — Google’s Carousel adalah dibangun pada top dari ini dan hanya fires dengan sebuah didukung companion jenis: Course list, Movie, Recipe, Restaurant untuk classic carousel, dan LocalBusiness/Product/Event untuk sebuah newer beta itu’s geo-gated untuk EEA, Turkey, dan South Africa. Dua patterns: summary-halaman (url-hanya ListItems) dan semua-di-satu (nested items). aturan: 2+ items (3+ untuk beta), semua yang sama jenis pada classic carousel ( beta memungkinkan mixing), markup harus match terlihat konten. BreadcrumbList adalah formally sebuah subtype dari ItemList (dengan HowToSection, HowToStep, OfferCatalog) — detail sebagian besar guides miss. dan data terstruktur adalah tidak sebuah peringkat factor — -nya payoff adalah eligibility dan understanding, tidak position.

Apa ItemList sebenarnya adalah

Schema.org’s definition adalah dengan sengaja broad: “A list dari items dari any sort—misalnya, Top 10 Movies Tentang Weathermen, atau Top 100 Party Songs.” (terjemahan) “sebuah list dari items dari apa pun sort—misalnya, Top 10 Movies tentang Weathermen, atau Top 100 Party Songs.” line itu menjelaskan mengapa jenis perlu untuk exist adalah berikutnya satu: “Tidak untuk menjadi confused dengan HTML lists, yang adalah sering digunakan hanya untuk formatting.” (terjemahan) “Tidak untuk menjadi confused dengan HTML lists, yang adalah sering digunakan hanya untuk formatting.” sebuah <ol>/<ul> conveys “ini adalah a list, di ini order” (terjemahan) “ini adalah sebuah list, di ini order” purely oleh visual convention. ItemList declares container (ItemList), setiap entry (ListItem), dan setiap entry’s peringkat (position) sebagai data sebuah machine dapat baca tanpa inferring apa pun dari layout.

Dua properties melakukan berat lifting:

• itemListElement — array dari entries. Schema.org: “Untuk itemListElement values, Anda dapat gunakan simple strings (e.g. ‘Peter’, ‘Paul’, ‘Mary’), existing entities, atau gunakan ListItem.” (terjemahan) “untuk itemListElement nilai, Anda dapat gunakan sederhana strings (e.g. ‘Peter’, ‘Paul’, ‘Mary’), existing entities, atau gunakan ListItem.” untuk apa pun itu ingin sebuah URL atau sebuah position (i.e. apa pun aiming di sebuah rich hasil), Anda gunakan ListItem.
• position — sebuah 1-based integer giving setiap ListItem -nya peringkat.

Dua lebih adalah terdokumentasi tetapi skipped oleh sebagian besar guides:

• itemListOrder — “Jenis dari ordering (e.g. Ascending, Descending, Unordered).” (terjemahan) “jenis dari ordering (e.g. Ascending, Descending, Unordered).” sebuah declaration, tidak sesuatu Google enforces.
• numberOfItems — “Itu number dari items di an ItemList. Note itu some descriptions mungkin tidak fully deskripsikan all items di a list.” (terjemahan) “ angka dari items di sebuah ItemList. Note itu beberapa deskripsi mungkin tidak fully deskripsikan semua items di sebuah list.” ini satu earns -nya pertahankan pada paginated lists: sebuah “Top 100” (terjemahan) “Top 100” split di seluruh five halaman dapat gunakan numberOfItems untuk state penuh count bahkan though apa pun satu halaman marks up hanya twenty entries.

(ada juga aggregateElement untuk holding aggregate ratings/offers di seluruh list — genuinely niche; Anda’ll rarely touch ini.)

dua implementation patterns

Google’s carousel documentation mendeskripsikan dua shapes, dan yang satu Anda gunakan perubahan apa setiap ListItem looks like:

Summary halaman dan multiple detail halaman

sebuah summary halaman lists setiap item briefly, dan setiap entry tautan out untuk sebuah dedicated detail halaman. Di sini ListItem adalah minimal — Google: summary halaman defines sebuah ItemList di mana setiap ListItem memiliki hanya three properties: @type (atur ke ListItem), position ( position di list), dan url ( canonical URL dari item’s detail halaman). penuh per-item data terstruktur ( Recipe, Movie, dan seterusnya.) lives pada setiap detail halaman.

semua-di-satu summary halaman

Semuanya lives pada satu halaman, so setiap ListItem carries sebuah nested item containing penuh companion-jenis markup ( seluruh Recipe object, misalnya) alih-alih hanya sebuah url. gunakan ini ketika tidak ada terpisah detail halaman.

ItemList adalah tidak Carousel — ini adalah core pembedaan

Di sini’s accuracy spine dari seluruh topic. ItemList adalah sebuah container; Carousel adalah sebuah rich hasil dibangun pada top dari ini. ItemList alone, dengan Tidak didukung companion jenis, melakukan tidak produce sebuah distinct “list” (terjemahan) “list” rich hasil di classic Google Search. Google’s docs adalah jelas itu carousel eligibility memerlukan keduanya pieces.

Classic Carousel — didukung jenis

untuk menjadi eligible untuk sebuah host carousel rich hasil, Anda tambahkan ItemList data terstruktur di combination dengan satu dari sebuah kecil, Google-controlled set dari didukung fitur. sebagai dari Google’s saat ini (2026) documentation, itu list adalah:

«- Course list

• Movie
• Recipe
• Restaurant » (Terjemahan) (Ringkasan bahasa Indonesia untuk bagian tiga puluh lima, bagian kecil satu: teks sumber dipertahankan agar dapat diperiksa dalam tinjauan penutur asli.)

itu’s ini untuk classic carousel. lainnya jenis — Product, BlogPosting, Event — dapat carry ItemList markup untuk organization dan machine understanding, tetapi itu alone melakukan tidak membuat them classic-carousel-eligible.

Carousels (Beta) — newer, geo-gated program

«There’s a second, newer program — Carousels (Beta) — that Google describes as “a list-like rich result that people can scroll horizontally to see more entities from a given site.” It’s the more actively-evolving part of this feature area, and it differs from the classic carousel in three important ways: » (Terjemahan) (Ringkasan bahasa Indonesia untuk bagian tiga puluh delapan, bagian kecil satu: teks sumber dipertahankan agar dapat diperiksa dalam tinjauan penutur asli.)

«- Different supported types: ItemList combined with LocalBusiness and its subtypes (Restaurant, Hotel, VacationRental), Product, or Event — a broader and different set than the classic four.

• Geographically limited: it’s available only in EEA countries, Turkey, and South Africa, on desktop and mobile, with the eligible query types varying by region. This is not a global feature — a caveat worth stating plainly, since several third-party write-ups discuss it as if it’s generally available.
• A higher minimum: the beta requires a summary page plus detail pages with at least three itemListElement.item entries, versus the classic carousel’s two.
• Mixing is allowed: unlike the classic carousel’s strict same-type rule, Google’s beta documentation says you “can mix and match different types of entities (for example, hotels, restaurants), if needed for your scenario” — don’t carry the classic same-type assumption over when you’re working with the beta. » (Terjemahan) (Ringkasan bahasa Indonesia untuk bagian tiga puluh sembilan, bagian kecil satu: teks sumber dipertahankan agar dapat diperiksa dalam tinjauan penutur asli.)

Treat beta sebagai “watch ini space” (terjemahan) “watch ini space” alih-alih sebuah stable, universal fitur.

Bagaimana BreadcrumbList (dan sebuah sedikit others) relate untuk ItemList

«This is the single most under-covered, differentiating fact about ItemList, and it clears up a common point of confusion: BreadcrumbList is not a separate, unrelated schema type — it is formally a subtype of ItemList. Schema.org states it directly: “A BreadcrumbList is an ItemList consisting of a chain of linked Web pages, typically described using at least their URL and their name, and typically ending with the current page.” And schema.org’s own “More specific Types” list for ItemList is exactly four entries: BreadcrumbList, HowToSection, HowToStep, and OfferCatalog. » (Terjemahan) (Ringkasan bahasa Indonesia untuk bagian empat puluh dua, bagian kecil satu: teks sumber dipertahankan agar dapat diperiksa dalam tinjauan penutur asli.)

Practically, itu berarti itemListElement + position mechanics Anda gunakan untuk sebuah carousel adalah secara harfiah yang sama ones Anda gunakan untuk breadcrumbs — hanya outer @type (BreadcrumbList vs. plain ItemList) dan semantic purpose perubahan. Google frames breadcrumbs yang sama cara: untuk specify breadcrumbs, Anda define sebuah BreadcrumbList containing di least dua ListItems. jika Anda’ve implemented satu, Anda sudah memahami lainnya. ( breadcrumb side dari ini family lives di -nya own deep dive, dan terlihat carousel hasil adalah subject dari sebuah sibling carousel piece — keduanya sit di ini sama structured-data sub-cluster.)

Implementation requirements dan umum validation failures

sebagian besar carousel/ItemList failures come down untuk sebuah handful dari terdokumentasi aturan:

• Minimum item count. Google memerlukan itemListElement array untuk berisi dua atau lebih ListItem elements untuk classic carousel (three atau lebih untuk beta). Satu item adalah tidak sebuah list.
• sama-jenis aturan (classic carousel) — frequent nyata penyebab dari failures. Google: “All items di itu list harus menjadi dari itu sama jenis. Misalnya, jika a list adalah tentang recipes, hanya include Recipe items. jangan mix berbeda types.” (terjemahan) “semua items di list harus menjadi dari yang sama jenis. misalnya, jika sebuah list adalah tentang recipes, hanya sertakan Recipe items. jangan mix berbeda jenis.” sebuah list itu mixes Recipes dan Products tidak akan validate sebagai sebuah classic carousel. ini aturan adalah spesifik untuk classic program — beta di atas explicitly permits mixing entity jenis, so jangan carry yang sama-jenis assumption di atas ketika itu’s program Anda’re targeting.
• terlihat-konten parity. sebuah umum structured-data policy itu’s called out secara khusus di sini: text terlihat untuk pengguna harus menjadi similar untuk informasi di structured data. Anda dapat’t mark up items itu tidak genuinely represented di terlihat halaman.
• sama-domain URLs. sebuah host carousel menampilkan cards dari sama situs; item URLs seharusnya menjadi pada Anda own domain.
• Standard structured-data hygiene applies. JSON-LD adalah Google’s recommended format, semua diperlukan properties untuk Anda companion jenis harus menjadi present (“Items itu adalah missing wajib properties adalah tidak eligible untuk rich hasil” (terjemahan) “Items itu adalah missing diperlukan properties adalah tidak eligible untuk rich hasil”), dan Anda harus tidak block marked-up halaman dari Googlebot melalui robots.txt atau noindex. ini adalah yang sama umum guidelines itu govern setiap rich-hasil jenis — lebih luas structured-data hub covers them di penuh.

melakukan ItemList schema memengaruhi rankings? (Tidak.)

pendek jawaban: Tidak. data terstruktur adalah tidak sebuah peringkat factor, dan itu mencakup ItemList. ini adalah Google’s consistent, repeated position. di Penelusuran Central Langsung APAC 2025, Gary Illyes dibuat poin itu “excessive atau redundant schema hanya adds halaman bloat dan memiliki Tidak additional ranking benefits,” (terjemahan) “excessive atau redundant schema hanya menambahkan halaman bloat dan memiliki Tidak additional peringkat benefits,” framing schema sebagai sebuah aid untuk entity understanding dan machine fitur — explicitly tidak bagian dari peringkat proses. Google’s standing position di seluruh recent tahun adalah yang sama: data terstruktur adalah tidak sebuah sinyal peringkat, dan bahkan di cases dari structured-data misuse consequence adalah kehilangan dari rich-hasil eligibility (melalui sebuah manual tindakan), tidak sebuah peringkat penalty.

Di mana melakukan nilai come dari, lalu? Dua places: rich-hasil eligibility (sebuah carousel dapat lift click-melalui, tidak position) dan machine understanding. pada kedua poin, John Mueller — speaking personally, dan explicitly “not official guidance” (terjemahan) “tidak official guidance” — noted di early 2026 itu beberapa fitur genuinely benefit dari data terstruktur, giving contoh itu “pricing, shipping, availability untuk shopping adalah basically impossible untuk baca di high fidelity & accurately dari a text halaman.” (terjemahan) “pricing, shipping, availability untuk shopping adalah basically impossible untuk baca di tinggi fidelity & accurately dari sebuah text halaman.” itu’s honest frame: ItemList helps machines memahami sebuah structured list; ini melakukan tidak peringkat ini lebih tinggi.

ItemList vs. CollectionPage — sebuah quick disambiguation

ini mendapatkan confused karena keduanya apply untuk “listing” (terjemahan) “listing” halaman, tetapi mereka jawaban berbeda pertanyaan. ItemList mendeskripsikan sebuah ordered list dari discrete items — entries dan mereka positions. CollectionPage adalah sebuah halaman jenis itu mewakili sebuah themed collection; ini adalah tentang halaman-tingkat semantics (“ini halaman adalah a collection dari hal” (terjemahan) “ini halaman adalah sebuah collection dari hal”) alih-alih ordering dari spesifik list items. mereka’re tidak mutually exclusive — sebuah category halaman dapat menjadi sebuah CollectionPage itu juga berisi sebuah ItemList dari -nya products — tetapi reach untuk ItemList ketika apa Anda ingin express adalah “di sini adalah itu ranked items,” (terjemahan) “di sini adalah diperingkatkan items,” dan CollectionPage ketika Anda ingin express “ini halaman adalah a curated collection.” (terjemahan) “ini halaman adalah sebuah curated collection.”

Di mana ini fits

ItemList adalah sebuah deep dive di bawah lebih luas data terstruktur hub, alongside sibling pieces pada terlihat carousel rich hasil (ItemList’s main Google application) dan pada BreadcrumbList (formally sebuah subtype dari very sama mechanism). untuk fundamentals itu govern setiap jenis di sini — schema.org vocabulary, JSON-LD, “tidak a ranking factor” (terjemahan) “tidak sebuah peringkat factor” spine, dan shrinking list dari didukung rich hasil — see data terstruktur hub. itu sub-cluster lives di dalam lebih luas pada-halaman SEO cluster.

AI summary

sebuah condensed take pada Advanced versi:

• ItemList = sebuah generic schema.org list container. “A list dari items dari any sort.” (terjemahan) “sebuah list dari items dari apa pun sort.” itemListElement ( entries, biasanya ListItem) + sebuah 1-based position melakukan berfungsi; itemListOrder dan numberOfItems adalah lesser-digunakan extras (numberOfItems penting untuk paginated lists).
• ItemList adalah Tidak sebuah rich hasil oleh itself. Google’s Carousel adalah dibangun pada top dari ini dan hanya fires dengan sebuah didukung companion jenis. ini container-vs-rich-hasil pembedaan adalah top misconception.
• Classic Carousel didukung jenis: Course list, Movie, Recipe, Restaurant — pair satu dengan ItemList untuk menjadi eligible (tidak pernah guaranteed).
• Carousels (Beta) adalah sebuah terpisah, newer program: LocalBusiness/Product/Event, geo-gated untuk EEA, Turkey, dan South Africa, minimum three entities. Tidak globally tersedia.
• Dua implementation patterns: summary-halaman (ListItems dengan hanya @type/position/url, detail markup pada terpisah halaman) dan semua-di-satu (setiap ListItem nests penuh item).
• BreadcrumbList adalah sebuah formal SUBTYPE dari ItemList (dengan HowToSection, HowToStep, OfferCatalog). Breadcrumbs dan carousels share tepat sama itemListElement/position mechanics.
• aturan itu penyebab sebagian besar failures: 2+ items (3+ beta), semua yang sama jenis pada classic carousel ( beta memungkinkan mixing), dan markup harus match terlihat konten.
• Tidak sebuah peringkat factor. Illyes (2025): redundant schema adalah “halaman bloat” (terjemahan) “halaman bloat” dengan “no additional ranking benefits.” (terjemahan) “Tidak additional peringkat benefits.” nilai = rich-hasil eligibility + machine understanding; misuse costs eligibility, tidak rankings. Mueller (personally, “not official guidance” (terjemahan) “tidak official guidance”) notes schema helps untuk hard-untuk-parse data like pricing/availability.
• ItemList vs. CollectionPage: ItemList = sebuah ordered list dari discrete items; CollectionPage = sebuah halaman jenis untuk sebuah themed collection. Tidak mutually exclusive.

Dokumentasi resmi

Utama-sumber documentation dari Google dan schema.org.

Google

• Carousel (ItemList) data terstruktur — classic host carousel: didukung jenis (Course list, Movie, Recipe, Restaurant), summary-halaman vs. semua-di-satu patterns, 2+ items dan sama-jenis aturan.
• Carousels (Beta) data terstruktur — newer, geo-gated program (LocalBusiness/Product/Event; EEA, Turkey, South Africa; 3+ entities).
• Breadcrumb (BreadcrumbList) data terstruktur — breadcrumb application dari yang sama ItemList mechanism.
• data terstruktur umum Guidelines — policies itu apply untuk ItemList sebagai untuk setiap jenis: visibilitas, accuracy, diperlukan properties, Tidak robots.txt/noindex blocking.

schema.org

• ItemList — jenis itself: definition, HTML-list pembedaan, itemListElement/itemListOrder/numberOfItems, dan “More specific Types” (terjemahan) “Lebih spesifik jenis” list confirming subtypes.
• BreadcrumbList — mengonfirmasi, dari lainnya direction, itu BreadcrumbList adalah sebuah ItemList.
• ListItem — entry jenis itu carries position, url, dan item.

Quotes dari sumber

pada—record statements dari Google dan schema.org. Di mana sebuah halaman exposes text, tautan adalah sebuah deep tautan itu jumps untuk quoted passage.

schema.org — apa ItemList adalah

• “A list of items of any sort—for example, Top 10 Movies About Weathermen, or Top 100 Party Songs.” (terjemahan) “sebuah list dari items dari apa pun sort—misalnya, Top 10 Movies tentang Weathermen, atau Top 100 Party Songs.” — schema.org, ItemList. Jump untuk quote
• “Not to be confused with HTML lists, which are often used only for formatting.” (terjemahan) “Tidak untuk menjadi confused dengan HTML lists, yang adalah sering digunakan hanya untuk formatting.” Jump untuk quote
• pada itemListElement: “For itemListElement values, you can use simple strings (e.g. ‘Peter’, ‘Paul’, ‘Mary’), existing entities, or use ListItem.” (terjemahan) “untuk itemListElement nilai, Anda dapat gunakan sederhana strings (e.g. ‘Peter’, ‘Paul’, ‘Mary’), existing entities, atau gunakan ListItem.” Jump untuk quote

schema.org — BreadcrumbList adalah sebuah ItemList

«- “A BreadcrumbList is an ItemList consisting of a chain of linked Web pages, typically described using at least their URL and their name, and typically ending with the current page.” — schema.org, BreadcrumbList. Jump to quote » (Terjemahan) (Ringkasan bahasa Indonesia untuk bagian tujuh puluh dua, bagian kecil satu: teks sumber dipertahankan agar dapat diperiksa dalam tinjauan penutur asli.)

Google — yang sama-jenis aturan

• “All items in the list must be of the same type. For example, if a list is about recipes, only include Recipe items. Don’t mix different types.” (terjemahan) “semua items di list harus menjadi dari yang sama jenis. misalnya, jika sebuah list adalah tentang recipes, hanya sertakan Recipe items. jangan mix berbeda jenis.” — Google Search Central, Carousel documentation. Jump untuk quote

Gary Illyes, Google (Penelusuran Central Langsung APAC 2025, melalui mesin pencari Journal’s tulis-up)

• Excessive atau redundant schema “only adds page bloat and has no additional ranking benefits” (terjemahan) “hanya menambahkan halaman bloat dan memiliki Tidak additional peringkat benefits” — schema helps entity understanding dan machine fitur, tetapi adalah tidak bagian dari peringkat proses. Baca coverage

John Mueller, Google (Reddit, reported Jan 2026 oleh mesin pencari Roundtable — explicitly dibingkai sebagai personal opinion, “not official guidance” (terjemahan) “tidak official guidance”)

• pada di mana schema genuinely helps: “Pricing, shipping, availability for shopping is basically impossible to read in high fidelity & accurately from a text page, for example.” (terjemahan) “Pricing, shipping, availability untuk shopping adalah basically impossible untuk baca di tinggi fidelity & accurately dari sebuah text halaman, misalnya.” Baca coverage

ItemList — cheat sheet

** properties**

«Classic Carousel vs. Carousels (Beta) » (Terjemahan) (Ringkasan bahasa Indonesia untuk bagian delapan puluh lima, bagian kecil satu: teks sumber dipertahankan agar dapat diperiksa dalam tinjauan penutur asli.)

** aturan itu break validation**

• Fewer daripada minimum items (2 classic / 3 beta).
• Mixed item jenis pada classic carousel — semua items harus menjadi yang sama jenis di sana ( beta memungkinkan mixing).
• Markup itu tidak match terlihat pada-halaman konten.
• Item URLs off Anda own domain (host carousels adalah sama-situs).
• Missing diperlukan properties pada companion jenis.

Fast facts

• ItemList alone adalah tidak sebuah rich hasil — Anda perlu sebuah didukung companion jenis untuk sebuah carousel.
• BreadcrumbList adalah sebuah subtype dari ItemList (dengan HowToSection, HowToStep, OfferCatalog).
• Tidak sebuah peringkat factor — nilai adalah eligibility + machine understanding.
• JSON-LD adalah Google’s recommended format.
• ItemList vs. CollectionPage: ordered list dari items vs. sebuah themed-collection halaman jenis.

melakukan I perlu ItemList — dan akan ini mendapatkan me sebuah carousel?

berfungsi down pertanyaan; setiap jawaban poin Anda untuk right move.

1. adalah Anda halaman genuinely sebuah list dari discrete, diperingkatkan/ordered items?

• Tidak → ItemList tidak right jenis. jika halaman adalah sebuah themed collection, lihat CollectionPage alih-alih. jika ini adalah sebuah breadcrumb trail, itu’s BreadcrumbList (sebuah subtype dari ItemList, tetapi dengan -nya own diperlukan shape).
• Ya → continue.

2. adalah itu items satu dari carousel-didukung jenis?

• Course list / Movie / Recipe / Restaurant → Anda’re eligible untuk classic Carousel (global). Continue untuk 3.
• LocalBusiness / Product / Event → Anda dapat hanya mendapatkan sebuah carousel melalui Carousels (Beta) program, yang adalah limited untuk EEA, Turkey, dan South Africa dan perlu 3+ entities. Elsewhere, Anda ItemList masih helps machine understanding tetapi tidak akan produce sebuah carousel.
• Apa pun else (blog posts, generic “Top 10” (terjemahan) “Top 10”) → plain ItemList adalah fine untuk structure dan understanding, tetapi ini akan tidak produce sebuah carousel rich hasil. jangan expect satu.

3. melakukan Anda memiliki terpisah detail halaman untuk setiap item?

• Ya → gunakan summary-halaman pattern: setiap ListItem perlu hanya @type, position, dan url; put penuh companion-jenis markup pada setiap detail halaman.
• Tidak, semuanya’s pada satu halaman → gunakan semua-di-satu pattern: setiap ListItem nests penuh item markup.

4. akhir eligibility memeriksa sebelum Anda expect sebuah carousel:

• 2+ items (3+ untuk beta)? · semua yang sama jenis (classic hanya — beta memungkinkan mixing)? · Markup matches terlihat konten? · Item URLs pada Anda own domain? · diperlukan companion-jenis properties present? · halaman tidak blocked oleh robots.txt/noindex?
• semua Ya → Anda’re eligible. Remember Google masih decides apakah untuk sebenarnya render ini — rich hasil adalah tidak pernah guaranteed.

Reality periksa: none dari ini lifts rankings. upside adalah sebuah mungkin carousel (better click-melalui) dan cleaner machine understanding — tidak sebuah lebih tinggi position.

umum ItemList/carousel masalah dan cara perbaiki them

Symptom-penyebab-perbaiki lookups untuk situations itu sebenarnya berhenti sebuah carousel dari appearing, atau itu break BreadcrumbList side dari yang sama mechanism.

markup validates bersih, tetapi Tidak carousel ever muncul

mungkin penyebab: ItemList oleh itself adalah tidak sebuah rich hasil — sebuah carousel hanya fires ketika ItemList adalah paired dengan sebuah didukung companion jenis (Course list, Movie, Recipe, Restaurant untuk classic carousel; LocalBusiness/Product/Event untuk geo-gated beta). jika halaman’s items adalah sebuah jenis di luar itu lists (sebuah generic “Top 10 blog posts,” (terjemahan) “Top 10 blog posts,” misalnya), ItemList adalah melakukan -nya job untuk machine understanding tetapi adalah tidak pernah going untuk produce sebuah carousel. Perbaiki: konfirmasi companion jenis adalah satu dari didukung ones untuk program Anda’re targeting; jika ini tidak, jangan expect sebuah carousel — remember itu bahkan fully eligible markup hanya membuat Anda eligible, tidak pernah guaranteed, since Google masih decides apakah untuk render ini.

list validates tetapi Google flags sebuah sama-jenis atau count error

mungkin penyebab: dua sebagian besar umum structural failures — mixing item jenis pada classic carousel (“All items in the list must be of the same type… Don’t mix different types” (terjemahan) “semua items di list harus menjadi dari yang sama jenis… jangan mix berbeda jenis”) atau memiliki fewer daripada minimum (2+ untuk classic carousel, 3+ untuk beta). jika Anda’re targeting beta alih-alih, mixed jenis tidak Anda masalah — Google’s beta docs explicitly izinkan mixing entity jenis ketika scenario panggilan untuk ini. Perbaiki: untuk classic carousel, periksa setiap ListItem di itemListElement adalah sama schema.org jenis; untuk beta, skip itu periksa dan konfirmasi entry count terhadap right minimum untuk program Anda’re pairing dengan alih-alih.

carousel tidak render bahkan though item count dan jenis adalah correct

mungkin penyebab: terlihat-konten parity — text terlihat untuk pengguna harus menjadi similar untuk informasi di data terstruktur, dan item URLs seharusnya menjadi pada Anda own domain untuk sebuah host carousel. sebuah list itu marks up items tidak genuinely represented pada terlihat halaman, atau itu poin di off-domain URLs, fails ini umum structured-data policy bahkan ketika ItemList shape itself adalah technically correct. Perbaiki: periksa setiap marked-up item adalah genuinely terlihat pada halaman (atau, di summary-halaman pattern, itu setiap detail halaman carries penuh companion-jenis markup) dan itu URLs resolve pada Anda own domain, lalu re-validate.

Breadcrumbs (atau lainnya ItemList subtype) fail yang sama cara

mungkin penyebab: karena BreadcrumbList adalah formally sebuah subtype dari ItemList sharing yang sama itemListElement/position mechanics, yang sama structural mistakes — too sedikit items, mismatched terlihat konten — break breadcrumb eligibility too. Perbaiki: apply yang sama memeriksa (minimum items, terlihat-konten match) untuk BreadcrumbList markup sebagai Anda akan untuk sebuah carousel ItemList; jika Anda’ve debugged satu, Anda sudah know cara debug lainnya.

Worked contoh: dua ItemList patterns

artikel di atas mendeskripsikan summary-halaman dan semua-di-satu patterns di prose hanya — di sini’s apa setiap sebenarnya looks like sebagai JSON-LD, plus bagaimana BreadcrumbList reuses tepat sama shape.

Pattern 1 — summary halaman + terpisah detail halaman

setiap ListItem carries hanya @type, position, dan url; penuh Recipe/Movie/dan seterusnya. markup lives pada ditautkan detail halaman, tidak di sini.

{
  "@context": "https://schema.org",
  "@type": "ItemList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "url": "https://example.com/recipes/lemon-bars"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "url": "https://example.com/recipes/banana-bread"
    }
  ]
}

• position adalah 1-based, tidak 0-based.
• url adalah canonical URL dari itu item’s own detail halaman — Recipe object itself adalah marked up di atas di sana, tidak nested di sini.
• ini shape perlu 2+ entries untuk classic carousel (3+ untuk beta), dan setiap entry harus menjadi yang sama companion jenis pada far end.

Pattern 2 — semua-di-satu halaman (Tidak terpisah detail halaman)

Semuanya lives pada satu halaman, so setiap ListItem nests penuh item object alih-alih dari hanya sebuah url.

{
  "@context": "https://schema.org",
  "@type": "ItemList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "item": {
        "@type": "Recipe",
        "name": "Lemon Bars",
        "url": "https://example.com/recipes#lemon-bars"
      }
    },
    {
      "@type": "ListItem",
      "position": 2,
      "item": {
        "@type": "Recipe",
        "name": "Banana Bread",
        "url": "https://example.com/recipes#banana-bread"
      }
    }
  ]
}

• gunakan ini ketika ada Tidak dedicated detail halaman per item — seluruh companion-jenis object (Recipe di sini) nests di bawah item.
• Keduanya items adalah Recipe — mixing di sebuah Product atau Movie di sini akan break sama-jenis aturan dan disqualify seluruh list dari carousel eligibility.

Bagaimana BreadcrumbList reuses yang sama mechanism

BreadcrumbList adalah formally sebuah subtype dari ItemList — sama itemListElement/position shape, hanya sebuah berbeda outer @type dan semantic purpose:

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Recipes",
      "item": "https://example.com/recipes/"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Lemon Bars"
    }
  ]
}

• Google memerlukan setidaknya dua ListItems untuk sebuah breadcrumb trail — yang sama “2+ items” (terjemahan) “2+ items” mechanic sebagai classic carousel, hanya applied untuk halaman hierarchy alih-alih dari konten items.
• akhir crumb ( saat ini halaman) typically omits item, since ini memiliki Tidak further tautan target.

alat untuk memeriksa ItemList dan carousel eligibility

• Rich-hasil Eligibility Checker — paste Anda JSON-LD, sebuah HTML halaman, atau fetch sebuah langsung URL dan see, per jenis, yang dari Google’s rich hasil ini qualifies untuk, including Breadcrumb fitur ini artikel establishes sebagai sebuah subtype dari ItemList — ini flags tepat missing diperlukan field alih-alih hanya sebuah generic lulus/fail, yang adalah fastest cara untuk see apakah sebuah BreadcrumbList (atau sebuah carousel companion jenis) adalah sebenarnya eligible.
• Schema Markup Validator — paste atau fetch Anda JSON-LD dan jalankan ini melalui severity-tiered structured-data validation: schema.org vocabulary memeriksa, Google’s rich-hasil requirements, dan cross-block @id graph memeriksa, dengan sebuah corrected copy-pasteable JSON-LD block back. berguna untuk catching sama-jenis mismatches dan missing-property errors itu adalah paling umum penyebab dari ItemList/carousel validation failures.
• Google’s Rich hasil Test — Google’s own eligibility checker; sebuah baik kedua opinion setelah dua alat di atas come back bersih, since ini reflects Google’s langsung parsing alih-alih sebuah ketiga-party interpretation dari spec.

Confirming sebuah ItemList/carousel perubahan sebenarnya took effect

«The checks below prove a specific ItemList or BreadcrumbList change works, in the order to run them, with the signal that means “undo this.” » (Terjemahan) (Ringkasan bahasa Indonesia untuk bagian seratus tiga puluh tiga, bagian kecil satu: teks sumber dipertahankan agar dapat diperiksa dalam tinjauan penutur asli.)

Konfirmasi JSON-LD parses dan hits right eligibility bar

Test untuk jalankan: paste diperbarui JSON-LD ke Rich-hasil Eligibility Checker atau Schema Markup Validator. Yang diharapkan hasil: companion jenis (Recipe, Movie, Course list, Restaurant, atau beta’s LocalBusiness/Product/Event) menampilkan sebagai eligible, dengan Tidak missing-diperlukan-property errors dan Tidak sama-jenis mismatches flagged. Failure interpretation: sebuah flagged missing property berarti companion jenis’s own diperlukan fields tidak present namun; sebuah sama-jenis warning berarti itemListElement array mixes jenis, yang disqualifies seluruh list. Monitoring window: immediate — ini adalah sebuah poin-di-time parse periksa, re-jalankan right setelah apa pun markup edit. Rollback trigger: jika checker reports baru eligibility errors itu tidak di sana sebelum perubahan, revert untuk terakhir known-passing JSON-LD sementara Anda investigate.

Konfirmasi item dan minimum-count aturan hold

Test untuk jalankan: count ListItem entries di itemListElement dan periksa setiap satu’s @type (pada nested item, atau pada ditautkan detail halaman untuk summary-halaman pattern) terhadap yang sama-jenis aturan. Yang diharapkan hasil: 2 atau lebih entries untuk classic carousel (3 atau lebih untuk beta), dan setiap entry resolving untuk identical companion jenis. Failure interpretation: fewer entries daripada minimum, atau sebuah mixed-jenis list, berarti ItemList adalah structurally valid JSON-LD tetapi masih tidak akan qualify untuk sebuah carousel. Monitoring window: immediate — ini adalah sebuah static structural periksa terhadap saat ini markup. Rollback trigger: jika sebuah konten perubahan drops list di bawah minimum count, treat itu sebagai sebuah regression dan restore dihapus items atau pull carousel-targeting markup until count adalah back up.

Konfirmasi Google sebenarnya renders fitur (tidak hanya eligibility)

Test untuk jalankan: jalankan langsung halaman melalui Google’s Rich hasil Test, lalu watch Search Console’s Enhancements report untuk relevant carousel atau breadcrumb fitur di atas berikut weeks. Yang diharapkan hasil: Rich hasil Test mengonfirmasi fitur adalah detected dengan Tidak errors, dan Enhancements report menampilkan valid items dengan Tidak baru warnings. Failure interpretation: eligibility passing di sebuah ketiga-party alat tetapi Google’s own test atau Search Console menunjukkan errors biasanya berarti sebuah policy issue (terlihat-konten mismatch, blocked halaman) alih-alih sebuah markup syntax masalah. Monitoring window: sebuah carousel’s sebenarnya appearance di penelusuran hasil adalah tidak pernah guaranteed bahkan ketika eligible, so treat 2–4 weeks dari Search Console data sebagai poin di mana Anda dapat judge apakah fitur adalah menjadi picked up di semua. Rollback trigger: jika Search Console dimulai reporting sebuah rising error count untuk ini item jenis setelah perubahan, revert markup untuk terakhir versi itu showed zero errors.

Resources worth Anda time

My related writing

• data terstruktur: Apa ini adalah dan cara gunakan ini — my Ahrefs guide untuk schema jenis, implementation metode, validation alat, dan sameAs entity angle; lebih luas context ItemList sits di dalam.
• Beginner’s Guide untuk SEO teknis — di mana data terstruktur (dan lists like ini) fit di bigger picture.

My speaking

• Bagaimana Penelusuran berfungsi (SlideShare) — my walkthrough dari crawling, rendering, pengindeksan, dan peringkat, untuk context dari di mana markup like ItemList melakukan dan tidak move needle. (My standing disclaimer applies: “Ini adalah my understanding dari sistem… tidak going untuk menjadi 100% menyelesaikan atau accurate.” (terjemahan) “ini adalah my understanding dari sistem… tidak going untuk menjadi 100% menyelesaikan atau accurate.”)

Official

• Google — Carousel (ItemList) data terstruktur dan Carousels (Beta) — dua carousel programs, mereka didukung jenis, dan requirements.
• Google — data terstruktur umum Guidelines — policies setiap rich-hasil jenis (ItemList disertakan) memiliki untuk satisfy.
• schema.org — ItemList dan BreadcrumbList — jenis definitions, dan subtype hubungan confirmed dari keduanya directions.

dari sekitar industry

• Google Search Central APAC 2025: Semuanya dari Day 2 (mesin pencari Journal) — Gary Illyes pada schema, peringkat, dan “halaman bloat.” (terjemahan) “halaman bloat.”
• John Mueller (Personally) pada jika Schema Helps dengan LLMs & Google (mesin pencari Roundtable, Jan 2026) — Mueller’s personal, non-official take pada di mana data terstruktur genuinely helps.
• Apa adalah ItemList Schema? sebuah Menyelesaikan Guide (Greadme) — sebuah solid ketiga-party walkthrough dari carousel eligibility conditions dan dua implementation patterns.
• ItemList Schema (peringkat Math KB) — plugin-oriented reference itu separates “ItemList” (terjemahan) “ItemList” dari “Carousel” (terjemahan) “Carousel” dan covers keduanya gunakan-case patterns.

Uji pemahaman Anda: ItemList Schema

Five quick pertanyaan pada apa ItemList adalah — dan tidak. Pick sebuah jawaban untuk setiap, lalu periksa.

Log perubahan