List details
List items· auto-numbered (0 valid)
Item 1
Required: List title is required · At least one item with a name is required
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "ItemList"
}
</script>How to use
01
Describe the list
Give the list a title, which is required, then pick a List type: ItemList for best-of and top-N roundups, or HowToSection for numbered steps. A short List description is optional but adds context.
02
Add and reorder your items
Click Add item for each entry and fill in the name, URL, description, and image. Use the up and down arrows to reorder; position numbers update instantly, and the trash icon removes an entry.
03
Check the preview and copy
The List preview renders numbered badges, thumbnails, and links exactly as entered, which makes off-by-one ordering slips obvious. When it reads correctly, click Copy script to grab the JSON-LD block.
Why ItemList Schema Generator
- Build ItemList (best-of, top-N lists) or HowToSection (numbered steps) JSON-LD.
- Drag-equivalent reorder with up/down arrows; live numbering.
- Each item supports name + URL + description + image.
- Built-in preview shows what the list will look like to readers.
Common questions
Does ItemList schema get my page into a carousel?
It makes you eligible for list treatments, but nothing guarantees them; Google decides based on the query and the content. Carousels mostly appear for summary pages that link out to detail pages of a supported type, like recipes or courses. For editorial roundups, the win is clearer machine comprehension.
How does ItemList differ from HowToSection in this tool?
Same builder, different @type on the output. ItemList suits ranked or unranked collections of things. HowToSection suits an ordered run of steps within a larger procedure. Pick based on whether a reader would call your entries recommendations or instructions.
Should ItemList positions match the visible order on my page?
Always. The tool numbers positions from 1 in the order shown, so arrange items here exactly as they appear in the published post. A number ten entry marked position 2 sends contradictory signals, and contradictions are the fastest way to get markup ignored.
Can an ItemList entry skip the image or description?
Yes. Only the name is required per item; the URL, description, and image are optional, and any empty property is left out of that item's JSON. Entries with no name at all are excluded from the output entirely.
What belongs in the URL field of each ItemList item?
For a summary-style list, link each entry to its own detail page. For a single-page roundup where everything lives on one URL, you can leave the item URLs off or use anchor links to each section. Avoid pointing every item at the same bare address.
Is there a limit on how many ItemList items I can add?
The tool doesn't cap you, and the counter shows how many valid items you have. Practically, a list needs at least two entries to make sense as a list, and very long ones are worth splitting so each item still gets a meaningful description.
Why do ItemList positions start at 1 instead of 0?
That's the schema.org convention: ListItem positions are one-based, matching how readers count. The generator handles it for you and renumbers whenever you move or delete entries, which is exactly the bookkeeping that goes wrong in hand-written markup.