PriceSpecification

schema:Thing > schema:Intangible > schema:StructuredValue > schema:PriceSpecification

A structured value representing a monetary amount. Typically, only the subclasses of this type are used for markup.
PropertyExpected TypeDescription
Properties from schema:PriceSpecification
schema:eligibleQuantity schema:QuantitativeValue The interval and unit of measurement of ordering quantities for which the offer or price specification is valid. This allows e.g. specifying that a certain freight charge is valid only for a certain quantity.
schema:eligibleTransactionVolume schema:PriceSpecification The transaction volume, in a monetary unit, for which the offer or price specification is valid, e.g. for indicating a minimal purchasing volume, to express free shipping above a certain order volume, or to limit the acceptance of credit cards to purchases to a certain minimal amount.
schema:maxPrice schema:Number The highest price if the price is a range.
schema:minPrice schema:Number The lowest price if the price is a range.
schema:price schema:Number  or
schema:Text 
The offer price of a product, or of a price component when attached to PriceSpecification and its subtypes.

Usage guidelines:
  • Use the priceCurrency property (with ISO 4217 codes e.g. "USD") instead of including ambiguous symbols such as '$' in the value.
  • Use '.' (Unicode 'FULL STOP' (U+002E)) rather than ',' to indicate a decimal point. Avoid using these symbols as a readability separator.
  • Note that both RDFa and Microdata syntax allow the use of a "content=" attribute for publishing simple machine-readable values alongside more human-friendly formatting.
  • Use values from 0123456789 (Unicode 'DIGIT ZERO' (U+0030) to 'DIGIT NINE' (U+0039)) rather than superficially similiar Unicode symbols.
schema:priceCurrency schema:Text The currency (in 3-letter ISO 4217 format) of the price or a price component, when attached to PriceSpecification and its subtypes.
schema:validFrom schema:DateTime The date when the item becomes valid.
schema:validThrough schema:DateTime The end of the validity of offer, price specification, or opening hours data.
schema:valueAddedTaxIncluded schema:Boolean Specifies whether the applicable value-added tax (VAT) is included in the price specification or not.
Properties from schema:Thing
schema:additionalType schema: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. 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.
schema:alternateName schema:Text An alias for the item.
schema:description schema:Text A short description of the item.
schema:image schema:URL  or
schema:ImageObject 
An image of the item. This can be a URL or a fully described ImageObject.
schema:name schema:Text The name of the item.
schema:potentialAction schema:Action Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role.
schema:sameAs schema:URL URL of a reference Web page that unambiguously indicates the item's identity. E.g. the URL of the item's Wikipedia page, Freebase page, or official website.
schema:url schema:URL URL of the item.


Instances of schema:PriceSpecification may appear as values for the following properties
PropertyOn TypesDescription
schema:baseSalary schema:EmployeeRole  or
schema:JobPosting 
The base salary of the job or of an employee in an EmployeeRole.
schema:eligibleTransactionVolume schema:Offer  or
schema:PriceSpecification  or
schema:Demand 
The transaction volume, in a monetary unit, for which the offer or price specification is valid, e.g. for indicating a minimal purchasing volume, to express free shipping above a certain order volume, or to limit the acceptance of credit cards to purchases to a certain minimal amount.
schema:minimumPaymentDue schema:Invoice The minimum payment required at this time.
schema:netWorth schema:Person The total financial value of the organization or person as calculated by subtracting assets from liabilities.
schema:priceSpecification schema:TradeAction  or
schema:Offer  or
schema:Demand 
One or more detailed price specifications, indicating the unit price and delivery or payment charges.
schema:totalPaymentDue schema:Invoice The total amount due.
schema:totalPrice schema:Ticket  or
schema:Reservation 
The total price for the reservation or ticket, including applicable taxes, shipping, etc.

More specific Types
  • schema:DeliveryChargeSpecification
  • schema:PaymentChargeSpecification
  • schema:UnitPriceSpecification

    Prefixes used:

  • schema: http://schema.org/
  • Acknowledgements

    This class is derived from the GoodRelations Vocabulary for E-Commerce, created by Martin Hepp. GoodRelations is a data model for sharing e-commerce data on the Web that can be expressed in a variety of syntaxes, including RDFa and HTML5 Microdata. More information about GoodRelations can be found at http://purl.org/goodrelations/.

    Examples

    An example of a credit card bill (invoice).
    ACME Bank
    Bill for: January 2015 Visa
    invoice link: http://www.acmebank.com/invoice.pdf
    Customer: Jane Doe
    account ID: xxxx-xxxx-xxxx-1234
    payment due: 2015-01-30
    minimum payment: $15.00
    total due: $200.00
    billing period: 2014-12-21 to 2015-01-20
    payment due
    
    <div itemscope itemtype="http://schema.org/Invoice">
      <h1 itemprop="description">January 2015 Visa</h1>
      <link itemprop="url" href="http://acmebank.com/invoice.pdf" />Invoice PDF
      <div itemprop="broker" itemscope itemtype="http://schema.org/BankOrCreditUnion">
        <b itemprop="name">ACME Bank</b>
      </div>
      <span itemprop="accountId">xxxx-xxxx-xxxx-1234</span>
      <div itemprop="customer" itemscope itemtype="http://schema.org/Person">
        <b itemprop="name">Jane Doe</b>
      </div>
      <span itemprop="paymentDue">2015-01-30</span>
      <div itemprop="minimumPaymentDue" itemscope itemtype="http://schema.org/PriceSpecification">
        <span itemprop="price">15.00</span>
        <span itemprop="priceCurrency">USD</span>
      </div>
      <div itemprop="totalPaymentDue" itemscope itemtype="http://schema.org/PriceSpecification">
        <span itemprop="price">200.00</span>
        <span itemprop="priceCurrency">USD</span>
      </div>
      <meta itemprop="billingPeriod" content="2014-12-21/P30D" />starts:2014-12-21 30 days
      <span itemprop="paymentStatus">payment due</span>
    </div>
     
    
    <div vocab="http://schema.org" typeof="Invoice">
      <h1 property="description">January 2015 Visa</h1>
      <link property="url" href="http://acmebank.com/invoice.pdf" />Invoice PDF
      <div property="broker" itemscope typeof="http://schema.org/BankOrCreditUnion">
        <b property="name">ACME Bank</b>
      </div>
      <span property="accountId">xxxx-xxxx-xxxx-1234</span>
      <div property="customer" typeof="http://schema.org/Person">
        <b property="name">Jane Doe</b>
      </div>
      <span property="paymentDue">2015-01-30</span>
      <div property="minimumPaymentDue" typeof="http://schema.org/PriceSpecification">
        <span property="price">15.00</span>
        <span property="priceCurrency">USD</span>
      </div>
      <div property="totalPaymentDue" typeof="http://schema.org/PriceSpecification">
        <span property="price">200.00</span>
        <span property="priceCurrency">USD</span>
      </div>
      <meta property="billingPeriod" content="2014-12-21/P30D" />starts:2014-12-21 30 days
      <span property="paymentStatus">payment due</span>
    </div>
    
    <script type="application/ld+json">
    {
        "@context": "http://schema.org",
        "@type": "Invoice",
        "description": "January 2015 Visa bill.",
        "url": "http://acmebank.com/invoice.pdf",
        "broker": {
          "@type": "BankOrCreditUnion",
          "name": "ACME Bank",
        },
        "accountId": "xxxx-xxxx-xxxx-1234",
        "customer": {
          "@type": "Person",
          "name": "Jane Doe"
        },
        "paymentDue": "2015-01-30",
        "minimumPaymentDue": {
          "@type": "PriceSpecification",
          "price": 15.00,
          "priceCurrency": "USD"
        },
        "totalPaymentDue": {
          "@type": "PriceSpecification",
          "price": 200.00,
          "priceCurrency": "USD"
        },
        "billingPeriod": "2014-12-21/P30D",
        "paymentStatus": "payment due"
    }
    </script>
    
    An example of a invoice for a purchase and installation.
    ACME Home Heating
    Bill for: New furnace and installation
    Customer: Jane Doe
    payment due: 2015-01-30
    minimum payment: $0.00
    total due: $0.00
    payment status: paid
    order: furnace model ABC123
    order: installation labor
    
    <div itemscope itemtype="http://schema.org/Invoice">
      <h1 itemprop="description">New furnace and installation</h1>
      <div itemprop="broker" itemscope itemtype="http://schema.org/LocalBusiness">
        <b itemprop="name">ACME Home Heating</b>
      </div>
      <div itemprop="customer" itemscope itemtype="http://schema.org/Person">
        <b itemprop="name">Jane Doe</b>
      </div>
      <span itemprop="paymentDue">2015-01-30</span>
      <div itemprop="minimumPaymentDue" itemscope itemtype="http://schema.org/PriceSpecification">
        <span itemprop="price">0.00</span>
        <span itemprop="priceCurrency">USD</span>
      </div>
      <div itemprop="totalPaymentDue" itemscope itemtype="http://schema.org/PriceSpecification">
        <span itemprop="price">0.00</span>
        <span itemprop="priceCurrency">USD</span>
      </div>
      <span itemprop="paymentStatus">paid</span>
      <div itemprop="referencesOrder" itemscope itemtype="http://schema.org/Order">
        <span itemprop="description">furnace</span>
        <span itemprop="orderDate">2014-12-01</span>
        <span itemprop="orderNumber">123ABC</span>
        <div itemprop="orderedItem" itemscope itemtype="http://schema.org/Product">
          <span itemprop="name">ACME Furnace 3000</span>
          <meta itemprop="productId" content="ABC123" />
        </div>
      </div>
      <div itemprop="referencesOrder" itemscope itemtype="http://schema.org/Order">
        <span itemprop="description">furnace installation</span>
        <span itemprop="orderDate">2014-12-02</span>
        <div itemprop="orderedItem" itemscope itemtype="http://schema.org/Service">
          <span itemprop="description">furnace installation</span>
        </div>
      </div>
    </div>
     
    
    <div vocab="http://schema.org" typeof="Invoice">
      <h1 property="description">New furnace and installation</h1>
      <div property="broker" itemscope typeof="http://schema.org/LocalBusiness">
        <b property="name">ACME Home Heating</b>
      </div>
      <div property="customer" typeof="http://schema.org/Person">
        <b property="name">Jane Doe</b>
      </div>
      <span property="paymentDue">2015-01-30</span>
      <div property="minimumPaymentDue" typeof="http://schema.org/PriceSpecification">
        <span property="price">0.00</span>
        <span property="priceCurrency">USD</span>
      </div>
      <div property="totalPaymentDue" typeof="http://schema.org/PriceSpecification">
        <span property="price">0.00</span>
        <span property="priceCurrency">USD</span>
      </div>
      <meta property="billingPeriod" content="2014-12-21/P30D" />starts:2014-12-21 30 days
      <span property="paymentStatus">paid</span>
      <div property="referencesOrder" typeof="Order">
        <span property="description">furnace</span>
        <span property="orderDate">2014-12-01</span>
        <span property="orderNumber">123ABC</span>
        <div property="orderedItem" typeof="Product">
          <span property="name">ACME Furnace 3000</span>
          <meta property="productId" content="ABC123" />
        </div>
      </div>
      <div property="referencesOrder" typeof="Order">
        <span property="description">furnace installation</span>
        <span property="orderDate">2014-12-02</span>
        <div property="orderedItem" typeof="Service">
          <span property="description">furnace installation</span>
        </div>
      </div>
    </div>
    
    <script type="application/ld+json">
    {
        "@context": "http://schema.org",
        "@type": "Invoice",
        "broker": {
          "@type": "LocalBusiness",
          "name": "ACME Home Heating",
        },
        "accountId": "xxxx-xxxx-xxxx-1234",
        "customer": {
          "@type": "Person",
          "name": "Jane Doe"
        },
        "paymentDue": "2015-01-30",
        "minimumPaymentDue": {
          "@type": "PriceSpecification",
          "price": 0.00,
          "priceCurrency": "USD"
        },
        "totalPaymentDue": {
          "@type": "PriceSpecification",
          "price": 0.00,
          "priceCurrency": "USD"
        },
        "paymentStatus": "paid",
        "referencesOrder": [
          {
            "@type": "Order",
            "description": "furnace",
            "orderDate": "2014-12-01",
            "orderNumber": "123ABC",
            "paymentMethod": "http://purl.org/goodrelations/v1#ByInvoice",
            "orderedItem": {
              "@type": "Product",
              "name": "ACME Furnace 3000",
              "productId": "ABC123"
            }
          },
          {
            "@type": "Order",
            "description": "furnace installation",
            "orderDate": "2014-12-02",
            "paymentMethod": "http://purl.org/goodrelations/v1#ByInvoice",
            "orderedItem": {
              "@type": "Service",
              "description": "furnace installation"
            }
          },
        ]
    }
    </script>
        
    

    Schema.org Version 1.93
    BiblioGraph.net Version 1.1
    Code Version 1.1