Last updated:
Course List Schema Generator
This course list schema generator builds the ItemList JSON-LD for a page that lists at least three courses. Add one row per course: a URL alone for a catalog that links to course pages with their own markup, or a name, description and provider for a page that describes every course itself.
Reference: ItemList schema
Course List: Use on a page that lists at least three courses: a catalog page that links to each course's own page, or one page that describes them all. Google shows course lists in English only.
What Google shows for Course List markup
- Course list: shown in Google Search; Google's last documented change was on July 4, 2022. English only. A page with a single Course isn't eligible on its own.
Google reads this markup for its course list, a carousel of courses shown for English content where Google Search is available. The list must mark up at least three courses, and every ListItem needs a position and a URL no other item uses. Valid markup makes the page eligible; Google decides whether the carousel appears. Course info for a single course was retired on September 9, 2025.
Google accepts two layouts. On a summary page, the catalog links to one page per course: the list gives each course's position and address, and each course page carries its own Course markup, built with the Course schema generator. On an all-in-one page, the list holds every course with its name, description and provider. This form makes course lists only, not lists of recipes or movies.
How to fill in each field
List Name
List Name is optional and becomes the list's name. Use the catalog's heading, such as Photography courses, or leave it empty; Google doesn't require it.
Course URL and order
Click + Add Course once per course, in the order the page shows them. The generator numbers the rows from 1 as each item's position; Remove drops a row and renumbers the rest. Course URL is required and must differ in every row: give each course's own page, the canonical address it has.
Course Name and Description
Leave Course Name, Description and Provider empty and the row stays a summary entry: position and URL. Fill in any of them and the generator writes a Course inside the list item instead, with the URL and what you typed. Google requires both name and description for each course, so fill in both in every all-in-one row. Google displays up to 60 characters of the description, so lead with what the course teaches.
Provider
Provider is the organization that publishes the course, such as your school; Google recommends it. The generator writes it as an Organization whose sameAs is Provider URL, as Google's examples do. Provider URL is used only when Provider has a name.
The form marks 1 field as required and 0 as recommended:
- Courses (required): At least three, in the order the page shows them, each with its own page's URL. On a summary page whose links lead to pages with their own Course markup, the URL is enough; on a page that describes the courses itself, add each one's name and description.
Example: A photography school's catalog on one page
Four courses described on one page. Every row has a name, description and provider, so each becomes a Course inside its ListItem.
{
"@context": "https://schema.org",
"@type": "ItemList",
"name": "Photography courses",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"item": {
"@type": "Course",
"url": "https://www.fieldlight.example/courses/camera-basics/",
"name": "Camera Basics",
"description": "Shoot in manual mode: aperture, shutter speed and ISO.",
"provider": {
"@type": "Organization",
"name": "Fieldlight Photography School",
"sameAs": "https://www.fieldlight.example/"
}
}
},
{
"@type": "ListItem",
"position": 2,
"item": {
"@type": "Course",
"url": "https://www.fieldlight.example/courses/portrait-lighting/",
"name": "Portrait Lighting",
"description": "Light faces with one flash, a reflector or a window.",
"provider": {
"@type": "Organization",
"name": "Fieldlight Photography School",
"sameAs": "https://www.fieldlight.example/"
}
}
},
{
"@type": "ListItem",
"position": 3,
"item": {
"@type": "Course",
"url": "https://www.fieldlight.example/courses/night-photography/",
"name": "Night Photography",
"description": "Long exposures, star trails and city lights after dark.",
"provider": {
"@type": "Organization",
"name": "Fieldlight Photography School",
"sameAs": "https://www.fieldlight.example/"
}
}
},
{
"@type": "ListItem",
"position": 4,
"item": {
"@type": "Course",
"url": "https://www.fieldlight.example/courses/editing-your-photos/",
"name": "Editing Your Photos",
"description": "Sort, crop and color-correct a whole shoot in one sitting.",
"provider": {
"@type": "Organization",
"name": "Fieldlight Photography School",
"sameAs": "https://www.fieldlight.example/"
}
}
}
]
} 5 common mistakes
- Fewer than three rows. Google requires markup for at least three courses, and each row should be a course the page really shows.
- Rows filled in two different ways. A URL-only row and a row with a name come out in different shapes, and the Validator counts only the rows that hold a course. Fill every row the same way.
- The catalog's address in every row. Google wants a unique URL for every item, so the catalog page's own address can't fill each row.
- Names without descriptions. An all-in-one row with a name but no description lacks a property Google requires.
- Course pages with no markup of their own. A URL-only row points at the course's page. Without
Coursemarkup there, the summary list points at nothing.
How to test your Course List markup
Run the code through the Schema Validator first. For an all-in-one list it counts the courses, checks each one's name, description and provider, and reports shared URLs. A URL-only list holds no courses for it to check, so test a few of the linked course pages too. Once the page is live, use Test in Google Rich Results, which copies the code and opens Google's Rich Results Test.
- Open the example in the Schema Validator, which checks it against schema.org and Google's requirements.
- Preview the example in the SERP Simulator to see which search enhancements it can earn.
- Read the itemlist schema reference for the type's other properties and more examples.
Frequently Asked Questions
Should I build a summary list or an all-in-one list?
Follow how the site is built. If each course has its own page with Course markup, use URL-only rows. If one page describes every course, fill in each row in full.
Why does the form mark Course Name as recommended, not required?
A summary row needs only its URL. When the list describes the courses itself, Google requires each one's name and description.
Can this generator build an ItemList of recipes or movies?
No, every row becomes a course or a link to one. For other carousels, start from the examples on the ItemList reference.
What does the Course Catalog template fill in?
Three web development courses from one provider, written the all-in-one way. Replace every value with your own before copying.
Other schema generators
- Local Business Schema Generator
- FAQ Schema Generator
- Product Schema Generator
- Organization Schema Generator
- Article Schema Generator
- Video Schema Generator
- Review Schema Generator
- Person Schema Generator
- Event Schema Generator
- Recipe Schema Generator
- Job Posting Schema Generator
- Course Schema Generator
- Software Application Schema Generator
- HowTo Schema Generator
- Breadcrumb Schema Generator
- Profile Page Schema Generator
- QAPage Schema Generator
- Discussion Forum Schema Generator
- JSON-LD Generator, with every form and the templates