Note: You are viewing the development version of Schema.org. See how we work for more details.

URL

A Schema.org Type
Data type: URL.

Instances of URL may appear as a value 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
Organization
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. Typically the value is a URI-identified RDF class, and in this case corresponds to the use of rdf:type in RDF. Text values can be used sparingly, for cases where useful information can be added without their being an appropriate schema to reference. In the case of text values, the class label should follow the schema.org style guide.
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.
asin Demand  or
Offer  or
Product
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.).
category ActionAccessSpecification  or
Guide  or
Invoice  or
Offer  or
PhysicalActivity  or
Product  or
Recommendation  or
Service  or
SpecialAnnouncement
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.
colorSwatch Product A color swatch image, visualizing the color of a Product. Should match the textual description specified in the color property. This can be a URL or a fully described ImageObject.
competencyRequired EducationalOccupationalCredential  or
LearningResource
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.
constraintProperty ConstraintNode Indicates a property used as a constraint. For example, in the definition of a StatisticalVariable. The value is a property, either from within Schema.org or from other compatible (e.g. RDF) systems such as DataCommons.org or Wikidata.org.
consumerNotice Product A consumer notice, such as a safety warning or mandatory information, related to the product.
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
Organization
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 Credential 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
Organization
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
Organization
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.
educationalCredentialAwarded Course  or
EducationalOccupationalProgram
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 CreativeWork  or
EducationEvent  or
EducationalOccupationalCredential  or
LearningResource
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 src element of an embed tag and should not be the same as the content of the loc tag.
encodingFormat CreativeWork  or
MediaObject
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.
ethicsPolicy NewsMediaOrganization  or
Organization
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
FinancialService
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.
fuelType EngineSpecification  or
Vehicle
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
VideoGameSeries
Real or fictional location of the game (or part of game).
gamePlatform VideoGame  or
VideoGameSeries
The electronic systems used to play video games.
genre BroadcastChannel  or
CreativeWork  or
MusicGroup
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.
gtin Demand  or
Offer  or
Product
A Global Trade Item Number (GTIN). GTINs identify trade items, including products and services, using numeric identification codes.

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.

The GS1 digital link specifications expresses GTINs as URLs (URIs, IRIs, etc.). Digital Links should be populated into the hasGS1DigitalLink attribute.

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.
hasDigitalProductPassport Offer  or
Product
A link to a Digital Product Passport (DPP) or a digital record detailing the lifecycle, sustainability, and compliance data for this product or offer. This may be a direct URL, a GS1 Digital Link URI, or a nested DigitalProductPassport object. Note: This property is aligned with the IANA 'dpp' link relation and the GS1 Web Vocabulary 'dpp' link type.
hasGS1DigitalLink Offer  or
Organization  or
Place  or
Product
The GS1 digital link associated with the object. This URL should conform to the particular requirements of digital links. The link should only contain the Application Identifiers (AIs) that are relevant for the entity being annotated, for instance a Product or an Organization, and for the correct granularity. In particular, for products:
  • A Digital Link that contains a serial number (AI 21) should only be present on instances of IndividualProduct
  • A Digital Link that contains a lot number (AI