Source: Schema.org v30.1 offline vocabulary. Official MonetaryAmount definition.
What is 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.
Example JSON-LD skeleton
This minimal example only identifies a Schema.org type. It is not a complete entity, a Google rich-result test, or a claim about a real business.
{
"@context": "https://schema.org",
"@type": "MonetaryAmount"
}Full parent hierarchy
Each chain starts at a root type. Multiple paths are shown when Schema.org defines more than one parent. For very complex types, up to 256 paths are displayed; consult the official definition for the full graph.
- Thing → Intangible → StructuredValue → MonetaryAmount
Direct parents: StructuredValue
Child types (0)
No entries listed in the available snapshot.
Properties that accept MonetaryAmount values (27)
| Property | On types | Description |
|---|---|---|
| accountMinimumInflow | BankAccount | A minimum amount that has to be paid in every month. |
| accountOverdraftLimit | BankAccount | An overdraft is an extension of credit from a lending institution when an account reaches zero. An overdraft allows the individual to continue withdrawing money even if the account has no funds in it. Basically the bank allows people to borrow a set amount of money. |
| amount | DatedMoneySpecification or InvestmentOrDeposit or LoanOrCredit or MonetaryGrant or MoneyTransfer | The amount of money. |
| baseSalary | EmployeeRole or JobPosting | The base salary of the job or of an employee in an EmployeeRole. |
| customerRemorseReturnShippingFeesAmount | MerchantReturnPolicy | The amount of shipping costs if a product is returned due to customer remorse. Applicable when property [[customerRemorseReturnFees]] equals [[ReturnShippingFees]]. |
| downPayment | RepaymentSpecification | a type of payment made in cash during the onset of the purchase of an expensive good/service. The payment typically represents only a percentage of the full purchase price. |
| earlyPrepaymentPenalty | RepaymentSpecification | The amount to be paid as a penalty in the event of early payment of the loan. |
| estimatedCost | HowTo or HowToSupply | The estimated cost of the supply or supplies consumed when performing instructions. |
| estimatedSalary | JobPosting or Occupation | An estimated salary for a job posting or occupation, based on a variety of variables including, but not limited to industry, job title, and location. Estimated salaries are often computed by outside organizations rather than the hiring organization, who may not have committed to the estimated value. |
| exchangeRateSpread | ExchangeRateSpecification | The difference between the price at which a broker or other intermediary buys and sells foreign currency. |
| floorLimit | PaymentCard | A floor limit is the amount of money above which credit card transactions must be authorized. |
| freeShippingThreshold | ShippingRateSettings | A monetary value above (or at) which the shipping rate becomes free. Intended to be used via an [[OfferShippingDetails]] with [[shippingSettingsLink]] matching this [[ShippingRateSettings]]. |
| hasTierRequirement | MemberProgramTier | A requirement for a user to join a membership tier, for example: a CreditCard if the tier requires sign up for a credit card, A UnitPriceSpecification if the user is required to pay a (periodic) fee, or a MonetaryAmount if the user needs to spend a minimum amount to join the tier. If a tier is free to join then this property does not need to be specified. |
| incomeLimit | FinancialIncentive | Optional. Income limit for which the incentive is applicable for. <p>If MonetaryAmount is specified, this should be based on annualized income (e.g. if an incentive is limited to those making <$114,000 annually):</p> { "@type": "MonetaryAmount", "maxValue": 114000, "currency": "USD", } Use Text for incentives that are limited based on other criteria, for example if an incentive is only available to recipients making 120% of the median poverty income in their area. |
| itemDefectReturnShippingFeesAmount | MerchantReturnPolicy | Amount of shipping costs for defect product returns. Applicable when property [[itemDefectReturnFees]] equals [[ReturnShippingFees]]. |
| loanMortgageMandateAmount | MortgageLoan | Amount of mortgage mandate that can be converted into a proper mortgage at a later stage. |
| loanPaymentAmount | RepaymentSpecification | The amount of money to pay in a single payment. |
| minimumOrderValue | ShippingRateSettings | The minimum order value required for this shipping rate to apply. |
| minimumPaymentDue | Invoice | The minimum payment required at this time. |
| monthlyMinimumRepaymentAmount | PaymentCard | The minimum payment is the lowest amount of money that one is required to pay on a credit card statement each month. |
| netWorth | Person | The total financial value of the person as calculated by subtracting the total value of liabilities from the total value of assets. |
| orderValue | ShippingConditions | Minimum and maximum order value for which these shipping conditions are valid. |
| purchasePriceLimit | FinancialIncentive | Optional. The maximum price the item can have and still qualify for this offer. |
| restockingFee | MerchantReturnPolicy or MerchantReturnPolicySeasonalOverride | Use [[MonetaryAmount]] to specify a fixed restocking fee for product returns, or use [[Number]] to specify a percentage of the product price paid by the customer. |
| returnShippingFeesAmount | MerchantReturnPolicy or MerchantReturnPolicySeasonalOverride | Amount of shipping costs for product returns (for any reason). Applicable when property [[returnFees]] equals [[ReturnShippingFees]]. |
| shippingRate | OfferShippingDetails or ShippingConditions or ShippingRateSettings | The shipping rate is the cost of shipping to the specified destination. Typically, the maxValue and currency values (of the [[MonetaryAmount]]) are most appropriate. |
| totalPaymentDue | Invoice | The total amount due. |
Properties usable on MonetaryAmount (19)
This list includes properties whose domainIncludes names MonetaryAmount or one of its ancestors. DomainIncludes is advisory; it is not an exhaustive set of permitted properties.
| Property | Expected value types | Description |
|---|---|---|
| additionalType | Text, URL | 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 <a href="https://schema.org/docs/styleguide.html">style guide</a>. |
| alternateName | Text | An alias for the item. |
| currency | Text | The currency in which the monetary amount is expressed.\n\nUse standard formats: [ISO 4217 currency format](http://en.wikipedia.org/wiki/ISO_4217), e.g. "USD"; [Ticker symbol](https://en.wikipedia.org/wiki/List_of_cryptocurrencies) for cryptocurrencies, e.g. "BTC"; well known names for [Local Exchange Trading Systems](https://en.wikipedia.org/wiki/Local_exchange_trading_system) (LETS) and other currency types, e.g. "Ithaca HOUR". |
| description | Text, TextObject | A description of the item. |
| disambiguatingDescription | Text | A 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. |
| identifier | PropertyValue, Text, URL | 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](/docs/datamodel.html#identifierBg) for more details. |
| image | ImageObject, URL | An image of the item. This can be a [[URL]] or a fully described [[ImageObject]]. |
| mainEntityOfPage | CreativeWork, URL | Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See [background notes](/docs/datamodel.html#mainEntityBackground) for details. |
| maxValue | Number | The upper value of some characteristic or property. |
| minValue | Number | The lower value of some characteristic or property. |
| name | Text | The name of the item. |
| owner | Organization, Person | A person or organization who owns this Thing. |
| potentialAction | Action | Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role. |
| sameAs | URL | 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. |
| subjectOf | CreativeWork, Event | A CreativeWork or Event about this Thing. |
| url | URL | URL of the item. |
| validFrom | Date, DateTime | The date when the item becomes valid. |
| validThrough | Date, DateTime | The date after when the item is not valid. For example the end of an offer, salary period, or a period of opening hours. |
| value | Boolean, Number, QualitativeValue, StructuredValue, Text | The value of a [[QuantitativeValue]] (including [[Observation]]) or property value node.\n\n* For [[QuantitativeValue]] and [[MonetaryAmount]], the recommended type for values is 'Number'.\n* For [[PropertyValue]], it can be 'Text', 'Number', 'Boolean', 'StructuredValue' or 'QualitativeValue'.\n* Use values from 0123456789 (Unicode 'DIGIT ZERO' (U+0030) to 'DIGIT NINE' (U+0039)) rather than superficially similar Unicode symbols.\n* Use '.' (Unicode 'FULL STOP' (U+002E)) rather than ',' to indicate a decimal point. Avoid using these symbols as a readability separator. |
Schema.org vs Google
This type's presence in Schema.org is not a Google feature approval. Check our dated Google status snapshot and Google's official Rich Results Test separately.