Note: you are viewing the development version of See How we work for more details.


DataType > Text > URL

Data type: URL.
PropertyExpected TypeDescription
Properties from URL
category PhysicalActivityCategory  or
Text  or
A category for the item. Greater signs or slashes can be used to informally indicate a category hierarchy.

Instances of URL may appear as values for the following properties

PropertyOn TypesDescription
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 Yes or No.
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.
actionableFeedbackPolicy NewsMediaOrganization  or
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. 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'.
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. Supersedes, surface.
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.).
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. Supersedes, colleagues.
competencyRequired EducationalOccupationalCredential Knowledge, skill, ability or personal attribute that must be demonstrated by a person or other entity.
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.
correctionsPolicy NewsMediaOrganization  or
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. ).
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.
diversityPolicy NewsMediaOrganization  or
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.
diversityStaffingReport NewsMediaOrganization  or
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.
educationalCredentialAwarded Course  or
A description of the qualification, award, certificate, diploma or other educational credential awarded as a consequence of successful completion of this course or program.
educationalLevel EducationalOccupationalCredential 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. ).
embedUrl MediaObject A URL pointing to a player for a specific video. In general, this is the information in the src element of an embed tag and should not be the same as the content of the loc tag.
encodingFormat CreativeWork  or
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. Supersedes, fileFormat.
engineType EngineSpecification The type of engine or engines powering the vehicle.
ethicsPolicy NewsMediaOrganization  or
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).
feesAndCommissionsSpecification FinancialProduct  or
Description of fees, commissions, and other terms applied either to a class of financial product, or by a financial service organization.
fuelType EngineSpecification  or
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.
gameLocation Game  or
Real or fictional location of the game (or part of game).
gamePlatform VideoGame  or
The electronic systems used to play video games.
genre BroadcastChannel  or
CreativeWork  or
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.
hasMap Place A URL to a map of the place. Supersedes, map maps.
hasMenu FoodEstablishment Either the actual menu as a structured representation, as text, or a URL of the menu. Supersedes, menu.
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. 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. Supersedes, isBasedOnUrl.
isPartOf CreativeWork Indicates an item or CreativeWork that this item, or CreativeWork (in some sense), is part of.
inverse property: hasPart.
knowsAbout Organization  or
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.
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.
logo Brand  or
Organization  or
Place  or
Product  or
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.
inverse property: mainEntity.
masthead NewsMediaOrganization For a NewsMediaOrganization, a link to the masthead page or a page listing top editorial management.
material CreativeWork  or
A material that something is made from, e.g. leather, wool, cotton, paper.
measurementTechnique DataCatalog  or
DataDownload  or
Dataset  or
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.
merchantReturnLink MerchantReturnPolicy Indicates a Web page or service by URL, for product return. Supersedes, productReturnLink.
missionCoveragePrioritiesPolicy NewsMediaOrganization For a NewsMediaOrganization, a statement on coverage priorities, including any public agenda or stance on issues.
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.
occupationalCredentialAwarded Course  or
A description of the qualification, award, certificate, diploma or other occupational credential awarded as a consequence of successful completion of this course or program.
ownershipFundingInfo NewsMediaOrganization  or
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.
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.
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.
publishingPrinciples CreativeWork  or
Organization  or
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 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.
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'. Supersedes, namedPosition.
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. For example, a document could declare a schemaVersion using an URL such as if precise indication of schema version was required by some application.
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.
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.
significantLink WebPage One of the more significant URLs on the page. Typically, these are the non-navigation links that are clicked on the most. Supersedes, significantLinks.
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). Supersedes, requirements.
speakable Article  or
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, eg. 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.
sport SportsEvent  or
A type of sport (e.g. Baseball).
storageRequirements SoftwareApplication Storage requirements (free space required).
targetUrl AlignmentObject The URL of a node in an established educational framework.
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. Supersedes, datasetTimeInterval.
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.
tourBookingPage Accommodation  or
ApartmentComplex  or
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.
unitCode PropertyValue  or
QuantitativeValue  or
TypeAndQuantityNode  or
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.
unnamedSourcesPolicy NewsMediaOrganization  or
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 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 thePlan 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).
webFeed PodcastSeries 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.