Course DRAFT Profile

This specification must be used in tandem with a courseInstance. A course is used to describe the broad, common aspects of a recurring training event - whereas a course instance is about the specific times and location of when that course is held.

Summary of Changes

Changes since previous draft 0.8 of the Course profile:

Update ranges as per latest version of schema.org

Latest profiles

Latest release: none

Latest draft: 0.9-DRAFT-2020_12_08

Previous profiles

Previous version: 0.8-DRAFT-2020_10_06

Group	Use Cases	Cross Walk	Task & Issues	Examples	Live Deploys
Training

Key to specification table

Green properties/types are proposed by Bioschemas, or indicate proposed changes by Bioschemas to Schema.org
Red properties/types exist in the core of Schema.org
Blue properties/types exist in the pending area of Schema.org
Black properties/types are reused from external vocabularies/ontologies

CD = Cardinality

View all examples

//Property: about
"about": [
    {
      "@type": "DefinedTerm", 
      "@id": "http://edamontology.org/topic_3316",
      "inDefinedTermSet": "http://edamontology.org",
      "termCode": "topic_3316",
      "name": "Computer Science",
      "url": "https://bioportal.bioontology.org/ontologies/EDAM/?p=classes&conceptid=http%3A%2F%2Fedamontology.org%2Ftopic_3316"
    },
    {
      "@type": "DefinedTerm", 
      "@id": "http://edamontology.org/topic_3314",
      "inDefinedTermSet": "http://edamontology.org",
      "termCode": "topic_3314",
      "name": "Chemistry",
      "url": "http://bioportal.bioontology.org/ontologies/EDAM/?p=classes&conceptid=http%3A%2F%2Fedamontology.org%2Ftopic_3314"
    }
]


//Property: abstract
"abstract": "This course will take you through the basic usage of the command line shell. In it, you will discover what a shell is, skills for directory navigation, file manipulation, and how to run tools."


//Property: accessibilitySummary
"accessibilitySummary": "Visual elements are not described."



//Property: aggregateRating
"aggregateRating": "4/5"


//Property: alternateName
"alternateName": "Comp-sci 101"


//Property: audience
"audience": "PhD students, Post-docs"


//Property: citation
"citation": [
  "@type": "CreativeWork",
  "identifier": "https://reference.site/creativework"
]


//Property: comment
"comment": "This course is excellent for gaining the foundations of operating systems"


//Property: commentCount
"commentCount": "37"


//Property: courseCode
"courseCode": "CS101"


//Property: coursePrerequisites
"coursePrerequisites": [
     {
          "@type": "AlignmentObject",
          "alignmentType": "educationalLevel",
          "educationalFramework": "QAA",
          "targetName": "Higher Education Credit Framework For England",
          "targetUrl": "https://www.qaa.ac.uk/docs/qaa/quality-code/academic-credit-framework.pdf?sfvrsn=940bf781_12"
    },
    {
        "@type": "Course",
        //Minimal
        "name": "Foundation Course in CS",
        "description": "This course introduces you to the very basic, foundational concepts of computers and programming",
        "keywords": "CS, foundation, course, eLearning",
        //Recommended
        "url": "http://my-training.site/myPrerequisiteCourse",
        "timeRequired": "P1W2DT5H",
        "educationalLevel": "beginner"
    }
]


//Property: creator
"creator":  [{
  "@type": "Person",
  "name": "Elizabeth Windsor"
},{ 
  "@type": "Organization",
  "name": "University of Manchester"
}]


//Property: dateCreated
"dateCreated": "2019-02-18 09:00:00 +0000"


//Property: dateModified
"dateModified": "2019-03-28 13:25:13 +0000"


//Property: description
"description": "This is a course ran at an institution. It's ran periodically - specific courses can be found through CourseInstances."


//Property: educationalCredentialAwarded
"educationalCredentialAwarded": "Certified Software Carpentry Instructor"


//Property: educationalLevel
"educationalLevel": "Intermediate"


//Property: hasCourseInstance
"hasCourseInstance": [
    {
      "@type": "CourseInstance",
      //Minimal
      "courseMode": "online",
      "location": {
          "@type": "Place",
          "address": {
            "@type": "PostalAddress",
            "streetAddress": "1.17, Kilburn Building, University of Manchester",
            "addressLocality": "Manchester",
            "addressRegion": "Greater Manchester",
            "addressCountry": "United Kingdom",
            "postalCode": "M13 9PL"
          }
      },
      //Recommended
      "url": "http://my-training.site/myCourse/courseInstance",
      "inLanguage": "en-GB",
      "instructor": [{
        "@type": "Person",
        "name": "John Smith"
      },{ 
        "@type": "Person",
        "name": "Bob Jones"
      }],
      "startDate": "2019-02-04T11:00:00",
      "endDate": "2019-02-05T17:00:00",
      "offers":     {
            "@type": "Offer",
            "price": "100.00",
            "priceCurrency": "GBP",
            "url": "http://www.eventbrite.com/my-workshop"
      },
      "mentions": [{
          "@type": "Tool",
          "name": "Galaxy",
          "url": "https://bio.tools/galaxy",
          "description": "Open, web-based platform for data intensive biomedical research"
       },
       {
          "@type": "Dataset",
          "name": "European Genome-phenome Archive",
          "url": "https://www.ebi.ac.uk/ega/home",
          "description": "The EGA archives a large number of datasets, the access to which is controlled by a Data Access Committee (DAC)."
        }],
    }
]


//Property: hasPart
"hasPart": [{
  "@type": "TrainingMaterial",

  //Minimum
  "name": "Course Slides for CS101",
  "description": "The course slides contain diagrams, questions, and links to various resources about this course",
  "keywords": "Computer Science, CS, Introductory",

  //Recommended
  "timeRequired": "P1W2DT5H",
  "learningResourceType": "slides",
  "url": "http://example.com/slides_website",
  "license": "https://creativecommons.org/licenses/by/4.0/",
  "skillLevel": "beginner",
  "identifier": "http://identifiers.org/my-org/13412",
  "about": [{
      "@type": "DefinedTerm", 
      "@id": "http://edamontology.org/topic_3316",
      "inDefinedTermSet": "http://edamontology.org",
      "termCode": "topic_3316",
      "name": "Computer Science",
      "url": "https://bioportal.bioontology.org/ontologies/EDAM/?p=classes&conceptid=http%3A%2F%2Fedamontology.org%2Ftopic_3316"
  }],
  "inLanguage": "en-GB",
  "mentions": [{
      "@type": "Tool",
      "name": "Galaxy",
      "url": "https://bio.tools/galaxy",
      "description": "Open, web-based platform for data intensive biomedical research"
   }]
}]


//Property: image
"image": "https://image.server.com/my-image.jpg"


//Property: isBasedOn
"isBasedOn": [{
  "@type": "Course",

  //Minimum
  "name": "Based on this Course Name XX",
  "description": "This couse XX is ran at insitution YY every fall.",
  "keywords": "RNA-Seq, Viruses, Short course"
  }
]


//Property: keywords
"keywords": "RNA-Seq, Workshop"


//Property: license
"license": "CC-BY 2.0 CA"


//Property: mentions
"mentions": [{
  "@type": "Tool",
  "name": "Galaxy",
  "url": "https://bio.tools/galaxy",
  "description": "Open, web-based platform for data intensive biomedical research"
},{
  "@type": "Dataset",
  "name": "European Genome-phenome Archive",
  "url": "https://www.ebi.ac.uk/ega/home",
  "description": "The EGA archives a large number of datasets, the access to which is controlled by a Data Access Committee (DAC)."
}]


//Property: name
"name": "My Course"


//Property: provider
"provider":  [{ 
  "@type": "Organization",
  "name": "University of Manchester"
}]


//Property: teaches
"teaches": [
  "The student will be able to recall shell commands", 
  "The student will be able to write code to copy files", 
  "The student will be able to discover new commands on their own"
]


//Property: thumbnailUrl
"thumbnailUrl": "https://image.server.com/my-image.jpg"


//Property: timeRequired
"timeRequired": "P3D"


//Property: url
"url": "https://training.site/123"

Property	Expected Type	Description	CD	Controlled Vocabulary	Example
Marginality: Minimum.
description	Text	Schema: A description of the item.	ONE		View ≪description≫ example Property ≪description≫ example `"description": "This is a course ran at an institution. It's ran periodically - specific courses can be found through CourseInstances."`
keywords	DefinedTerm Text URL	Schema: Keywords or tags used to describe this content. Multiple entries in a keywords list are typically delimited by commas. Bioschemas: Free text keywords delimited by commas describing the Course content.	ONE		View ≪keywords≫ example Property ≪keywords≫ example `"keywords": "RNA-Seq, Workshop"`
name	Text	Schema: The name of the item.	ONE		View ≪name≫ example Property ≪name≫ example `"name": "My Course"`
Marginality: Recommended.
about	Thing	Schema: The subject matter of the content. Inverse property: subjectOf. Bioschemas: The subject of this Course. Use the DefinedTerm type to add a controlled vocabulary term to categorise the course (such as using the EDAM Topic ontology).	MANY	EDAM term	View ≪about≫ example Property ≪about≫ example "about": [ { "@type": "DefinedTerm", "@id": "http://edamontology.org/topic_3316", "inDefinedTermSet": "http://edamontology.org", "termCode": "topic_3316", "name": "Computer Science", "url": "https://bioportal.bioontology.org/ontologies/EDAM/?p=classes&conceptid=http%3A%2F%2Fedamontology.org%2Ftopic_3316" }, { "@type": "DefinedTerm", "@id": "http://edamontology.org/topic_3314", "inDefinedTermSet": "http://edamontology.org", "termCode": "topic_3314", "name": "Chemistry", "url": "http://bioportal.bioontology.org/ontologies/EDAM/?p=classes&conceptid=http%3A%2F%2Fedamontology.org%2Ftopic_3314" } ]
abstract	Text	Schema: An abstract is a short description that summarizes a CreativeWork Bioschemas: An abstract is a short description that summarizes a Course	ONE		View ≪abstract≫ example Property ≪abstract≫ example `"abstract": "This course will take you through the basic usage of the command line shell. In it, you will discover what a shell is, skills for directory navigation, file manipulation, and how to run tools."`
aggregateRating	AggregateRating	Schema: The overall rating, based on a collection of reviews or ratings, of the item.	ONE		View ≪aggregateRating≫ example Property ≪aggregateRating≫ example `"aggregateRating": "4/5"`
citation	CreativeWork Text	Schema: A citation or reference to another creative work, such as another publication, web page, scholarly article, etc.	MANY		View ≪citation≫ example Property ≪citation≫ example `"citation": [ "@type": "CreativeWork", "identifier": "https://reference.site/creativework" ]`
coursePrerequisites	AlignmentObject Course Text	Schema: Requirements for taking the Course. May be completion of another Course or a textual description like “permission of instructor”. Requirements may be a pre-requisite competency, referenced using AlignmentObject.	MANY		View ≪coursePrerequisites≫ example Property ≪coursePrerequisites≫ example "coursePrerequisites": [ { "@type": "AlignmentObject", "alignmentType": "educationalLevel", "educationalFramework": "QAA", "targetName": "Higher Education Credit Framework For England", "targetUrl": "https://www.qaa.ac.uk/docs/qaa/quality-code/academic-credit-framework.pdf?sfvrsn=940bf781_12" }, { "@type": "Course", //Minimal "name": "Foundation Course in CS", "description": "This course introduces you to the very basic, foundational concepts of computers and programming", "keywords": "CS, foundation, course, eLearning", //Recommended "url": "http://my-training.site/myPrerequisiteCourse", "timeRequired": "P1W2DT5H", "educationalLevel": "beginner" } ]
educationalLevel	DefinedTerm Text URL	Schema: The level in terms of progression through an educational or training context. Examples of educational levels include ‘beginner’, ‘intermediate’ or ‘advanced’, and formal sets of level indicators. Bioschemas: The level expected to be able to participate in the course. Examples of educational levels include ‘beginner’, ‘intermediate’ or ‘advanced’.	ONE	Beginner Internediate Advanced	View ≪educationalLevel≫ example Property ≪educationalLevel≫ example `"educationalLevel": "Intermediate"`
hasCourseInstance	CourseInstance	Schema: An offering of the course at a specific time and place or through specific media or mode of study or to a specific section of students. Bioschemas: A course may be ran multiple times in different locations or at different times. Use hasCourseInstance to list the offerings of this Course. Please see the Course Instance specification for the full list of properties.	MANY		View ≪hasCourseInstance≫ example Property ≪hasCourseInstance≫ example "hasCourseInstance": [ { "@type": "CourseInstance", //Minimal "courseMode": "online", "location": { "@type": "Place", "address": { "@type": "PostalAddress", "streetAddress": "1.17, Kilburn Building, University of Manchester", "addressLocality": "Manchester", "addressRegion": "Greater Manchester", "addressCountry": "United Kingdom", "postalCode": "M13 9PL" } }, //Recommended "url": "http://my-training.site/myCourse/courseInstance", "inLanguage": "en-GB", "instructor": [{ "@type": "Person", "name": "John Smith" },{ "@type": "Person", "name": "Bob Jones" }], "startDate": "2019-02-04T11:00:00", "endDate": "2019-02-05T17:00:00", "offers": { "@type": "Offer", "price": "100.00", "priceCurrency": "GBP", "url": "http://www.eventbrite.com/my-workshop" }, "mentions": [{ "@type": "Tool", "name": "Galaxy", "url": "https://bio.tools/galaxy", "description": "Open, web-based platform for data intensive biomedical research" }, { "@type": "Dataset", "name": "European Genome-phenome Archive", "url": "https://www.ebi.ac.uk/ega/home", "description": "The EGA archives a large number of datasets, the access to which is controlled by a Data Access Committee (DAC)." }], } ]
license	CreativeWork URL	Schema: A license document that applies to this content, typically indicated by URL. Bioschemas: If the Course has an open-source license, include the short URL, as found in OSI. Otherwise use CreativeWork to describe your custom license.	ONE		View ≪license≫ example Property ≪license≫ example `"license": "CC-BY 2.0 CA"`
mentions	Thing	Schema: Indicates that the CreativeWork contains a reference to, but is not necessarily about a concept. Bioschemas: Datasets, tools, technologies, entities etc, which are actively used by and/or referred to by this course. If this varies in a CourseInstance, use the CourseInstance version of mentions to override this mentions.	MANY		View ≪mentions≫ example Property ≪mentions≫ example `"mentions": [{ "@type": "Tool", "name": "Galaxy", "url": "https://bio.tools/galaxy", "description": "Open, web-based platform for data intensive biomedical research" },{ "@type": "Dataset", "name": "European Genome-phenome Archive", "url": "https://www.ebi.ac.uk/ega/home", "description": "The EGA archives a large number of datasets, the access to which is controlled by a Data Access Committee (DAC)." }]`
provider	Organization Person	Schema: The service provider, service operator, or service performer; the goods producer. Another party (a seller) may offer those services or goods on behalf of the provider. A provider may also serve as the seller. Supersedes carrier. Bioschemas: The organization responsible for providing the educational input for the course, e.g. content, assessments, accreditation etc. Note: providing a course goes beyond creating it as it implies some degree of academic responsibility for accrediting the content of the course, perhaps running assessments etc.	MANY		View ≪provider≫ example Property ≪provider≫ example `"provider": [{ "@type": "Organization", "name": "University of Manchester" }]`
teaches	DefinedTerm Text	Schema: The item being described is intended to help a person learn the competency or learning outcome defined by the referenced term. Bioschemas: Statements that describe what knowledge, skills or abilities students should acquire on completion of this Course	MANY	It is recommended that you utilize terms from the Blooms taxonomy	View ≪teaches≫ example Property ≪teaches≫ example `"teaches": [ "The student will be able to recall shell commands", "The student will be able to write code to copy files", "The student will be able to discover new commands on their own" ]`
timeRequired	Duration	Schema: Approximate or typical time it takes to work with or through this learning resource for the typical intended target audience, e.g. ‘P30M’, ‘P1H25M’. Bioschemas: Approximate or typical time it takes to work through this learning resource for the typical intended target audience, e.g. ‘P30M’, ‘P1H25M’. This should use the ISO 8601 duration format. If this varies in a CourseInstance, use duration in CourseInstance to override timeRequired.	ONE	ISO 8601	View ≪timeRequired≫ example Property ≪timeRequired≫ example `"timeRequired": "P3D"`
url	URL	Schema: URL of the item. Bioschemas: The preferred URL of the course page. You must provide this value if it is known.	ONE		View ≪url≫ example Property ≪url≫ example `"url": "https://training.site/123"`
Marginality: Optional.
accessibilitySummary	Text	Schema: A human-readable summary of specific accessibility features or deficiencies, consistent with the other accessibility metadata but expressing subtleties such as “short descriptions are present but long descriptions will be needed for non-visual users” or “short descriptions are present and no long descriptions are needed.” Bioschemas: A human-readable summary of specific accessibility features or deficiencies within the course.	ONE		View ≪accessibilitySummary≫ example Property ≪accessibilitySummary≫ example `"accessibilitySummary": "Visual elements are not described."`
alternateName	Text	Schema: An alias for the item.	MANY		View ≪alternateName≫ example Property ≪alternateName≫ example `"alternateName": "Comp-sci 101"`
audience	Audience	Schema: An intended audience, i.e. a group for whom something was created. Supersedes serviceAudience. Bioschemas: The type of audience intended for your course. A succinct description of the attendees.	MANY		View ≪audience≫ example Property ≪audience≫ example `"audience": "PhD students, Post-docs"`
comment	Comment	Schema: Comments, typically from users.	MANY		View ≪comment≫ example Property ≪comment≫ example `"comment": "This course is excellent for gaining the foundations of operating systems"`
commentCount	Integer	Schema: The number of comments this CreativeWork (e.g. Article, Question or Answer) has received. This is most applicable to works published in Web sites with commenting system; additional comments may exist elsewhere.	ONE		View ≪commentCount≫ example Property ≪commentCount≫ example `"commentCount": "37"`
courseCode	Text	Schema: The identifier for the Course used by the course provider (e.g. CS101 or 6.001).	MANY		View ≪courseCode≫ example Property ≪courseCode≫ example `"courseCode": "CS101"`
creator	Organization Person	Schema: The creator/author of this CreativeWork. This is the same as the Author property for CreativeWork. Bioschemas: The creator/author of the course. Note, this may be different from the instructor who delivers it (descibed in CourseInstance), or the author who created the training materials used.	MANY		View ≪creator≫ example Property ≪creator≫ example `"creator": [{ "@type": "Person", "name": "Elizabeth Windsor" },{ "@type": "Organization", "name": "University of Manchester" }]`
dateCreated	Date DateTime	Schema: The date on which the CreativeWork was created or the item was added to a DataFeed.	ONE		View ≪dateCreated≫ example Property ≪dateCreated≫ example `"dateCreated": "2019-02-18 09:00:00 +0000"`
dateModified	Date DateTime	Schema: The date on which the CreativeWork was most recently modified or when the item’s entry was modified within a DataFeed.	MANY		View ≪dateModified≫ example Property ≪dateModified≫ example `"dateModified": "2019-03-28 13:25:13 +0000"`
educationalCredentialAwarded	EducationalOccupationalCredential Text URL	Schema: A description of the qualification, award, certificate, diploma or other educational credential awarded as a consequence of successful completion of this course. Bioschemas: Strongly recommended if exists. A description of the qualification, award, certificate, diploma or other educational credential awarded as a consequence of successful completion of this course.	ONE		View ≪educationalCredentialAwarded≫ example Property ≪educationalCredentialAwarded≫ example `"educationalCredentialAwarded": "Certified Software Carpentry Instructor"`
hasPart	CreativeWork	Schema: Indicates an item or CreativeWork that is part of this item, or CreativeWork (in some sense). Inverse property: isPartOf. Bioschemas: A training material used in a course such as an exercise, handouts, or slides. Inverse property: isPartOf. If this varies in a CourseInstance, use workFeatutred to override this property value.	MANY		View ≪hasPart≫ example Property ≪hasPart≫ example "hasPart": [{ "@type": "TrainingMaterial", //Minimum "name": "Course Slides for CS101", "description": "The course slides contain diagrams, questions, and links to various resources about this course", "keywords": "Computer Science, CS, Introductory", //Recommended "timeRequired": "P1W2DT5H", "learningResourceType": "slides", "url": "http://example.com/slides_website", "license": "https://creativecommons.org/licenses/by/4.0/", "skillLevel": "beginner", "identifier": "http://identifiers.org/my-org/13412", "about": [{ "@type": "DefinedTerm", "@id": "http://edamontology.org/topic_3316", "inDefinedTermSet": "http://edamontology.org", "termCode": "topic_3316", "name": "Computer Science", "url": "https://bioportal.bioontology.org/ontologies/EDAM/?p=classes&conceptid=http%3A%2F%2Fedamontology.org%2Ftopic_3316" }], "inLanguage": "en-GB", "mentions": [{ "@type": "Tool", "name": "Galaxy", "url": "https://bio.tools/galaxy", "description": "Open, web-based platform for data intensive biomedical research" }] }]
image	ImageObject URL	Schema: An image of the item. This can be a URL or a fully described ImageObject.	ONE		View ≪image≫ example Property ≪image≫ example `"image": "https://image.server.com/my-image.jpg"`
isBasedOn	CreativeWork Product URL	Schema: A resource that was used in the creation of this resource. This term can be repeated for multiple sources. For example, http://example.com/great-multiplication-intro.html. Supersedes isBasedOnUrl. Bioschemas: A course, book or other resource on which this Course is based.	MANY		View ≪isBasedOn≫ example Property ≪isBasedOn≫ example `"isBasedOn": [{ "@type": "Course", //Minimum "name": "Based on this Course Name XX", "description": "This couse XX is ran at insitution YY every fall.", "keywords": "RNA-Seq, Viruses, Short course" } ]`
thumbnailUrl	URL	Schema: A thumbnail image relevant to the Thing.	ONE		View ≪thumbnailUrl≫ example Property ≪thumbnailUrl≫ example `"thumbnailUrl": "https://image.server.com/my-image.jpg"`