What Is Course Schema?

Published
14 min read

What Is Course Schema?

Course schema is structured data that identifies an educational curriculum made of lectures, lessons or modules designed to build specific knowledge, competence or ability for enrolled learners.

The Course type describes the curriculum itself: its name, description, provider, prerequisites, outcomes and credentials. A CourseInstance can represent a particular cohort, schedule, location, instructor or delivery mode. A Course list uses ItemList to organize several course entities for discovery.

Markup does not turn a short video, sales webinar, public event or article into a course. It cannot verify instruction quality, accreditation or learning outcomes. The visible program, enrollment process and provider evidence must support every educational claim.

  1. Identify the exact page, asset, entity or relationship described in this section.
  2. Inspect the live implementation and retain the observed evidence.
  3. Compare the observation with the intended meaning and its primary specification.
  4. Correct any mismatch, then retest the live result.
  5. Record the accountable owner and review date.
What Is Course Schema? reference table
Property or nodeRepresentsEvidence source
CourseReusable curriculumAcademic or training catalog
nameCourse titlePublic course page
descriptionSubject and learning scopeApproved syllabus
providerOrganization delivering courseInstitution record
courseCodeStable catalog codeCourse system
coursePrerequisitesRequired prior knowledgeAdmissions policy
educationalCredentialAwardedCompletion credentialCredential policy
hasCourseInstanceSpecific offeringEnrollment schedule
syllabusSectionsCurriculum modulesPublished syllabus
  • Model a real curriculum with learning outcomes.
  • Separate the course from each scheduled offering.
  • Ground provider and credential claims in records.

Primary specification: Schema.org definition for Course.

Course schema describes a genuine structured learning program, not any content that teaches one isolated fact.

How Does Course Schema Work?

Course schema works by creating one curriculum identity and connecting it to its provider, description, prerequisites, outcomes and one or more CourseInstance offerings.

A parser reads the Course name, short description and provider, then follows list or instance relationships. An ItemList can enumerate course URLs in a stable order. A CourseInstance can identify when and where the curriculum is delivered, its instructor, mode and offer.

Syntax validation cannot prove that students enroll, instructors lead the program or a credential is recognized. The catalog, learning-management system, enrollment system and institutional policy remain authoritative. Template output should follow those sources rather than duplicate manually maintained marketing fields.

  • The exact page, asset, entity or relationship covered by this section
  • The live implementation rather than an editor-only preview
  • The primary specification or first-party record defining the expected behavior
  • The validation result, accountable owner and review date
How Does Course Schema Work? reference table
StageGraph actionFailure example
DefineAssign one Course identityIndividual lesson treated as whole course
DescribeMap subject and outcomesPromotional slogan used as description
ProvideConnect real institutionAffiliate called provider
StructureLink syllabus and prerequisitesModules absent from visible page
OfferCreate CourseInstanceCohort schedule merged into Course
ListAdd ordered ItemList URLsSearch results copied dynamically
MaintainSync catalog and enrollmentRetired course remains open
  1. Confirm the content meets the course definition.
  2. Create a stable curriculum identity.
  3. Map provider, outcomes and prerequisites.
  4. Connect current course instances.
  5. Validate catalog and enrollment paths.

The graph works when one stable curriculum connects to truthful providers, learning details and current offerings.

Course vs CourseInstance vs Event

Course represents the reusable curriculum, CourseInstance represents one delivery of that curriculum and Event represents a scheduled experience that may not provide a structured course or learner roster.

An SEO fundamentals curriculum can remain the same across spring and fall cohorts. Each cohort can differ by instructor, start date, location or online mode and therefore becomes a CourseInstance. A one-hour public SEO webinar is usually an Event rather than a Course when it lacks a curriculum sequence and roster.

Self-paced courses can still have an instance or offer context when learners enroll and complete a structured program. A single tutorial article or two-minute video remains content, not a Course, even when educational.

  1. Identify the exact page, asset, entity or relationship described in this section.
  2. Inspect the live implementation and retain the observed evidence.
  3. Compare the observation with the intended meaning and its primary specification.
  4. Correct any mismatch, then retest the live result.
  5. Record the accountable owner and review date.
Course vs CourseInstance vs Event reference table
Learning situationPrimary typeWhy
Reusable SEO curriculumCourseDefines subject and modules
Fall cohort of that curriculumCourseInstanceSpecific schedule and instructor
Self-paced enrolled programCourse plus suitable instance or offerStructured learner journey
One public webinarEventSingle scheduled presentation
Conference workshop seriesEvent or Course based on real structureEvaluate curriculum and roster
Single tutorial videoVideoObjectNot a curriculum
Wiki guideArticleEditorial educational content
Course catalogItemList plus Course itemsOrganizes multiple curricula
  • Separate reusable content from delivery.
  • Do not label every webinar a course.
  • Use content types for isolated lessons and guides.

Use Course for curriculum, CourseInstance for a particular offering and Event for scheduled experiences without a full course structure.

Which Course Schema Properties Matter Most?

The most important Course properties are name, description and provider, followed by stable URL or ID, course code, prerequisites, outcomes, syllabus, language and instance relationships.

Current Course list documentation requires a name and description for each represented course and uses provider as a supported high-value field. Course titles should contain only the real curriculum name, not prices, discounts or “best course” claims. Descriptions should state the subject and outcome concisely.

The provider should be the organization that delivers the source course content, connected through Organization schema. Add credentials only when the institution actually awards them under a documented policy.

  • The exact page, asset, entity or relationship covered by this section
  • The live implementation rather than an editor-only preview
  • The primary specification or first-party record defining the expected behavior
  • The validation result, accountable owner and review date
Which Course Schema Properties Matter Most? reference table
PropertyPriorityAudit question
nameRequired for supported Course listIs it the real course title?
descriptionRequired for supported Course listDoes it state subject and outcome?
providerSupported and importantWho delivers the curriculum?
url or @idHighDoes it resolve to the canonical course?
courseCodeUsefulIs the code stable in the catalog?
coursePrerequisitesUsefulAre requirements visible and current?
educationalCredentialAwardedConditionalIs the credential genuinely awarded?
availableLanguageUsefulCan learners complete the course in that language?
hasCourseInstanceUsefulAre current offerings connected?
  1. Use the canonical course name.
  2. Write a specific learning description.
  3. Reference the real provider.
  4. Add catalog and prerequisite facts.
  5. Connect only genuine credentials and instances.

Start with a clear course identity, concise learning description and real provider before adding credentials, instances or catalog detail.

How Does Course List Markup Use ItemList?

Course list markup uses ItemList and ordered ListItem entries to connect at least three Course items, each with a unique canonical URL, name, description and provider.

The list can live on a summary page that links to course detail pages or on one all-in-one page with anchored course sections. Positions should reflect a stable visible order, not personalization or paid placement hidden from users. Each URL must identify the corresponding course.

A detail page used in the course list should contain its Course data and be paired with the list architecture. Search and filter pages are poor sources when their order and contents change by session. Feature eligibility does not guarantee a displayed list.

  1. Identify the exact page, asset, entity or relationship described in this section.
  2. Inspect the live implementation and retain the observed evidence.
  3. Compare the observation with the intended meaning and its primary specification.
  4. Correct any mismatch, then retest the live result.
  5. Record the accountable owner and review date.
How Does Course List Markup Use ItemList? reference table
List requirementImplementationFailure example
Minimum item countAt least three Course itemsOne course marked as carousel
List containerItemListUnrelated Course nodes without list
List entryListItemRaw URL array
positionStable integer orderDuplicate or missing positions
urlUnique canonical course URLSame URL for every item
nameReal course titlePrice or promo phrase
descriptionConcise course scopeGeneric provider slogan
providerReal delivering organizationMarketplace mistaken for instructor
  • Publish at least three qualifying courses.
  • Keep positions and URLs visible and stable.
  • Pair list pages with complete detail pages.

A valid course list is a stable visible collection of at least three real courses with ordered unique destinations.

How Should Course Instances, Modes and Schedules Be Modeled?

CourseInstance should represent a specific run of a Course with its actual mode, instructor, schedule, location, language and enrollment offer.

Two cohorts of the same curriculum may have different dates, instructors or tuition and should not overwrite one another. Online, in-person and blended delivery need accurate courseMode and location context. A self-paced instance can state its real access pattern without inventing fixed class dates.

Enrollment windows, capacity and pricing belong to the offering or instance context. Do not leave a past cohort marked open because the curriculum remains available. Connect instructors through real Person profiles only when they actually lead that instance.

  • The exact page, asset, entity or relationship covered by this section
  • The live implementation rather than an editor-only preview
  • The primary specification or first-party record defining the expected behavior
  • The validation result, accountable owner and review date
How Should Course Instances, Modes and Schedules Be Modeled? reference table
Offering caseInstance modelQuality check
Spring classroom cohortCourseInstance with schedule and PlaceDates and campus are exact
Live online cohortCourseInstance with online modeSession access follows enrollment
Blended programCourseInstance with mixed delivery detailsOn-site and online requirements clear
Self-paced enrollmentCourseInstance or offer contextNo invented meeting schedule
Two instructors by cohortDistinct instance instructor relationshipsActual assignments represented
Rolling monthly startsSeparate or patterned instances by system designAvailable dates remain current
Past cohortClosed or archived instanceNo active enrollment offer
Same curriculum in SpanishLanguage-specific instance or course policyLearner can complete in stated language
  1. Separate curriculum from scheduled delivery.
  2. Assign real mode, dates and location.
  3. Connect current instructor and language.
  4. Map enrollment offer and capacity.
  5. Close past instances promptly.

CourseInstance keeps time, place, instructor and enrollment facts out of the reusable curriculum identity.

How Should Providers, Instructors and Credentials Be Used?

Provider should identify the organization delivering the course, instructors should identify the people teaching a specific curriculum or instance and credentials should reflect awards actually granted after completion.

A marketplace that hosts third-party courses is not always the provider of each curriculum. Distinguish the platform, institution and instructor from operational evidence. Instructor biographies should avoid invented expertise and connect to ProfilePage identities when profiles exist.

A completion badge, attendance certificate, academic credit and professional credential are different outcomes. Use educationalCredentialAwarded or related properties only when the named award is real and the public page explains its issuer and conditions.

  1. Identify the exact page, asset, entity or relationship described in this section.
  2. Inspect the live implementation and retain the observed evidence.
  3. Compare the observation with the intended meaning and its primary specification.
  4. Correct any mismatch, then retest the live result.
  5. Record the accountable owner and review date.
How Should Providers, Instructors and Credentials Be Used? reference table
Role or outcomeCorrect relationshipAvoid
University delivering curriculumprovider OrganizationHosting vendor as provider
Independent instructor’s own courseProvider and instructor roles as supportedInvented institution
Marketplace hosting partner courseSeparate platform and provider identitiesMarketplace automatically claimed as teacher
Named cohort instructorPerson on CourseInstanceGeneric staff page
Completion certificateCredential when genuinely awardedAttendance treated as certification
Academic creditnumberOfCredits with institutional basisInvented credit value
Professional license preparationDescription of preparationClaiming license is awarded
Accreditation claimVisible verified institutional evidenceUnverified badge
  • Separate platform, provider and instructor.
  • Connect teaching roles to real instances.
  • Describe credentials and credit precisely.

Course authority should come from truthful provider, instructor and credential relationships rather than promotional titles or fabricated accreditation.

What Course Schema Mistakes Are Common?

Common Course schema mistakes include marking single videos or events as courses, publishing fewer than three items for Course list eligibility, using promotional titles, assigning the wrong provider and leaving retired instances active.

Catalog templates can create duplicate Course IDs for each cohort, fragmenting one curriculum. The opposite problem merges distinct programs under one generic identity. Personalized lists may output unstable positions and URLs that require login.

Educational claims require particular care. Markup should not imply accreditation, guaranteed employment, transferable credit or professional licensing without evidence. Validation cannot test instructional quality or legal recognition.

  • The exact page, asset, entity or relationship covered by this section
  • The live implementation rather than an editor-only preview
  • The primary specification or first-party record defining the expected behavior
  • The validation result, accountable owner and review date
What Course Schema Mistakes Are Common? reference table
MistakeLearner or SEO riskCorrection
Single tutorial marked CourseWrong educational modelUse Article, Video or HowTo
Public webinar marked CourseNo curriculum or rosterUse Event
Two-item Course listDoes not meet supported list minimumUse at least three qualifying courses
Price in course namePromotional titleUse curriculum title only
Marketplace as false providerWrong institution identityIdentify actual provider
Cohort creates new curriculum IDFragmented CourseUse CourseInstance
Expired cohort remains openFailed enrollmentClose instance and offer
Unverified credential claimMisleading outcomeVerify or remove
  1. Confirm each item meets the course definition.
  2. Reconcile Course and CourseInstance IDs.
  3. Verify provider and instructor roles.
  4. Audit list count, order and URLs.
  5. Test credentials and enrollment status.

Course markup fails when curriculum, provider, credential, list or enrollment facts are exaggerated, merged or stale.