How should you mark up the validity period and pricing unit for a promotional product price?

ProcrustesPR

In Google product structured data, the promotional period should be specified on the node that actually contains the sale price: use validFrom for the start, and choose the end property according to the node type. The pricing unit must make clear “how much this price buys.” You can specify the current price in UnitPriceSpecification and use referenceQuantity to describe the quantity, unit, and reference quantity used for comparison. The key is to ensure that the price, validity period, and quantity align, rather than simply entering a promotion end date or a unit name.

ProcrustesPRProcrustesPRHow to Put Together an Effective Business Website on a Small Budget

Set the promotional start and end dates on the node containing the sale price

First confirm where the current sale price is specified, then choose the date fields. The end-date properties are not freely interchangeable.

  • If the sale price is specified in an Offer’s price, set validFrom on that same Offer and use validThrough or priceValidUntil for the end.
  • If the sale price is defined in PriceSpecification, set validFrom and validThrough on that sale-price node; priceValidUntil does not apply to this type.

Google’s documentation recommends providing both start and end dates and times, and ensuring that the start is no later than the end. Use ISO 8601 format, preferably including the time and time zone so systems can interpret it accurately. For example, 2025-12-31T23:59:59+01:00, as shown in the documentation, includes a date, time, and time zone offset. This is only a formatting example, not a promotional deadline to apply to your products.

Distinguish the quantity sold at the stated price from the comparison basis

Unit pricing involves more than specifying “milliliters” or “meters.” referenceQuantity uses QuantitativeValue to describe the quantity of product offered at the specified price. value and unitCode are required properties, representing the numeric quantity sold and its unit of measurement, respectively. The recommended property valueReference can provide a base quantity for comparing unit prices.

Google’s documentation uses the example of a 200-milliliter bottle of perfume priced at 200 euros: in UnitPriceSpecification, price is 200 and priceCurrency is EUR; within referenceQuantity, value is 200 and unitCode is ML, while the nested valueReference specifies 100 and ML. This corresponds to 200 euros for the whole bottle and 100 euros per 100 milliliters. Do not mistakenly enter the comparison price per 100 milliliters as the price of the whole bottle.

This markup can be used for products sold by volume, length, or weight. The documentation notes that it is particularly important in the European Union, New Zealand, and Australia; that statement alone does not establish legal requirements in those regions.

Avoid misinterpretation caused by duplicate prices and unit codes

If you encode the active price using both offers.price and offers.priceSpecification, Google will use the former and ignore the latter. You should therefore not expect the system to choose the version appropriate for a promotion or unit pricing if you enter different current prices in the two fields.

  • Units can use supported UN/CEFACT codes or the corresponding human-readable versions listed in the documentation; arbitrary unit names are not necessarily supported.
  • sheet and item are supported only in Merchant Center feeds and cannot be used directly in the unit-pricing markup discussed here.
  • If you also mark up the original price, the StrikethroughPrice value of priceType represents the full original price and should not be used for the current sale price. The current sale price must still be provided through the Offer’s price or priceSpecification.
ProcrustesPRProcrustesPRHow Should WordPress and OpenCart Be Compared for SEO?

Promotional product price markup: perspectives from across the web

Can leaving an old end date in place after a promotion ends affect a product listing?

It may. A July 2026 report cited Google documentation stating that a product listing may not appear if priceValidUntil refers to a past date. This is a possible outcome, not a certainty. After a promotion ends, check whether the price and validity period still reflect the actual offer, rather than leaving an old end date as the current promotional deadline.

Must products sold in the European Union, New Zealand, or Australia display a unit price?

Google's documentation alone is not enough to determine whether unit-price labeling is mandatory. It states only that unit pricing is particularly important in these regions for products sold by volume, length, or weight. This does not mean that all products must display a unit price, nor does it establish each region's legal requirements. To confirm whether labeling is required, check the rules that apply to the product category and where it is sold.

ProcrustesPRHow Should Early-Stage Businesses Choose Sales Platforms and Decide When to Build a Website?

References

  1. 如何加入產品摘要結構化資料 | Google 搜尋中心  |  Documentation  |  Google for Developersdevelopers.google.com — Source used in the article above.
  2. 如何新增商家資訊結構化資料 | Google 搜尋中心  |  Documentation  |  Google for Developersdevelopers.google.com — Discusses: Must products sold in the European Union, New Zealand, or Australia display a unit price?
  3. Google’s New Merchant Listing Structured Data Improves SEOwww.searchenginejournal.com · 2026-07-09T10:59:30+00:00 — Discusses: Can leaving an old end date in place after a promotion ends affect a product listing?

Related articles

How to Put Together an Effective Business Website on a Small BudgetHow Should WordPress and OpenCart Be Compared for SEO?How Should Early-Stage Businesses Choose Sales Platforms and Decide When to Build a Website?How to Choose a Blogging or E-Commerce Platform: Compare Your Needs, Maintenance, and Content Control FirstShould a woodworking business use one website or two for local services and online products?With limited resources, should you use your existing website or build a separate site to enter a new product market?How should you choose a pricing model for a shopping cart system?E-commerce platforms vs. web design companies: What is the difference, and how should you choose?
ProcrustesPR
ProcrustesPR