Has JSON-LD ItemList is a binary check for whether a page’s raw HTML contains a JSON-LD @type value of ItemList. It returns 1 when that string pattern is found and 0 when it is not — because it matches source text rather than validating the structured-data graph, a 1 confirms the pattern is present, not that a well-formed ItemList is served.
| Factor ID | RG-SCJ-127 |
|---|---|
| Family | Structured Data — JSON-LD |
| Measurement | Binary presence (0 / 1) |
| Measured zone | Raw rendered HTML |
What it measures
Has JSON-LD ItemList reports whether RankGear finds an @type value of ItemList in the raw source. ItemList markup describes an ordered or unordered collection of items — a ranked list, a set of steps, or a series of linked entries. This factor is a present-or-absent observation about that one type declaration; it does not assess how many items the list holds, whether their positions and URLs are correct, or whether the markup matches the visible list.
How RankGear measures it
RankGear searches the raw HTML for the string "@type": "ItemList", allowing flexible whitespace around the colon and optionally accepting a schema: prefix on the type value. Matching is case-insensitive. Any single occurrence of the pattern scores the factor 1; if none appears, it scores 0.
What RankGear looks for
# Case-insensitive match on raw HTML; flexible whitespace; optional schema: prefix
"@type"\s*:\s*"(schema:)?ItemList"
# Example that matches:
{
"@context": "https://schema.org",
"@type": "ItemList",
"itemListElement": [ ... ]
}| Value | Meaning |
|---|---|
| 1 | The @type: ItemList pattern was found somewhere in the raw HTML. |
| 0 | The pattern was not found — which does not prove the page could not benefit from ItemList markup. |
How to optimize it
Use ItemList only for a genuine ordered or unordered list, with accurate items, positions, URLs, and an item count that agree with the visible list. Ensure every property reflects content users can verify on the page. Treat this factor as an observation of whether the type declaration is present, not a box to tick: adding the string without a real, matching list on the page invites structured-data errors rather than clarity.
Important considerations
- The detector pattern-matches source text instead of validating a JSON-LD graph.
- A matching string that sits outside valid JSON-LD can still produce a 1.
- Capitalization differences do not affect detection.
- Validate the complete structured data independently before relying on it.
- This is a prioritization signal that relates to patterns within a measured result set, not a cause of ranking; a match neither makes a page rank nor guarantees a position.
Related factors
Part of the Factors reference · how RankGear measures · glossary.