---
title: UnitPriceMeasurement - Storefront API
description: |
  The measurement data used to calculate unit prices for a [`ProductVariant`](/docs/api/storefront/2026-01/objects/ProductVariant). Unit pricing helps customers compare costs across different package sizes by showing a standardized price, such as "$9.99 / 100ml".

  The object includes the quantity being sold (value and unit) and the reference measurement used for price comparison. Use this alongside the variant's [`unitPrice`](/docs/api/storefront/2026-01/objects/ProductVariant#field-ProductVariant.fields.unitPrice) field to display complete unit pricing information.
api_version: 2026-01
api_name: storefront
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/storefront/latest/objects/unitpricemeasurement
  md: https://shopify.dev/docs/api/storefront/latest/objects/unitpricemeasurement.md
---

# Unit​Price​Measurement

object

The measurement data used to calculate unit prices for a [`ProductVariant`](https://shopify.dev/docs/api/storefront/2026-01/objects/ProductVariant). Unit pricing helps customers compare costs across different package sizes by showing a standardized price, such as "$9.99 / 100ml".

The object includes the quantity being sold (value and unit) and the reference measurement used for price comparison. Use this alongside the variant's [`unitPrice`](https://shopify.dev/docs/api/storefront/2026-01/objects/ProductVariant#field-ProductVariant.fields.unitPrice) field to display complete unit pricing information.

## Fields

* measured​Type

  [Unit​Price​Measurement​Measured​Type](https://shopify.dev/docs/api/storefront/latest/enums/UnitPriceMeasurementMeasuredType)

  The type of unit of measurement for the unit price measurement.

* quantity​Unit

  [Unit​Price​Measurement​Measured​Unit](https://shopify.dev/docs/api/storefront/latest/enums/UnitPriceMeasurementMeasuredUnit)

  The quantity unit for the unit price measurement.

* quantity​Value

  [Float!](https://shopify.dev/docs/api/storefront/latest/scalars/Float)

  non-null

  The quantity value for the unit price measurement.

* reference​Unit

  [Unit​Price​Measurement​Measured​Unit](https://shopify.dev/docs/api/storefront/latest/enums/UnitPriceMeasurementMeasuredUnit)

  The reference unit for the unit price measurement.

* reference​Value

  [Int!](https://shopify.dev/docs/api/storefront/latest/scalars/Int)

  non-null

  The reference value for the unit price measurement.

***

## Map

### Fields with this object

* [ProductVariant.unitPriceMeasurement](https://shopify.dev/docs/api/storefront/latest/objects/ProductVariant#field-ProductVariant.fields.unitPriceMeasurement)