Duration for which an educational occupational credential is valid

Educational and occupational credentials in schema.org
Wiki Navigation
Main Page
Outline use cases
Proposals to meet requirements Issues arising
Example sites
Other useful links
Community group home page
email list for group
schema.org Git hub issue

Educational and occupational credentials are often only valid for a limited duration, for example a license to practice may require renewal after two years.

Discussion: EOCred: Coverage & renewal of credential thread from Mar 2018.

Proposal

The existing schema.org property validFor covers this use case for Permits, so the proposal is to extended the domain and definition for this property.

Name: validFor

Definition: The duration of validity of the permit or credential.

Expected Range: Duration

Note: This is the duration for which any of this type of credential will be valid, not the time at which a credential that has been issued to an individual will expire.

Draft code for schema.org

This copy on the wiki is for ease of reference only, the definitive version is the file on github

 
<div typeof="rdf:Property" resource="http://schema.org/validFor">
  <span class="h" property="rdfs:label">validFor</span>
  <span property="rdfs:comment">The duration of validity of the permit or credential.</span>
  <span>Domain: <a property="http://schema.org/domainIncludes" href="http://schema.org/Permit">Permit</a></span>
  <span>Domain: <a property="http://schema.org/domainIncludes" href="http://schema.org/EducationalOccupationalCredential"> 
                     EducationalOccupationalCredential</a></span>
  <span>Range: <a property="http://schema.org/rangeIncludes" href="http://schema.org/Duration">Duration</a></span>
</div>

Test output on appspot (may be slow to load).

Examples

Note: These examples should not be taken as being authoritative or accurate descriptions of the resources on which they are based.

1. Nursing credential

This copy is for ease of reference only. The definitive version is in file issue-1779-examples.txt on github, which may be more extensive.

{  
  "@context": "http://schema.org/",
  "@type": "EducationalOccupationalCredential",
  "@id": "http://example.state.wa.us/Nursing",
  "name": "License to practice Nursing",
  "inLanguage": "en-US",
  "validFor": "P2Y"
}