---
title: 'Liquid objects: address'
description: 'An address, such as a customer address or order shipping address.'
api_name: liquid
source_url:
  html: 'https://shopify.dev/docs/api/liquid/objects/address'
  md: 'https://shopify.dev/docs/api/liquid/objects/address.md'
---

# address

An address, such as a customer address or order shipping address.

***

Tip

Use the [`format_address` filter](https://shopify.dev/docs/api/liquid/filters/format_address) to output an address according to its locale.

***

## Properties

* * address1

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

  * The first line of the address.

  * address2

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

  * The second line of the address.

    If no second line is specified, then `nil` is returned.

  * city

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

  * The city of the address.

  * company

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

  * The company of the address.

    If no company is specified, then `nil` is returned.

  * country

    [country](https://shopify.dev/docs/api/liquid/objects/country)

  * The country of the address.

  * country\_​code

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

  * The country of the address in [ISO 3166-1 (alpha 2) format](https://www.iso.org/glossary-for-iso-3166.html).

  * first\_​name

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

  * The first name of the address.

  * id

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

  * The ID of the address.

  * last\_​name

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

  * The last name of the address.

  * name

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

  * A combination of the first and last names of the address.

  * phone

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

  * The phone number of the address.

    If no phone number is specified, then `nil` is returned.

  * province

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

  * The province of the address.

  * province\_​code

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

  * The province of the address in [ISO 3166-2 (alpha 2) format](https://www.iso.org/glossary-for-iso-3166.html).

    Note

    The value doesn't include the preceding [ISO 3166-1](https://www.iso.org/glossary-for-iso-3166.html) country code.

  * street

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

  * A combination of the first and second lines of the address.

  * summary

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

  * A summary of the address, including the following properties:

    * First and last name
    * First and second lines
    * City
    * Province
    * Country

  * url

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

  * The relative URL for the address.

    Note

    This only applies to customer addresses.

  * zip

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

  * The zip or postal code of the address.

```json
{
  "address1": "150 Elgin Street",
  "address2": "8th floor",
  "city": "Ottawa",
  "company": "Polina's Potions, LLC",
  "country": {},
  "country_code": "CA",
  "first_name": null,
  "id": 56174706753,
  "last_name": null,
  "name": "",
  "phone": "416-123-1234",
  "province": "Ontario",
  "province_code": "ON",
  "street": "150 Elgin Street, 8th floor",
  "summary": "150 Elgin Street, 8th floor, Ottawa, Ontario, Canada",
  "url": "/account/addresses/56174706753",
  "zip": "K2P 1L4"
}
```

##### Example

```
{
  "address1": "150 Elgin Street",
  "address2": "8th floor",
  "city": "Ottawa",
  "company": "Polina's Potions, LLC",
  "country": {},
  "country_code": "CA",
  "first_name": null,
  "id": 56174706753,
  "last_name": null,
  "name": "",
  "phone": "416-123-1234",
  "province": "Ontario",
  "province_code": "ON",
  "street": "150 Elgin Street, 8th floor",
  "summary": "150 Elgin Street, 8th floor, Ottawa, Ontario, Canada",
  "url": "/account/addresses/56174706753",
  "zip": "K2P 1L4"
}
```