Skip to content

Course Schema Generator - JSON-LD for Course Lists

Import existing JSON-LD

Paste JSON-LD or a full <script> tag. Matching fields fill the form; properties the form doesn't cover are kept in the output as they are.

Course Details

Google displays about 60 characters.

Provider

Google Search Preview
Preview not available for this type.
All Google requirements met

JSON-LD Output

What is Course schema?

Course schema is structured data that describes an educational course: its name, a short description, and the organisation that provides it. It uses the schema.org Course type in JSON-LD. Search engines use it to understand and list courses, for example in Google's course carousel.

Google's needs are simple. Each course must have a name and a description, and should have a provider, usually an Organization such as a university or training company. To appear in the carousel, the courses also need to be grouped in an ItemList.

Course schema example (JSON-LD)

A complete example you can adapt. Paste it into the page's HTML, or build your own with the generator above.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Course",
  "name": "Introduction to Data Analysis with Python",
  "description": "Learn pandas, charts, and basic statistics over eight weekly lessons.",
  "courseCode": "DATA101",
  "url": "https://learn.example.edu/courses/data-101/",
  "provider": {
    "@type": "Organization",
    "name": "Northbridge Online Learning",
    "sameAs": "https://learn.example.edu/"
  }
}
</script>

Which Google rich result does it enable?

Today, Course markup is used for the Course list rich result, a carousel of courses from one site. It shows each course's name, a shortened description, and the provider.

The richer Course info result, which showed prices, schedules, ratings and course format, was retired in 2025. Google announced it in June and removed the documentation and Search Console report in September. Properties like hasCourseInstance and offers are still valid schema.org, but Google no longer uses them for a rich result.

Required and recommended properties

Property Status Notes
name Required The course title, for example Introduction to Data Analysis with Python.
description Required A short summary. Google shows around 60 characters.
provider Recommended The Organization that publishes the course, with its name and optionally sameAs. Listed as recommended, but Google's guidelines say each course must have a valid provider, so include it.
ItemList.itemListElement Required Needed for the carousel. Each ListItem has a position and a unique url for its course.

Common Course schema mistakes

  • Expecting price, rating, or schedule details in search results. Google dropped the Course info rich result in 2025.
  • Marking up a single course and expecting the carousel. The carousel needs several courses connected with ItemList.
  • Using Course for things that are not courses, such as a blog post series, a single webinar, or a product demo.
  • Writing a long description where the useful part comes after the first 60 characters.
  • Giving several ListItems the same URL. Each course in the list needs its own page or its own anchor.

Building the course list

This generator builds the Course object for one course. For the carousel, add the same markup on each course page, then add an ItemList to the page that lists your courses. Each ListItem needs a position and the url of the course page. If all the course details live on one page, put full Course objects inside the ListItems instead of URLs. It is also worth adding breadcrumb markup so Google understands where each course sits in your site.

Related Tools

Frequently Asked Questions

Does Google still show Course rich results?
Partly. Google retired the detailed Course info result, which showed price, schedule and ratings, in 2025: it was announced in June and the documentation was removed in September. The simpler Course list carousel is still documented. It shows course names, descriptions and providers when a site lists at least three courses.
How many courses do I need for the course carousel?
Google's carousel needs a list of at least three courses from the same site. You mark up each course with Course and connect them with ItemList, either on a summary page that links to each course page or on a single page that holds all the course details.
What counts as a course for this markup?
A series of lessons or lectures that teach a set of skills, such as a university module or a multi-part online programme. A single talk, a general topic page, or a one-off webinar is not a course.
How long should the course description be?
Google displays about 60 characters of the description in the carousel. Write a full description if you like, but make the first 60 characters work on their own.
Is there still a reason to add Course markup?
Yes. Course markup keeps you eligible for the course list carousel, and it gives Bing, AI assistants, and education directories a clean summary of what the course is and who runs it.