URLA Schema.org Type
- Canonical URL: https://schema.org/URL
- Check for open issues.
Data type: URL.
Instances of URL may appear as a value for the following properties
|acceptsReservations||FoodEstablishment||Indicates whether a FoodEstablishment accepts reservations. Values can be Boolean, an URL at which reservations can be made or (for backwards compatibility) the strings |
|acquireLicensePage||CreativeWork||Indicates a page documenting how licenses can be purchased or otherwise acquired, for the current item.|
|actionPlatform||EntryPoint||The high level platform(s) where the Action can be performed for the given URL. To specify a specific application or operating system instance, use actionApplication.|
|For a NewsMediaOrganization or other news-related Organization, a statement about public engagement activities (for news media, the newsroom’s), including involving the public - digitally or otherwise -- in coverage decisions, reporting and activities after publication.|
|additionalType||Thing||An additional type for the item, typically used for adding more specific types from external vocabularies in microdata syntax. This is a relationship between something and a class that the thing is in. In RDFa syntax, it is better to use the native RDFa syntax - the 'typeof' attribute - for multiple types. Schema.org tools may have only weaker understanding of extra types, in particular those defined externally.|
|afterMedia||HowToDirection||A media object representing the circumstances after performing this direction.|
|applicationCategory||SoftwareApplication||Type of software application, e.g. 'Game, Multimedia'.|
|applicationSubCategory||SoftwareApplication||Subcategory of the application, e.g. 'Arcade Game'.|
|archivedAt||CreativeWork||Indicates a page or other link involved in archival of a CreativeWork. In the case of MediaReview, the items in a MediaReviewItem may often become inaccessible, but be archived by archival, journalistic, activist, or law enforcement organizations. In such cases, the referenced page may not directly publish the content.|
|artMedium||VisualArtwork||The material used. (E.g. Oil, Watercolour, Acrylic, Linoprint, Marble, Cyanotype, Digital, Lithograph, DryPoint, Intaglio, Pastel, Woodcut, Pencil, Mixed Media, etc.)|
|artform||VisualArtwork||e.g. Painting, Drawing, Sculpture, Print, Photograph, Assemblage, Collage, etc.|
|artworkSurface||VisualArtwork||The supporting materials for the artwork, e.g. Canvas, Paper, Wood, Board, etc.|
|An Amazon Standard Identification Number (ASIN) is a 10-character alphanumeric unique identifier assigned by Amazon.com and its partners for product identification within the Amazon organization (summary from Wikipedia's article).|
Note also that this is a definition for how to include ASINs in Schema.org data, and not a definition of ASINs in general - see documentation from Amazon for authoritative details. ASINs are most commonly encoded as text strings, but the [asin] property supports URL/URI as potential values too.
|associatedDisease||BioChemEntity||Disease associated to this BioChemEntity. Such disease can be a MedicalCondition or a URL. If you want to add an evidence supporting the association, please use PropertyValue.|
|bankAccountType||BankAccount||The type of a bank account.|
|beforeMedia||HowToDirection||A media object representing the circumstances before performing this direction.|
|benefitsSummaryUrl||HealthInsurancePlan||The URL that goes directly to the summary of benefits and coverage for the specific standard plan or plan variation.|
|bodyType||Vehicle||Indicates the design and body style of the vehicle (e.g. station wagon, hatchback, etc.).|
|A category for the item. Greater signs or slashes can be used to informally indicate a category hierarchy.|
|childTaxon||Taxon||Closest child taxa of the taxon in question.|
|codeRepository||SoftwareSourceCode||Link to the repository where the un-compiled, human readable code and related code is located (SVN, GitHub, CodePlex).|
|colleague||Person||A colleague of the person.|
|Knowledge, skill, ability or personal attribute that must be demonstrated by a person or other entity in order to do something such as earn an Educational Occupational Credential or understand a LearningResource.|
|contentUrl||MediaObject||Actual bytes of the media object, for example the image file or video file.|
|correction||CreativeWork||Indicates a correction to a CreativeWork, either via a CorrectionComment, textually or in another document.|
|For an Organization (e.g. NewsMediaOrganization), a statement describing (in news media, the newsroom’s) disclosure and correction policy for errors.|
|courseMode||CourseInstance||The medium or means of delivery of the course instance or the mode of study, either as a text label (e.g. "online", "onsite" or "blended"; "synchronous" or "asynchronous"; "full-time" or "part-time") or as a URL reference to a term from a controlled vocabulary (e.g. https://ceds.ed.gov/element/001311#Asynchronous).|
|credentialCategory||EducationalOccupationalCredential||The category or type of credential being described, for example "degree”, “certificate”, “badge”, or more specific term.|
|discussionUrl||CreativeWork||A link to the page containing the comments of the CreativeWork.|
|diseasePreventionInfo||SpecialAnnouncement||Information about disease prevention.|
|diseaseSpreadStatistics||SpecialAnnouncement||Statistical information about the spread of a disease, either as WebContent, or described directly as a Dataset, or the specific Observations in the dataset. When a WebContent URL is provided, the page indicated might also contain more such markup.|
|Statement on diversity policy by an Organization e.g. a NewsMediaOrganization. For a NewsMediaOrganization, a statement describing the newsroom’s diversity policy on both staffing and sources, typically providing staffing data.|
|For an Organization (often but not necessarily a NewsMediaOrganization), a report on staffing diversity issues. In a news context this might be for example ASNE or RTDNA (US) reports, or self-reported.|
|documentation||WebAPI||Further documentation describing the Web API in more detail.|
|downloadUrl||SoftwareApplication||If the file can be downloaded, URL to download the binary.|
|duringMedia||HowToDirection||A media object representing the circumstances while performing this direction.|
|editEIDR||CreativeWork||An EIDR (Entertainment Identifier Registry) identifier representing a specific edit / edition for a work of film or television.|
For example, the motion picture known as "Ghostbusters" whose titleEIDR is "10.5240/7EC7-228A-510A-053E-CBB8-J" has several edits, e.g. "10.5240/1F2A-E1C5-680A-14C6-E76B-I" and "10.5240/8A35-3BEE-6497-5D12-9E4F-3".
Since schema.org types like Movie and TVEpisode can be used for both works and their multiple expressions, it is possible to use titleEIDR alone (for a general description), or alongside editEIDR for a more edit-specific description.
|A description of the qualification, award, certificate, diploma or other educational credential awarded as a consequence of successful completion of this course or program.|
|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.|
|educationalProgramMode||EducationalOccupationalProgram||Similar to courseMode, the medium or means of delivery of the program as a whole. The value may either be a text label (e.g. "online", "onsite" or "blended"; "synchronous" or "asynchronous"; "full-time" or "part-time") or a URL reference to a term from a controlled vocabulary (e.g. https://ceds.ed.gov/element/001311#Asynchronous ).|
|embedUrl||MediaObject||A URL pointing to a player for a specific video. In general, this is the information in the |
|Media type typically expressed using a MIME format (see IANA site and MDN reference), e.g. application/zip for a SoftwareApplication binary, audio/mpeg for .mp3 etc.|
In cases where a CreativeWork has several media type representations, encoding can be used to indicate each MediaObject alongside particular encodingFormat information.
Unregistered or niche encoding and file formats can be indicated instead via the most appropriate URL, e.g. defining Web page or a Wikipedia/Wikidata entry.
|engineType||EngineSpecification||The type of engine or engines powering the vehicle.|
|Statement about ethics policy, e.g. of a NewsMediaOrganization regarding journalistic and publishing practices, or of a Restaurant, a page describing food source policies. In the case of a NewsMediaOrganization, an ethicsPolicy is typically a statement describing the personal, organizational, and corporate standards of behavior expected by the organization.|
|featureList||SoftwareApplication||Features or modules provided by this application (and possibly required by other applications).|
|Description of fees, commissions, and other terms applied either to a class of financial product, or by a financial service organization.|
|fileFormat||CreativeWork||Media type, typically MIME format (see IANA site) of the content, e.g. application/zip of a SoftwareApplication binary. In cases where a CreativeWork has several media type representations, 'encoding' can be used to indicate each MediaObject alongside particular fileFormat information. Unregistered or niche file formats can be indicated instead via the most appropriate URL, e.g. defining Web page or a Wikipedia entry.|
|The type of fuel suitable for the engine or engines of the vehicle. If the vehicle has only one engine, this property can be attached directly to the vehicle.|
|Real or fictional location of the game (or part of game).|
|The electronic systems used to play video games.|
|Genre of the creative work, broadcast channel or group.|
|gettingTestedInfo||SpecialAnnouncement||Information about getting tested (for a MedicalCondition), e.g. in the context of a pandemic.|
|A Global Trade Item Number (GTIN). GTINs identify trade items, including products and services, using numeric identification codes.|
The GS1 digital link specifications express GTINs as URLs (URIs, IRIs, etc.). Details including regular expression examples can be found in, Section 6 of the GS1 URI Syntax specification; see also schema.org tracking issue for schema.org-specific discussion. A correct gtin value should be a valid GTIN, which means that it should be an all-numeric string of either 8, 12, 13 or 14 digits, or a "GS1 Digital Link" URL based on such a string. The numeric component should also have a valid GS1 check digit and meet the other rules for valid GTINs. See also GS1's GTIN Summary and Wikipedia for more details. Left-padding of the gtin values is not required or encouraged. The gtin property generalizes the earlier gtin8, gtin12, gtin13, and gtin14 properties.
Note also that this is a definition for how to include GTINs in Schema.org data, and not a definition of GTINs in general - see the GS1 documentation for authoritative details.
|hasMap||Place||A URL to a map of the place.|
|hasMenu||FoodEstablishment||Either the actual menu as a structured representation, as text, or a URL of the menu.|
|hasMolecularFunction||BioChemEntity||Molecular function performed by this BioChemEntity; please use PropertyValue if you want to include any evidence.|
|hasRepresentation||BioChemEntity||A common representation such as a protein sequence or chemical structure for this entity. For images use schema.org/image.|
|healthPlanMarketingUrl||HealthInsurancePlan||The URL that goes directly to the plan brochure for the specific standard plan or plan variation.|
|identifier||Thing||The identifier property represents any kind of identifier for any kind of Thing, such as ISBNs, GTIN codes, UUIDs etc. Schema.org provides dedicated properties for representing many of these, either as textual strings or as URL (URI) links. See background notes for more details.|
|image||Thing||An image of the item. This can be a URL or a fully described ImageObject.|
|inCodeSet||CategoryCode||A CategoryCodeSet that contains this category code.|
|inDefinedTermSet||DefinedTerm||A DefinedTermSet that contains this term.|
|installUrl||SoftwareApplication||URL at which the app may be installed, if different from the URL of the item.|
|isBasedOn||CreativeWork||A resource from which this work is derived or from which it is a modification or adaption.|
|isBasedOnUrl||CreativeWork||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.|
|isInvolvedInBiologicalProcess||BioChemEntity||Biological process this BioChemEntity is involved in; please use PropertyValue if you want to include any evidence.|
|isLocatedInSubcellularLocation||BioChemEntity||Subcellular location where this BioChemEntity is located; please use PropertyValue if you want to include any evidence.|
|isPartOf||CreativeWork||Indicates an item or CreativeWork that this item, or CreativeWork (in some sense), is part of.|
|Keywords or tags used to describe some item. Multiple textual entries in a keywords list are typically delimited by commas, or by repeating the property.|
|Of a Person, and less typically of an Organization, to indicate a topic that is known about - suggesting possible expertise but not implying it. We do not distinguish skill levels here, or relate this to educational content, events, objectives or JobPosting descriptions.|
|labelDetails||Drug||Link to the drug's label details.|
|layoutImage||FloorPlan||A schematic image showing the floorplan layout.|
|legislationIdentifier||Legislation||An identifier for the legislation. This can be either a string-based identifier, like the CELEX at EU level or the NOR in France, or a web-based, URL/URI identifier, like an ELI (European Legislation Identifier) or an URN-Lex.|
|license||CreativeWork||A license document that applies to this content, typically indicated by URL.|
|loanType||LoanOrCredit||The type of a loan or credit.|
|An associated logo.|
|mainEntityOfPage||Thing||Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See background notes for details.|
|map||Place||A URL to a map of the place.|
|maps||Place||A URL to a map of the place.|
|masthead||NewsMediaOrganization||For a NewsMediaOrganization, a link to the masthead page or a page listing top editorial management.|
|A material that something is made from, e.g. leather, wool, cotton, paper.|
|A technique or technology used in a Dataset (or DataDownload, DataCatalog),
corresponding to the method used for measuring the corresponding variable(s) (described using variableMeasured). This is oriented towards scientific and scholarly dataset publication but may have broader applicability; it is not intended as a full representation of measurement, but rather as a high level summary for dataset discovery.|
For example, if variableMeasured is: molecule concentration, measurementTechnique could be: "mass spectrometry" or "nmr spectroscopy" or "colorimetry" or "immunofluorescence".
If the variableMeasured is "depression rating", the measurementTechnique could be "Zung Scale" or "HAM-D" or "Beck Depression Inventory".
If there are several variableMeasured properties recorded for some given data object, use a PropertyValue for each variableMeasured and attach the corresponding measurementTechnique.
|meetsEmissionStandard||Vehicle||Indicates that the vehicle meets the respective emission standard.|
|memoryRequirements||SoftwareApplication||Minimum memory requirements.|
|menu||FoodEstablishment||Either the actual menu as a structured representation, as text, or a URL of the menu.|
|merchantReturnLink||MerchantReturnPolicy||Specifies a Web page or service by URL, for product returns.|
|missionCoveragePrioritiesPolicy||NewsMediaOrganization||For a NewsMediaOrganization, a statement on coverage priorities, including any public agenda or stance on issues.|
|namedPosition||Role||A position played, performed or filled by a person or organization, as part of an organization. For example, an athlete in a SportsTeam might play in the position named 'Quarterback'.|
|newsUpdatesAndGuidelines||SpecialAnnouncement||Indicates a page with news updates and guidelines. This could often be (but is not required to be) the main page containing SpecialAnnouncement markup on a site.|
|noBylinesPolicy||NewsMediaOrganization||For a NewsMediaOrganization or other news-related Organization, a statement explaining when authors of articles are not named in bylines.|
|A description of the qualification, award, certificate, diploma or other occupational credential awarded as a consequence of successful completion of this course or program.|
|originalMediaLink||MediaReview||Link to the page containing an original version of the content, or directly to an online copy of the original MediaObject content, e.g. video file.|
|For an Organization (often but not necessarily a NewsMediaOrganization), a description of organizational ownership structure; funding and grants. In a news/media setting, this is with particular reference to editorial independence. Note that the funder is also available and can be used to make basic funder information machine-readable.|
|parentTaxon||Taxon||Closest parent taxon of the taxon in question.|
|paymentUrl||Order||The URL for sending a payment.|
|physicalRequirement||JobPosting||A description of the types of physical activity associated with the job. Defined terms such as those in O*net may be used, but note that there is no way to specify the level of ability as well as its nature when using a defined term.|
|prescribingInfo||Drug||Link to prescribing information for the drug.|
|productReturnLink||ProductReturnPolicy||Indicates a Web page or service by URL, for product return.|
|propertyID||PropertyValue||A commonly used identifier for the characteristic represented by the property, e.g. a manufacturer or a standard code for a property. propertyID can be (1) a prefixed string, mainly meant to be used with standards for product properties; (2) a site-specific, non-prefixed string (e.g. the primary key of the property or the vendor-specific ID of the property), or (3) a URL indicating the type of the property, either pointing to an external vocabulary, or a Web resource that describes the property (e.g. a glossary entry). Standards bodies should promote a standard prefix for the identifiers of properties from their standards.|
|publicTransportClosuresInfo||SpecialAnnouncement||Information about public transport closures.|
|The publishingPrinciples property indicates (typically via URL) a document describing the editorial principles of an Organization (or individual, e.g. a Person writing a blog) that relate to their activities as a publisher, e.g. ethics or diversity policies. When applied to a CreativeWork (e.g. NewsArticle) the principles are those of the party primarily responsible for the creation of the CreativeWork.|
While such policies are most typically expressed in natural language, sometimes related information (e.g. indicating a funder) can be expressed using schema.org terminology.
|quarantineGuidelines||SpecialAnnouncement||Guidelines about quarantine rules, e.g. in the context of a pandemic.|
|relatedLink||WebPage||A link related to this web page, for example to other related web pages.|
|releaseNotes||SoftwareApplication||Description of what changed in this version.|
|replyToUrl||UserComments||The URL at which a reply may be posted to the specified UserComment.|
|requirements||SoftwareApplication||Component dependency requirements for application. This includes runtime environments and shared libraries that are not included in the application distribution package, but required to run the application (examples: DirectX, Java or .NET runtime).|
|roleName||Role||A role played, performed or filled by a person or organization. For example, the team of creators for a comic book might fill the roles named 'inker', 'penciller', and 'letterer'; or an athlete in a SportsTeam might play in the position named 'Quarterback'.|
|sameAs||Thing||URL of a reference Web page that unambiguously indicates the item's identity. E.g. the URL of the item's Wikipedia page, Wikidata entry, or official website.|
|schemaVersion||CreativeWork||Indicates (by URL or string) a particular version of a schema used in some CreativeWork. This property was created primarily to
indicate the use of a specific schema.org release, e.g. |
|schoolClosuresInfo||SpecialAnnouncement||Information about school closures.|
|screenshot||SoftwareApplication||A link to a screenshot image of the app.|
|sdLicense||CreativeWork||A license document that applies to this structured data, typically indicated by URL.|
|A season in a media series.|
|securityClearanceRequirement||JobPosting||A description of any security clearance requirements of the job.|
|sensoryRequirement||JobPosting||A description of any sensory requirements and levels necessary to function on the job, including hearing and vision. Defined terms such as those in O*net may be used, but note that there is no way to specify the level of ability as well as its nature when using a defined term.|
|serviceUrl||ServiceChannel||The website to access the service.|
|shippingSettingsLink||OfferShippingDetails||Link to a page containing ShippingRateSettings and DeliveryTimeSettings details.|
|significantLink||WebPage||One of the more significant URLs on the page. Typically, these are the non-navigation links that are clicked on the most.|
|significantLinks||WebPage||The most significant URLs on the page. Typically, these are the non-navigation links that are clicked on the most.|
|softwareRequirements||SoftwareApplication||Component dependency requirements for application. This includes runtime environments and shared libraries that are not included in the application distribution package, but required to run the application (examples: DirectX, Java or .NET runtime).|
|Indicates sections of a Web page that are particularly 'speakable' in the sense of being highlighted as being especially appropriate for text-to-speech conversion. Other sections of a page may also be usefully spoken in particular circumstances; the 'speakable' property serves to indicate the parts most likely to be generally useful for speech.|
The speakable property can be repeated an arbitrary number of times, with three kinds of possible 'content-locator' values:
1.) id-value URL references - uses id-value of an element in the page being annotated. The simplest use of speakable has (potentially relative) URL values, referencing identified sections of the document concerned.
2.) CSS Selectors - addresses content in the annotated page, e.g. via class attribute. Use the cssSelector property.
3.) XPaths - addresses content via XPaths (assuming an XML view of the content). Use the xpath property.
For more sophisticated markup of speakable sections beyond simple ID references, either CSS selectors or XPath expressions to pick out document section(s) as speakable. For this we define a supporting type, SpeakableSpecification which is defined to be a possible value of the speakable property.
|A type of sport (e.g. Baseball).|
|storageRequirements||SoftwareApplication||Storage requirements (free space required).|
|surface||VisualArtwork||A material used as a surface in some artwork, e.g. Canvas, Paper, Wood, Board, etc.|
|target||Action||Indicates a target EntryPoint, or url, for an Action.|
|targetUrl||AlignmentObject||The URL of a node in an established educational framework.|
|taxonRank||Taxon||The taxonomic rank of this taxon given preferably as a URI from a controlled vocabulary – typically the ranks from TDWG TaxonRank ontology or equivalent Wikidata URIs.|
|taxonomicRange||BioChemEntity||The taxonomic grouping of the organism that expresses, encodes, or in some way related to the BioChemEntity.|
|temporalCoverage||CreativeWork||The temporalCoverage of a CreativeWork indicates the period that the content applies to, i.e. that it describes, either as a DateTime or as a textual string indicating a time period in ISO 8601 time interval format. In
the case of a Dataset it will typically indicate the relevant time period in a precise notation (e.g. for a 2011 census dataset, the year 2011 would be written "2011/2012"). Other forms of content, e.g. ScholarlyArticle, Book, TVSeries or TVEpisode, may indicate their temporalCoverage in broader terms - textually or via well-known URL.
Written works such as books may sometimes have precise temporal coverage too, e.g. a work set in 1939 - 1945 can be indicated in ISO 8601 interval format format via "1939/1945".|
Open-ended date ranges can be written with ".." in place of the end date. For example, "2015-11/.." indicates a range beginning in November 2015 and with no specified final date. This is tentative and might be updated in future when ISO 8601 is officially updated.
|termsOfService||Service||Human-readable terms of service documentation.|
|thumbnailUrl||CreativeWork||A thumbnail image relevant to the Thing.|
|ticketToken||Ticket||Reference to an asset (e.g., Barcode, QR code image or PDF) usable for entrance.|
|An EIDR (Entertainment Identifier Registry) identifier representing at the most general/abstract level, a work of film or television.|
For example, the motion picture known as "Ghostbusters" has a titleEIDR of "10.5240/7EC7-228A-510A-053E-CBB8-J". This title (or work) may have several variants, which EIDR calls "edits". See editEIDR.
Since schema.org types like Movie and TVEpisode can be used for both works and their multiple expressions, it is possible to use titleEIDR alone (for a general description), or alongside editEIDR for a more edit-specific description.
|A page providing information on how to book a tour of some Place, such as an Accommodation or ApartmentComplex in a real estate setting, as well as other kinds of tours as appropriate.|
|trackingUrl||ParcelDelivery||Tracking url for the parcel delivery.|
|travelBans||SpecialAnnouncement||Information about travel bans, e.g. in the context of a pandemic.|
|The unit of measurement given using the UN/CEFACT Common Code (3 characters) or a URL. Other codes than the UN/CEFACT Common Code may be used with a prefix followed by a colon.|
|For an Organization (typically a NewsMediaOrganization), a statement about policy on use of unnamed sources and the decision process required.|
|url||Thing||URL of the item.|
|usageInfo||CreativeWork||The schema.org usageInfo property indicates further information about a CreativeWork. This property is applicable both to works that are freely available and to those that require payment or other transactions. It can reference additional information, e.g. community expectations on preferred linking and citation conventions, as well as purchasing details. For something that can be commercially licensed, usageInfo can provide detailed, resource-specific information about licensing options.|
This property can be used alongside the license property which indicates license(s) applicable to some piece of content. The usageInfo property can provide information about other licensing options, e.g. acquiring commercial usage rights for an image that is also available under non-commercial creative commons licenses.
|usesHealthPlanIdStandard||HealthInsurancePlan||The standard for interpreting the Plan ID. The preferred is "HIOS". See the Centers for Medicare & Medicaid Services for more details.|
|vehicleTransmission||Vehicle||The type of component used for transmitting the power from a rotating power source to the wheels or other relevant component(s) ("gearbox" for cars).|
|verificationFactCheckingPolicy||NewsMediaOrganization||Disclosure about verification and fact-checking processes for a NewsMediaOrganization or other fact-checking Organization.|
|warning||Drug||Any FDA or other warnings about the drug (text or URL).|
|The URL for a feed, e.g. associated with a podcast series, blog, or series of date-stamped updates. This is usually RSS or Atom.|