Hướng dẫn về ItemList Schema

TL;DR — ItemList là một bit of schema.org code đó says “this page is a list of things, in this order.” (bản dịch) «này trang là một list of điều, trong này order.» Đó hai quan trọng parts là đó list of entries (itemListElement) và một xếp hạng number on mỗi một (position). By itself điều này làm không nhận bạn một fancy tìm kiếm kết quả — Google swipeable Carousel là được xây dựng on top of ItemList, và chỉ cho thấy lên khi bạn pair điều này với một of vài cụ thể nội dung types (recipes, movies, courses, restaurants). Điều này sẽ không help bạn xếp hạng cao hơn, either.

Điều gì ItemList schema là

Khi bạn xây dựng một “Top 10” trang, hoặc một recipe roundup, hoặc một list of courses, bạn có thể see đây là một list. MỘT công cụ tìm kiếm mostly sees một wall of text và some HTML. ItemList là một nhỏ block of structured-dữ liệu code đó spells điều này out: “this is a list, here are the items, and here’s the order they go in.” (bản dịch) «này là một list, ở đây là đó items, và ở đây đó order they go trong.»

Schema.org mô tả điều này as “A list of items of any sort—for example, Top 10 Movies About Weathermen, or Top 100 Party Songs.” (bản dịch) «MỘT list of items of bất kỳ loại—ví dụ, Top 10 Movies Về Weathermen, hoặc Top 100 Party Songs.» Điều này cũng adds một clarifying line worth remembering: “Not to be confused with HTML lists, which are often used only for formatting.” (bản dịch) «Không để là confused với HTML lists, mà là thường dùng chỉ cho formatting.» An ordinary <ol> hoặc <ul> làm một list look như một list; ItemList làm điều này có nghĩa là một list để một machine.

Hai properties làm gần như all hoạt động:

• itemListElement — list của entries. mỗi entry là thường ListItem.
• position — number starting tại 1 đó nói nơi mỗi entry ranks trong list.

một điều mọi người nhận sai

Thêm ItemList by itself không nhận bạn một special tìm kiếm kết quả. Này là đó top misconception, so đây là worth stating plainly. ItemList là đó mechanism; đó visible payoff — một swipeable set of cards trong Google kết quả — là một tách biệt feature called một Carousel. Và một carousel chỉ xuất hiện khi bạn combine ItemList với một of một ngắn, Google-controlled list of nội dung types (cho đó classic carousel: Course list, Movie, Recipe, Restaurant). MỘT generic “Top 10 blog posts” (bản dịch) «Top 10 blog posts» trang marked lên với đơn giản ItemList không earn đó display.

có cũng một family connection đó surprises mọi người: breadcrumbs dùng đó giống nhau mechanism. BreadcrumbList — đó schema behind những “Home › Category › Page” (bản dịch) «Home › Category › Trang» trails — là technically một loại of ItemList. Giống nhau itemListElement, giống nhau position. Khi bạn learn một, bạn đã mostly learned đó other.

Vì sao điều này quan trọng (và Điều gì nó không làm)

• Điều này có thể làm bạn eligible cho một carousel — nếu bạn có một supported nội dung loại và mọi thứ khác là right. Eligible không đó giống nhau as guaranteed, either: Google says plainly điều này không bảo đảm đó features consuming dữ liệu có cấu trúc sẽ thực ra cho thấy lên trong kết quả tìm kiếm.
• Điều này helps machines understand trang của bạn là một structured list. đó là đó container job — I’m không going để claim một rộng hơn “helps AI systems read your page” (bản dịch) «helps AI các hệ thống đọc trang của bạn» payoff on top of đó không có Google xuất bản điều gì đó cụ thể để point để.
• Điều này làm không improve của bạn thứ hạng. Như all dữ liệu có cấu trúc, ItemList không phải một xếp hạng factor. Google đã được consistent on này cho năm.

Muốn đầy đủ picture — hai implementation patterns, chính xác supported types, newer geo-limited beta carousel, Cách BreadcrumbList fits trong, và phổ biến validation failures? Chuyển để Nâng cao tab.

Tóm tắt — ItemList là schema.org generic ordered-list container; itemListElement

• 1-based position làm hoạt động, với itemListOrder và numberOfItems as lesser-được sử dụng extras (numberOfItems matters cho paginated lists). nó là không itself rich kết quả — Google Carousel là được xây dựng bên cạnh nó và chỉ fires với supported companion loại: Course list, Movie, Recipe, Restaurant cho kinh điển carousel, và LocalBusiness/Sản phẩm/Event cho newer beta đó geo-gated để EEA, Turkey, và South Africa. Hai patterns: summary-trang (URL-chỉ ListItems) và all-trong-một (nested items). Rules: 2+ items (3+ cho beta), all giống nhau loại on kinh điển carousel ( beta cho phép mixing), markup phải match visible nội dung. BreadcrumbList là formally subtype của ItemList (với HowToSection, HowToStep, OfferCatalog) — detail phần lớn các hướng dẫn miss. và dữ liệu có cấu trúc không phải xếp hạng factor — của nó payoff là eligibility và understanding, không position.

Điều gì ItemList thực ra là

Schema.org definition là có chủ ý rộng: “A list of items of any sort—for example, Top 10 Movies About Weathermen, or Top 100 Party Songs.” (bản dịch) «MỘT list of items of bất kỳ loại—ví dụ, Top 10 Movies Về Weathermen, hoặc Top 100 Party Songs.» Đó line đó giải thích vì sao đó loại cần để exist là đó tiếp theo một: “Not to be confused with HTML lists, which are often used only for formatting.” (bản dịch) «Không để là confused với HTML lists, mà là thường dùng chỉ cho formatting.» An <ol>/<ul> conveys “these are a list, in this order” (bản dịch) «những là một list, trong này order» purely by visual convention. ItemList declares đó container (ItemList), mỗi entry (ListItem), và mỗi entry xếp hạng (position) as dữ liệu một machine có thể đọc không có inferring bất cứ điều gì từ layout.

Hai properties làm nặng lifting:

• itemListElement — đó array of entries. Schema.org: “For itemListElement values, you can use simple strings (e.g. ‘Peter’, ‘Paul’, ‘Mary’), existing entities, or use ListItem.” (bản dịch) «Cho itemListElement các giá trị, bạn có thể dùng đơn giản strings (e.g. ‘Peter’, ‘Paul’, ‘Mary’), existing entities, hoặc dùng ListItem.» Cho bất cứ điều gì đó wants một URL hoặc một position (i.e. bất cứ điều gì aiming tại một rich kết quả), bạn dùng ListItem.
• position — một 1-based integer giving mỗi ListItem của nó xếp hạng.

Hai nhiều hơn là được ghi lại nhưng skipped by phần lớn các hướng dẫn:

• itemListOrder — “Type of ordering (e.g. Ascending, Descending, Unordered).” (bản dịch) «Loại of ordering (e.g. Ascending, Descending, Unordered).» MỘT declaration, không điều gì đó Google enforces.
• numberOfItems — “The number of items in an ItemList. Note that some descriptions might not fully describe all items in a list.” (bản dịch) «Đó number of items trong an ItemList. Note đó some các mô tả có thể không fully mô tả all items trong một list.» Này một earns của nó giữ on paginated lists: một “Top 100” split trên five các trang có thể dùng numberOfItems để state đó đầy đủ count mặc dù bất kỳ một trang marks lên chỉ twenty entries.

(có cũng aggregateElement cho holding aggregate ratings/offers trên list — genuinely niche; bạn’ll rarely touch nó.)

hai implementation patterns

Google carousel tài liệu mô tả hai shapes, và mà một bạn sử dụng thay đổi Điều gì mỗi ListItem looks như:

Summary trang và multiple detail các trang

summary trang lists mỗi item briefly, và mỗi entry links out để dedicated detail trang. Ở đây ListItem là minimal — Google: summary trang defines ItemList nơi mỗi ListItem có chỉ three properties: @type (đặt để ListItem), position ( position trong list), và url ( canonical URL của item detail trang). đầy đủ theo-item dữ liệu có cấu trúc ( Recipe, Movie, etc.) lives on mỗi detail trang.

All-trong-một summary trang

Mọi thứ lives on một trang, so mỗi ListItem carries nested item containing đầy đủ companion-loại markup ( toàn bộ Recipe object, chẳng hạn) thay vì chỉ url. sử dụng điều này Khi có không tách biệt detail các trang.

ItemList không phải Carousel — Đây là cốt lõi phân biệt

Ở đây độ chính xác spine của toàn bộ topic. ItemList là container; Carousel là rich kết quả được xây dựng bên cạnh nó. ItemList alone, với không supported companion loại, làm không produce distinct “list” rich kết quả trong kinh điển Google Search. tài liệu củ Google là rõ ràng đó carousel eligibility requires cả hai pieces.

kinh điển Carousel — supported types

để là eligible cho host carousel rich kết quả, bạn thêm ItemList dữ liệu có cấu trúc trong combination với một của nhỏ, Google-controlled đặt của supported features. As của Google hiện tại (2026) tài liệu, đó list là:

• Course list
• Movie
• Recipe
• Restaurant

đó nó cho kinh điển carousel. khác types — Sản phẩm, BlogPosting, Event — có thể carry ItemList markup cho organization và machine understanding, nhưng đó alone làm không làm them kinh điển-carousel-eligible.

Carousels (Beta) — newer, geo-gated program

có một second, newer program — Carousels (Beta) — đó Google mô tả as “a list-like rich result that people can scroll horizontally to see more entities from a given site.” (bản dịch) «một list-như rich kết quả đó mọi người có thể scroll horizontally để see hơn entities từ một được cho site.» đây là đó hơn actively-evolving part of này feature area, và điều này differs từ đó classic carousel trong three quan trọng ways:

• Khác nhau supported types: ItemList combined với LocalBusiness và của nó subtypes (Restaurant, Hotel, VacationRental), Sản phẩm, hoặc Event — một rộng hơn và khác nhau set hơn đó classic four.
• Geographically limited: đây là khả dụng chỉ trong EEA countries, Turkey, và South Africa, on desktop và mobile, với đó eligible query types varying by region. Này là không một global feature — một caveat worth stating plainly, since several bên thứ ba ghi-ups discuss điều này as nếu đây là generally khả dụng.
• MỘT cao hơn minimum: đó beta requires một summary trang plus detail các trang với ít nhất three itemListElement.item entries, versus đó classic carousel hai.
• Mixing là được phép: unlike đó classic carousel strict giống nhau-loại rule, Google beta tài liệu says bạn “can mix and match different types of entities (for example, hotels, restaurants), if needed for your scenario” (bản dịch) «có thể mix và match khác nhau types of entities (ví dụ, hotels, restaurants), nếu needed cho của bạn scenario» — không carry đó classic giống nhau-loại assumption over khi bạn là hoạt động với đó beta.

Treat đó beta as “watch this space” (bản dịch) «watch này space» thay vì một ổn định, universal feature.

Cách BreadcrumbList (và một vài others) relate để ItemList

Này là đó single hầu hết dưới-covered, differentiating fact về ItemList, và điều này clears lên một phổ biến point of confusion: BreadcrumbList không phải một tách biệt, unrelated schema loại — điều này là formally một subtype of ItemList. Schema.org trạng thái điều này trực tiếp: “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.” (bản dịch) «MỘT BreadcrumbList là an ItemList consisting of một chain of linked Web các trang, typically described dùng ít nhất của họ URL và của họ name, và typically ending với đó hiện tại trang.» Và schema.org own “More specific Types” (bản dịch) «Hơn cụ thể Types» list cho ItemList là chính xác four entries: BreadcrumbList, HowToSection, HowToStep, và OfferCatalog.

Practically, đó có nghĩ là itemListElement + position mechanics bạn sử dụng cho carousel là theo nghĩa đen giống nhau ones bạn sử dụng cho breadcrumbs — chỉ outer @type (BreadcrumbList so với. đơn giản ItemList) và semantic purpose thay đổi. Google frames breadcrumbs giống nhau way: để specify breadcrumbs, bạn define BreadcrumbList containing tại least hai ListItems. nếu bạn’ve implemented một, bạn đã understand khác. ( breadcrumb side của điều này family lives trong của nó own deep dive, và visible carousel kết quả là subject của sibling carousel piece — cả hai sit trong điều này giống nhau structured-dữ liệu sub-cluster.)

Implementation requirements và phổ biến validation failures

phần lớn carousel/ItemList failures come xuống để handful của được ghi lại rules:

• Minimum item count. Google requires đó itemListElement array để contain hai hoặc hơn ListItem elements cho đó classic carousel (three hoặc hơn cho đó beta). Một item không phải một list.
• Giống nhau-loại rule (classic carousel) — đó frequent real nguyên nhân of failures. Google: “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.” (bản dịch) «All items trong đó list phải được of đó giống nhau loại. Ví dụ, nếu một list là về recipes, chỉ bao gồm Recipe items. không mix khác nhau types.» MỘT list đó mixes Recipes và Các sản phẩm sẽ không validate as một classic carousel. Này rule là cụ thể để đó classic program — đó beta trên explicitly permits mixing entity types, so không carry đó giống nhau-loại assumption over khi đó là đó program bạn là targeting.
• Visible-nội dung parity. MỘT chung structured-dữ liệu policy đó là called out cụ thể ở đây: đó text visible để người dùng phải được similar để đó information trong đó structured dữ liệu. Bạn không thể mark lên items đó không genuinely represented trong đó visible trang.
• Giống nhau-domain URLs. MỘT host carousel cho thấy cards từ đó giống nhau site; đó item URLs nên là on của bạn own domain.
• Tiêu chuẩn structured-dữ liệu hygiene áp dụng. JSON-LD là Google được khuyến nghị format, all bắt buộc properties cho của bạn companion loại phải được present (“Items that are missing required properties are not eligible for rich results” (bản dịch) «Items đó là bị thiếu bắt buộc properties không phải eligible cho rich kết quả»), và bạn không được block đó marked-lên các trang từ Googlebot qua robots.txt hoặc noindex. Những là đó giống nhau chung guidelines đó govern mỗi rich-kết quả loại — đó rộng hơn structured-dữ liệu hub covers them trong đầy đủ.

Làm ItemList schema ảnh hưởng thứ hạng? (Không.)

Ngắn câu trả lời: không. Dữ liệu có cấu trúc không phải một xếp hạng factor, và đó bao gồm ItemList. Này là Google consistent, repeated position. Tại Tìm kiếm Central Trực tiếp APAC 2025, Gary Illyes đã làm đó point đó “excessive or redundant schema only adds page bloat and has no additional ranking benefits,” (bản dịch) «excessive hoặc redundant schema chỉ adds trang bloat và có không additional xếp hạng benefits,» cách diễn đạt schema as an aid để entity understanding và machine features — explicitly không part of đó xếp hạng xử lý. Google standing position trên gần đây năm là đó giống nhau: dữ liệu có cấu trúc không phải một tín hiệu xếp hạng, và ngay cả trong cases of structured-dữ liệu misuse đó consequence là mất mát of rich-kết quả eligibility (qua một manual hành động), không một xếp hạng hình phạt.

Nơi làm đó giá trị come từ, thì? Hai places: rich-kết quả eligibility (một carousel có thể lift nhấp-qua, không position) và machine understanding. On đó second point, John Mueller — speaking personally, và explicitly “not official guidance” (bản dịch) «không chính thức hướng dẫn» — noted trong sớm 2026 đó some features genuinely benefit từ dữ liệu có cấu trúc, giving đó ví dụ đó “pricing, shipping, availability for shopping is basically impossible to read in high fidelity & accurately from a text page.” (bản dịch) «pricing, shipping, availability cho shopping là basically không thể để đọc trong cao fidelity & accurately từ một text trang.» đó là đó honest frame: ItemList helps machines understand một structured list; điều này không xếp hạng điều này cao hơn.

ItemList so với. CollectionPage — nhanh disambiguation

Những nhận confused vì cả hai apply để “listing” các trang, nhưng they câu trả lời khác nhau các câu hỏi. ItemList mô tả an ordered list of discrete items — đó entries và của họ positions. CollectionPage là một trang loại đó represents một themed collection; đây là về trang-cấp độ semantics (“this page is a collection of things” (bản dịch) «này trang là một collection of điều») thay vì đó ordering of cụ thể list items. họ là không mutually exclusive — một category trang có thể là một CollectionPage đó cũng contains an ItemList of của nó các sản phẩm — nhưng reach cho ItemList khi điều gì bạn muốn để express là “here are the ranked items,” (bản dịch) «ở đây là đó được xếp hạng items,» và CollectionPage khi bạn muốn để express “this page is a curated collection.” (bản dịch) «này trang là một curated collection.»

nơi điều này fits

ItemList là một deep dive dưới đó rộng hơn dữ liệu có cấu trúc hub, alongside đó sibling pieces on đó visible carousel rich kết quả (ItemList main Google application) và on BreadcrumbList (formally một subtype of đó very giống nhau mechanism). Cho đó fundamentals đó govern mỗi loại ở đây — đó schema.org vocabulary, JSON-LD, đó “not a ranking factor” (bản dịch) «không phải là yếu tố xếp hạng» spine, và đó shrinking list of supported rich kết quả — see đó Dữ liệu có cấu trúc hub. Đó sub-cluster lives bên trong đó rộng hơn on-trang SEO cluster.

AI summary

condensed take on Nâng cao version:

• ItemList = một generic schema.org list container. “A list of items of any sort.” (bản dịch) «MỘT list of items of bất kỳ loại.» itemListElement (đó entries, thường ListItem) + một 1-based position làm đó hoạt động; itemListOrder và numberOfItems là lesser-dùng extras (numberOfItems matters cho paginated lists).
• ItemList không phải một rich kết quả by itself. Google Carousel là được xây dựng on top of điều này và chỉ fires với một supported companion loại. Này container-so với-rich-kết quả phân biệt là đó top misconception.
• Classic Carousel supported types: Course list, Movie, Recipe, Restaurant — pair một với ItemList để là eligible (không bao giờ guaranteed).
• Carousels (Beta) là một tách biệt, newer program: LocalBusiness/Sản phẩm/Event, geo-gated để đó EEA, Turkey, và South Africa, minimum three entities. Không globally khả dụng.
• Hai implementation patterns: summary-trang (ListItems với chỉ @type/position/url, detail markup on tách biệt các trang) và all-trong-một (mỗi ListItem nests đó đầy đủ item).
• BreadcrumbList là một formal SUBTYPE of ItemList (với HowToSection, HowToStep, OfferCatalog). Breadcrumbs và carousels share đó chính xác giống nhau itemListElement/position mechanics.
• Rules đó nguyên nhân hầu hết failures: 2+ items (3+ beta), all đó giống nhau loại on đó classic carousel (đó beta cho phép mixing), và markup phải match visible nội dung.
• Không phải là yếu tố xếp hạng. Illyes (2025): redundant schema là “trang bloat” với “no additional ranking benefits.” (bản dịch) «không additional xếp hạng benefits.» Giá trị = rich-kết quả eligibility + machine understanding; misuse costs eligibility, không thứ hạng. Mueller (personally, “not official guidance” (bản dịch) «không chính thức hướng dẫn») notes schema helps cho hard-để-parse dữ liệu như pricing/availability.
• ItemList so với. CollectionPage: ItemList = an ordered list of discrete items; CollectionPage = một trang loại cho một themed collection. Không mutually exclusive.

Tài liệu chính thức

Chính-nguồn tài liệu từ Google và schema.org.

Google

• Carousel (ItemList) Dữ liệu có cấu trúc — kinh điển host carousel: supported types (Course list, Movie, Recipe, Restaurant), summary-trang so với. all-trong-một patterns, 2+ items và giống nhau-loại rules.
• Carousels (Beta) Dữ liệu có cấu trúc — newer, geo-gated program (LocalBusiness/Sản phẩm/Event; EEA, Turkey, South Africa; 3+ entities).
• Breadcrumb (BreadcrumbList) Dữ liệu có cấu trúc — breadcrumb application của giống nhau ItemList mechanism.
• Dữ liệu có cấu trúc Chung Guidelines — policies đó apply để ItemList as để mỗi loại: visibility, độ chính xác, bắt buộc properties, không robots.txt/noindex blocking.

schema.org

• ItemList — đó loại itself: đó definition, đó HTML-list phân biệt, itemListElement/itemListOrder/numberOfItems, và đó “More specific Types” (bản dịch) «Hơn cụ thể Types» list confirming đó subtypes.
• BreadcrumbList — xác nhận, từ đó other direction, đó BreadcrumbList là an ItemList.
• ListItem — đó entry loại đó carries position, url, và item.

Quotes từ nguồn

On—record statements từ Google và schema.org. nơi trang exposes text, link là deep link đó jumps để quoted passage.

schema.org — Điều gì ItemList là

• “A list of items of any sort—for example, Top 10 Movies About Weathermen, or Top 100 Party Songs.” (bản dịch) «MỘT list of items of bất kỳ loại—ví dụ, Top 10 Movies Về Weathermen, hoặc Top 100 Party Songs.» — schema.org, ItemList. Nhảy đến trích dẫn
• “Not to be confused with HTML lists, which are often used only for formatting.” (bản dịch) «Không để là confused với HTML lists, mà là thường dùng chỉ cho formatting.» Nhảy đến trích dẫn
• On itemListElement: “For itemListElement values, you can use simple strings (e.g. ‘Peter’, ‘Paul’, ‘Mary’), existing entities, or use ListItem.” (bản dịch) «Cho itemListElement các giá trị, bạn có thể dùng đơn giản strings (e.g. ‘Peter’, ‘Paul’, ‘Mary’), existing entities, hoặc dùng ListItem.» Nhảy đến trích dẫn

schema.org — BreadcrumbList là 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.” (bản dịch) «MỘT BreadcrumbList là an ItemList consisting of một chain of linked Web các trang, typically described dùng ít nhất của họ URL và của họ name, và typically ending với đó hiện tại trang.» — schema.org, BreadcrumbList. Nhảy đến trích dẫn

Google — giống nhau-loại rule

• “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.” (bản dịch) «All items trong đó list phải được of đó giống nhau loại. Ví dụ, nếu một list là về recipes, chỉ bao gồm Recipe items. không mix khác nhau types.» — Google Search Central, Carousel tài liệu. Nhảy đến trích dẫn

Gary Illyes, Google (Tìm kiếm Central Trực tiếp APAC 2025, qua công cụ tìm kiếm Journal ghi-lên)

• Excessive hoặc redundant schema “only adds page bloat and has no additional ranking benefits” (bản dịch) «chỉ adds trang bloat và có không additional xếp hạng benefits» — schema helps entity understanding và machine features, nhưng không phải part of đó xếp hạng xử lý. Đọc bài đưa tin

John Mueller, Google (Reddit, reported Jan 2026 by Công cụ tìm kiếm Roundtable — explicitly được diễn đạt as personal opinion, “not official guidance” (bản dịch) «không chính thức hướng dẫn»)

• On nơi schema genuinely helps: “Pricing, shipping, availability for shopping is basically impossible to read in high fidelity & accurately from a text page, for example.” (bản dịch) «Pricing, shipping, availability cho shopping là basically không thể để đọc trong cao fidelity & accurately từ một text trang, ví dụ.» Đọc bài đưa tin

ItemList — bảng tra nhanh

** properties**

kinh điển Carousel so với. Carousels (Beta)

** rules đó break validation**

• Ít hơn minimum items (2 kinh điển / 3 beta).
• Mixed item types on kinh điển carousel — all items phải là giống nhau loại ở đó ( beta cho phép mixing).
• Markup đó không match visible on-nội dung trang.
• Item các URL off của bạn own domain (host carousels là giống nhau-trang web).
• Bị thiếu bắt buộc properties on companion loại.

Fast facts

• ItemList alone là không rich kết quả — bạn cần supported companion loại cho carousel.
• BreadcrumbList là subtype của ItemList (với HowToSection, HowToStep, OfferCatalog).
• không xếp hạng factor — giá trị là eligibility + machine understanding.
• JSON-LD là Google được khuyến nghị format.
• ItemList so với. CollectionPage: ordered list của items so với. themed-collection trang loại.

Làm I cần ItemList — và sẽ nó nhận me carousel?

Hoạt động xuống các câu hỏi; mỗi câu trả lời points bạn để right move.

1. là của bạn trang genuinely list của discrete, được xếp hạng/ordered items?

• Không → ItemList không phải right loại. nếu trang là themed collection, xem xét CollectionPage thay vì. nếu nó breadcrumb trail, đó BreadcrumbList ( subtype của ItemList, nhưng với của nó own bắt buộc shape).
• Có → continue.

2. là những điều đó items một của carousel-supported types?

• Course list / Movie / Recipe / Restaurant → bạn’re eligible cho kinh điển Carousel (global). Continue để 3.
• LocalBusiness / Sản phẩm / Event → Bạn có thể chỉ nhận carousel qua Carousels (Beta) program, mà là limited để EEA, Turkey, và South Africa và cần 3+ entities. Elsewhere, của bạn ItemList vẫn helps machine understanding nhưng sẽ không produce carousel.
• Bất cứ điều gì khác (blog posts, generic “Top 10”) → đơn giản ItemList là fine cho structure và understanding, nhưng nó sẽ không produce carousel rich kết quả. không expect một.

3. Làm bạn có tách biệt detail các trang cho mỗi item?

• Có → sử dụng summary-trang pattern: mỗi ListItem cần chỉ @type, position, và url; put đầy đủ companion-loại markup on mỗi detail trang.
• Không, mọi thứ on một trang → sử dụng all-trong-một pattern: mỗi ListItem nests đầy đủ item markup.

4. Cuối eligibility kiểm tra trước khi bạn expect carousel:

• 2+ items (3+ cho beta)? · All giống nhau loại (kinh điển chỉ — beta cho phép mixing)? · Markup matches visible nội dung? · Item các URL on của bạn own domain? · Bắt buộc companion-loại properties present? · trang không blocked by robots.txt/noindex?
• All có → bạn’re eligible. Remember Google vẫn decides liệu để thực ra render nó — rich kết quả là không bao giờ guaranteed.

Reality kiểm tra: none của điều này lifts thứ hạng. upside là có thể carousel (tốt hơn nhấp-qua) và cleaner machine understanding — không cao hơn position.

phổ biến ItemList/carousel các vấn đề và Cách khắc phục them

Symptom-nguyên nhân-khắc phục lookups cho situations đó thực ra dừng carousel từ appearing, hoặc đó break BreadcrumbList side của giống nhau mechanism.

markup validates sạch, nhưng không carousel bao giờ xuất hiện

Có khả năng nguyên nhân: ItemList by itself không phải một rich kết quả — một carousel chỉ fires khi ItemList là paired với một supported companion loại (Course list, Movie, Recipe, Restaurant cho đó classic carousel; LocalBusiness/Sản phẩm/Event cho đó geo-gated beta). Nếu đó trang items là một loại bên ngoài những lists (một generic “Top 10 blog posts,” (bản dịch) «Top 10 blog posts,» chẳng hạn), đó ItemList là đang làm của nó job cho machine understanding nhưng đã là không bao giờ going để produce một carousel. Cách sửa: xác nhận đó companion loại là một of đó supported ones cho đó program bạn là targeting; nếu điều này không, không expect một carousel — remember đó ngay cả fully eligible markup chỉ làm bạn eligible, không bao giờ guaranteed, since Google vẫn decides liệu để render điều này.

list validates nhưng Google flags giống nhau-loại hoặc count lỗi

Có khả năng nguyên nhân: đó hai hầu hết phổ biến structural failures — mixing item types on đó classic carousel (“All items in the list must be of the same type… Don’t mix different types” (bản dịch) «All items trong đó list phải được of đó giống nhau loại… không mix khác nhau types») hoặc có ít hơn đó minimum (2+ cho đó classic carousel, 3+ cho đó beta). Nếu bạn là targeting đó beta thay vì, mixed types không của bạn vấn đề — Google beta tài liệu explicitly cho phép mixing entity types khi đó scenario calls cho điều này. Cách sửa: cho đó classic carousel, kiểm tra mỗi ListItem trong itemListElement là đó giống nhau schema.org loại; cho đó beta, skip đó kiểm tra và xác nhận đó entry count so với đó right minimum cho đó program bạn là pairing với thay vì.

carousel không render mặc dù item count và loại là đúng

có khả năng nguyên nhân: visible-nội dung parity — text visible để người dùng phải là tương tự information trong dữ liệu có cấu trúc, và item các URL nên là on của bạn own domain cho host carousel. list đó marks lên items không genuinely represented on visible trang, hoặc đó points tại off-domain các URL, fails điều này chung structured-dữ liệu policy ngay cả Khi ItemList shape itself là technically đúng. khắc phục: kiểm tra mỗi marked-lên item là genuinely visible on trang (hoặc, trong summary-trang pattern, đó mỗi detail trang carries đầy đủ companion-loại markup) và đó các URL resolve on của bạn own domain, sau đó re-validate.

Breadcrumbs (hoặc một ItemList subtype) fail giống nhau way

có khả năng nguyên nhân: vì BreadcrumbList là formally subtype của ItemList sharing giống nhau itemListElement/position mechanics, giống nhau structural mistakes — cũng một vài items, mismatched visible nội dung — break breadcrumb eligibility cũng. khắc phục: apply giống nhau kiểm tra (minimum items, visible-nội dung match) để BreadcrumbList markup as bạn sẽ để carousel ItemList; nếu bạn’ve debugged một, bạn đã know Cách debug khác.

Worked các ví dụ: hai ItemList patterns

bài viết trên mô tả summary-trang và all-trong-một patterns trong prose chỉ — ở đây Điều gì mỗi thực ra looks như as JSON-LD, plus Cách BreadcrumbList reuses chính xác giống nhau shape.

Pattern 1 — summary trang + tách biệt detail các trang

mỗi ListItem carries chỉ @type, position, và url; đầy đủ Recipe/Movie/etc. markup lives on linked detail trang, không ở đây.

{
  "@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 là 1-based, không 0-based.
• url là canonical URL của đó item own detail trang — Recipe object itself là marked lên over ở đó, không nested ở đây.
• điều này shape cần 2+ entries cho kinh điển carousel (3+ cho beta), và mỗi entry phải là giống nhau companion loại on far end.

Pattern 2 — all-trong-một trang (không tách biệt detail các trang)

Mọi thứ lives on một trang, so mỗi ListItem nests đầy đủ item object thay vì của chỉ 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"
      }
    }
  ]
}

• sử dụng điều này Khi có không dedicated detail trang theo item — toàn bộ companion-loại object (Recipe ở đây) nests dưới item.
• Cả hai items là Recipe — mixing trong Product hoặc Movie ở đây sẽ break giống nhau-loại rule và disqualify toàn bộ list từ carousel eligibility.

Cách BreadcrumbList reuses giống nhau mechanism

BreadcrumbList là formally subtype của ItemList — giống nhau itemListElement/position shape, chỉ khác outer @type và 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 requires ít nhất hai ListItems cho breadcrumb trail — giống nhau “2+ items” mechanic as kinh điển carousel, chỉ applied để trang hierarchy thay vì của nội dung items.
• cuối crumb ( hiện tại trang) typically omits item, since nó có không further link đích.

Tools cho kiểm tra ItemList và carousel eligibility

• Rich-Kết quả Eligibility Checker — paste của bạn JSON-LD, HTML trang, hoặc fetch trực tiếp URL và see, theo loại, mà của Google rich kết quả nó qualifies cho, including Breadcrumb feature điều này bài viết establishes as subtype của ItemList — nó flags chính xác bị thiếu bắt buộc trường thay vì chỉ generic truyền/fail, mà là fastest way để see liệu BreadcrumbList (hoặc carousel companion loại) là thực ra eligible.
• Schema Markup Validator — paste hoặc fetch của bạn JSON-LD và chạy nó qua severity-tiered structured-dữ liệu validation: schema.org vocabulary kiểm tra, Google rich-kết quả requirements, và cross-block @id graph kiểm tra, với corrected copy-pasteable JSON-LD block lại. hữu ích cho catching giống nhau-loại mismatches và bị thiếu-thuộc tính các lỗi đó là phần lớn phổ biến nguyên nhân của ItemList/carousel validation failures.
• Google Rich Kết quả Kiểm thử — Google own eligibility checker; good thứ hai opinion sau khi hai tools trên come lại sạch, since nó reflects Google trực tiếp phân tích cú pháp thay vì thứ ba-party interpretation của spec.

Confirming ItemList/carousel thay đổi thực ra took effect

kiểm tra dưới prove cụ thể ItemList hoặc BreadcrumbList thay đổi hoạt động, trong order để chạy them, với tín hiệu đó có nghĩ là “undo này.”

xác nhận JSON-LD parses và hits right eligibility bar

Kiểm thử để chạy: paste đã cập nhật JSON-LD vào Rich-Kết quả Eligibility Checker hoặc Schema Markup Validator. Dự kiến kết quả: companion loại (Recipe, Movie, Course list, Restaurant, hoặc beta LocalBusiness/Sản phẩm/Event) hiển thị as eligible, với không bị thiếu-bắt buộc-thuộc tính các lỗi và không giống nhau-loại mismatches flagged. thất bại interpretation: flagged bị thiếu thuộc tính có nghĩ là companion loại own bắt buộc các trường không phải present tuy vậy; giống nhau-loại warning có nghĩ là itemListElement array mixes types, mà disqualifies toàn bộ list. Monitoring window: immediate — Đây là point-trong-time parse kiểm tra, re-chạy right sau khi bất kỳ markup edit. Rollback trigger: nếu checker các báo cáo new eligibility các lỗi đó đã không ở đó trước khi thay đổi, revert để cuối cùng known-passing JSON-LD trong khi bạn investigate.

xác nhận item và minimum-count rules hold

Kiểm thử để chạy: count ListItem entries trong itemListElement và kiểm tra mỗi một @type (on nested item, hoặc on linked detail trang cho summary-trang pattern) so với giống nhau-loại rule. Dự kiến kết quả: 2 hoặc nhiều hơn entries cho kinh điển carousel (3 hoặc nhiều hơn cho beta), và mỗi entry resolving để giống hệt companion loại. thất bại interpretation: ít hơn entries hơn minimum, hoặc mixed-loại list, có nghĩ là ItemList là structurally hợp lệ JSON-LD nhưng vẫn sẽ không qualify cho carousel. Monitoring window: immediate — Đây là static structural kiểm tra so với hiện tại markup. Rollback trigger: nếu nội dung thay đổi drops list dưới minimum count, treat đó as regression và restore đã xóa items hoặc pull carousel-targeting markup cho đến khi count là lại lên.

xác nhận Google thực ra renders feature (không chỉ eligibility)

Kiểm thử để chạy: chạy trực tiếp trang qua Google Rich Kết quả Kiểm thử, sau đó watch Search Console’s Enhancements báo cáo cho relevant carousel hoặc breadcrumb feature over sau weeks. Dự kiến kết quả: Rich Kết quả Kiểm thử xác nhận feature là detected với không các lỗi, và Enhancements báo cáo hiển thị hợp lệ items với không new warnings. thất bại interpretation: eligibility passing trong thứ ba-party tool nhưng Google own kiểm thử hoặc Search Console cho thấy các lỗi thường có nghĩ là policy vấn đề (visible-nội dung mismatch, blocked trang) thay vì markup syntax vấn đề. Monitoring window: carousel thực tế appearance trong tìm kiếm kết quả là không bao giờ guaranteed ngay cả Khi eligible, so treat 2–4 weeks của Search Console dữ liệu as point nơi Bạn có thể judge liệu feature là picked lên tại all. Rollback trigger: nếu Search Console bắt đầu reporting rising lỗi count cho điều này item loại sau khi thay đổi, revert markup để cuối cùng version đó showed zero các lỗi.

các tài nguyên worth của bạn time

My related writing

• Dữ liệu có cấu trúc: Điều gì nó là và Cách sử dụng nó — my Ahrefs hướng dẫn để schema types, implementation các phương thức, validation tools, và sameAs entity angle; rộng hơn context ItemList sits bên trong.
• Người mới bắt đầu Hướng dẫn để kỹ thuật SEO — nơi dữ liệu có cấu trúc (và lists như điều này) fit trong bigger picture.

My speaking

• Cách Tìm kiếm Hoạt động (SlideShare) — my walkthrough of crawling, kết xuất, lập chỉ mục, và xếp hạng, cho đó context of nơi markup như ItemList làm và không move đó needle. (My standing disclaimer áp dụng: “This is my understanding of systems… not going to be 100% complete or accurate.” (bản dịch) «Này là my understanding of các hệ thống… không going để là 100% hoàn tất hoặc chính xác.»)

Chính thức

• Google — Carousel (ItemList) Dữ liệu có cấu trúc và Carousels (Beta) — hai carousel programs, của họ supported types, và requirements.
• Google — Dữ liệu có cấu trúc Chung Guidelines — policies mỗi rich-kết quả loại (ItemList được bao gồm) có để satisfy.
• schema.org — ItemList và BreadcrumbList — loại definitions, và subtype mối quan hệ confirmed từ cả hai directions.

từ khoảng ngành

• Google Search Central APAC 2025: Mọi thứ từ Day 2 (công cụ tìm kiếm Journal) — Gary Illyes on schema, xếp hạng, và “trang bloat.”
• John Mueller (Personally) On nếu Schema Helps với LLMs & Google (công cụ tìm kiếm Roundtable, Jan 2026) — Mueller personal, non-chính thức take on nơi dữ liệu có cấu trúc genuinely helps.
• Điều gì là ItemList Schema? Hoàn tất Hướng dẫn (Greadme) — solid thứ ba-party walkthrough của carousel eligibility conditions và hai implementation patterns.
• ItemList Schema (Xếp hạng Math KB) — plugin-oriented reference đó separates “ItemList” từ “Carousel” và covers cả hai sử dụng-case patterns.

Tự kiểm tra: ItemList Schema

Five nhanh các câu hỏi on Điều gì ItemList là — và không phải. Pick câu trả lời cho mỗi, sau đó kiểm tra.

Nhật ký thay đổi