---
title: WeightUnit - Storefront API
description: >-
  Units of measurement for weight, supporting both metric and imperial systems.
  Used by
  [`ProductVariant`](/docs/api/storefront/2026-04/objects/ProductVariant)

  to specify the unit for the variant's weight value.
api_version: 2026-04
source_url:
  html: 'https://shopify.dev/docs/api/storefront/latest/enums/WeightUnit'
  md: 'https://shopify.dev/docs/api/storefront/latest/enums/WeightUnit.md'
api_name: storefront
api_type: graphql
type: enum
---

# Weight​Unit

enum

Units of measurement for weight, supporting both metric and imperial systems. Used by [`ProductVariant`](https://shopify.dev/docs/api/storefront/2026-04/objects/ProductVariant) to specify the unit for the variant's weight value.

## Valid values

* GRAMS

  Metric system unit of mass.

* KILOGRAMS

  1 kilogram equals 1000 grams.

* OUNCES

  Imperial system unit of mass.

* POUNDS

  1 pound equals 16 ounces.

***

## Fields

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

  OBJECT

  A specific version of a [product](https://shopify.dev/docs/api/storefront/current/objects/Product) available for sale, differentiated by options like size or color. For example, a small blue t-shirt and a large blue t-shirt are separate variants of the same product. For more information, see the docs on [Shopify's product model](https://shopify.dev/docs/apps/build/product-merchandising/products-and-collections).

  For products with quantity rules, variants enforce minimum, maximum, and increment constraints on purchases.

  Variants also support subscriptions and pre-orders through [selling plan allocations](https://shopify.dev/docs/api/storefront/current/objects/SellingPlanAllocation) objects, bundle configurations through [product variant components](https://shopify.dev/docs/api/storefront/current/objects/ProductVariantComponent) objects, and [shop pay installments pricing](https://shopify.dev/docs/api/storefront/current/objects/ShopPayInstallmentsPricing) for flexible payment options.

***

## Map

### Fields with this enum

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