---
title: "Liquid filters: weight_with_unit"
description: |-
  Generates a formatted weight for a [`variant` object](/docs/api/liquid/objects/variant#variant-weight). The weight unit is
  set in the [general settings](https://www.shopify.com/admin/settings/general) in the Shopify admin.
api_name: liquid
source_url:
  html: https://shopify.dev/docs/api/liquid/filters/weight_with_unit
  md: https://shopify.dev/docs/api/liquid/filters/weight_with_unit.md
---

# weight\_​with\_​unit

```oobleck
number | weight_with_unit
```

returns [string](https://shopify.dev/docs/api/liquid/basics#string)

Generates a formatted weight for a [`variant` object](https://shopify.dev/docs/api/liquid/objects/variant#variant-weight). The weight unit is set in the [general settings](https://www.shopify.com/admin/settings/general) in the Shopify admin.

```liquid
{%- assign variant = product.variants.first -%}


{{ variant.weight | weight_with_unit }}
```

##### Code

```
{%- assign variant = product.variants.first -%}

{{ variant.weight | weight_with_unit }}
```

##### Data

```
{
  "product": {
    "variants": [
      {
        "weight": 200
      },
      {
        "weight": 200
      },
      {
        "weight": 400
      },
      {
        "weight": 200
      }
    ]
  }
}
```

## Output

```html
0.2 kg
```

### Override the default unit

```oobleck
number | weight_with_unit: variable
```

You can specify a unit to override the default from the general settings.

```liquid
{%- assign variant = product.variants.first -%}


{{ variant.weight | weight_with_unit: variant.weight_unit }}
```

##### Code

```
{%- assign variant = product.variants.first -%}

{{ variant.weight | weight_with_unit: variant.weight_unit }}
```

##### Data

```
{
  "product": {
    "variants": [
      {
        "weight": 200,
        "weight_unit": "g"
      },
      {
        "weight": 200,
        "weight_unit": "g"
      },
      {
        "weight": 400,
        "weight_unit": "g"
      },
      {
        "weight": 200,
        "weight_unit": "g"
      }
    ]
  }
}
```

## Output

```html
200 g
```