---
title: UnitPriceMeasurement - Storefront API
description: >-
  The measurement data used to calculate unit prices for a
  [`ProductVariant`](/docs/api/storefront/2026-07/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-07/objects/ProductVariant#field-ProductVariant.fields.unitPrice)

  field to display complete unit pricing information.
api_version: 2026-07
source_url:
  html: 'https://shopify.dev/docs/api/storefront/latest/objects/UnitPriceMeasurement'
  md: >-
    https://shopify.dev/docs/api/storefront/latest/objects/UnitPriceMeasurement.md
api_name: storefront
api_type: graphql
type: object
---

# Unit​Price​Measurement

object

The measurement data used to calculate unit prices for a [`ProductVariant`](https://shopify.dev/docs/api/storefront/2026-07/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-07/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)