Skip to content

MonetaryAmount ​

Breadcrumb: Thing > Intangible > StructuredValue > MonetaryAmount

A monetary value or range. This type can be used to describe an amount of money such as $50 USD, or a range as in describing a bank account being suitable for a balance between £1,000 and £1,000,000 GBP, or the value of a salary, etc. It is recommended to use PriceSpecification Types to describe the price of an Offer, Invoice, etc.

Parent types ​

StructuredValue

Properties ​

Properties for MonetaryAmount ​

PropertyExpected typeDefined onDescription
currencyTextMonetaryAmountThe currency in which the monetary amount is expressed. Use standard formats: ISO 4217 currency format, e.g. "USD"; Ticker symbol for cryptocurrencies, e.g. "BTC"; well known names for Local Exchange Trading Systems (LETS) and other currency types, e.g. "Ithaca HOUR".
maxValueNumberMonetaryAmountThe upper value of some characteristic or property.
minValueNumberMonetaryAmountThe lower value of some characteristic or property.
validFromDate, DateTimeMonetaryAmountThe date when the item becomes valid.
validThroughDate, DateTimeMonetaryAmountThe date after when the item is not valid. For example the end of an offer, salary period, or a period of opening hours.
valueBoolean, Number, StructuredValue, TextMonetaryAmountThe value of a QuantitativeValue (including Observation) or property value node. * For QuantitativeValue and MonetaryAmount, the recommended type for values is 'Number'. * For PropertyValue, it can be 'Text', 'Number', 'Boolean', or 'StructuredValue'. * Use values from 0123456789 (Unicode 'DIGIT ZERO' (U+0030) to 'DIGIT NINE' (U+0039)) rather than superficially similar Unicode symbols. * Use '.' (Unicode 'FULL STOP' (U+002E)) rather than ',' to indicate a decimal point. Avoid using these symbols as a readability separator.

Inherited properties ​

PropertyExpected typeInherited fromDescription
additionalTypeText, URLThingAn 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.
alternateNameTextThingAn alias for the item.
descriptionText, TextObjectThingA description of the item.
disambiguatingDescriptionTextThingA sub property of description. A short description of the item used to disambiguate from other, similar items. Information from other properties (in particular, name) may be necessary for the description to be useful for disambiguation.
identifierPropertyValue, Text, URLThingThe 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.
imageImageObject, URLThingAn image of the item. This can be a URL or a fully described ImageObject.
mainEntityOfPageCreativeWork, URLThingIndicates a page (or other CreativeWork) for which this thing is the main entity being described. See background notes for details.
nameTextThingThe name of the item.
ownerOrganization, PersonThingA person or organization who owns this Thing.
potentialActionActionThingIndicates a potential Action, which describes an idealized action in which this thing would play an 'object' role.
sameAsURLThingURL 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.
subjectOfCreativeWork, EventThingA CreativeWork or Event about this Thing.
urlURLThingURL of the item.

Example ​

json
{
  "@context": "https://schema.org",
  "@type": "MonetaryAmount",
  "name": "Example Name",
  "description": "A short description.",
  "url": "/example",
  "currency": "Example value",
  "maxValue": "Example value"
}