---
title: "CustomerAddress - Liquid Object Reference"
source: https://support.storeconnect.com/articles/customer-address-liquid-object-reference
type: article
format: markdown
site: StoreConnect Support — product and developer documentation for StoreConnect
site_index: https://storeconnect.com/llms.txt
docs_index: https://support.storeconnect.com/llms.txt
note: Append .md to any page or article URL on this site to get its Markdown form.
---
# CustomerAddress - Liquid Object Reference

## Description

The CustomerAddress object is one entry in a customer's address book. Reach the list through `current_customer.addresses`, which returns only the signed-in customer's saved entries. The address book belongs to the contact rather than the account, so colleagues on one account never see each other's entries.


```liquid

{% for entry in current_customer.addresses %}
  <p>
    {{ entry.label | default: entry.address.city }}
    {% if entry.is_default_shipping? %}(default shipping){% endif %}
    <a href="{{ entry.edit_path }}">Edit</a>
  </p>
{% endfor %}
```


## Attributes

| Attribute | Type | Description |
|-----------|------|-------------|
| `address` | Address | The address itself. See [Address - Liquid Object Reference](address-liquid-object-reference) |
| `contact` | Contact | The Contact this entry belongs to |
| `edit_path` | String | Path to the page that displays the edit form for this entry |
| `id` | String | The unique id for this entry |
| `is_default_billing?` | Boolean | Returns true when this is the contact's default billing address |
| `is_default_shipping?` | Boolean | Returns true when this is the contact's default shipping address |
| `label` | String | An optional label the customer gave the entry, such as `Home` or `Warehouse` |
| `path` | String | Path to this entry, which a form posts to in order to update or delete it |

The address fields sit on the nested `address` attribute, not at the top level, so a book entry and a cart or order address expose the same field surface for the same data. Read `entry.address.street` and `entry.address.city`, and only the entry's own metadata directly on the entry.

## Available on

- [Contact - Liquid Object Reference](contact-liquid-object-reference) — `addresses`

## Pre-filling a form

Use `current_customer.preferred_shipping_address` and `current_customer.preferred_billing_address` to pre-fill an address form. They return the customer's default entry for that type, or the account's own address when the customer has no default. This is also the only way the account's own address reaches a theme.

They are not CustomerAddress objects. They return a plain [Address](address-liquid-object-reference) with no `id`, `label` or `contact`, and they never return nil, so you do not need to check whether they are present.


```liquid

{% assign ship_to = current_customer.preferred_shipping_address %}
<input name="city" value="{{ ship_to.city }}">
```


:::note
A theme cannot tell whether the customer set an explicit default. `preferred_shipping_address` returns the same shape either way, and there are no `default_shipping_address` or `default_billing_address` attributes on the customer, so a template cannot prompt a customer to set a default address.
:::

---

## Follow StoreConnect

- [Email Newsletter](https://storeconnect.com/c/lp-newsletter)
- [LinkedIn Newsletter](https://www.linkedin.com/build-relation/newsletter-follow?entityUrn=7444956928444862464)
- [YouTube](https://www.youtube.com/channel/UCngKdP2x8l1wcbAKW3tvU8g)
- [LinkedIn](https://www.linkedin.com/company/storeconnect)
- [X / Twitter](https://x.com/storeconnecthq)

## Popular Links

- [Partners](https://storeconnect.com/partners)
- [Become a Partner](https://storeconnect.com/become-a-partner)
- [News](https://storeconnect.com/articles/news)
- [Events](https://storeconnect.com/articles/events)
- [Feature Comparison](https://storeconnect.com/how-we-compare)
- [Download a free trial](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000FMkeKUAT)
- [Book a Demo](https://storeconnect.com/contact)

## Documentation

- [Help documentation](https://support.storeconnect.com/help-documentation)
- [AI agents](https://support.storeconnect.com/ai)
- [Videos & tutorials](https://support.storeconnect.com/videos-tutorials)
- [Developer reference](https://support.storeconnect.com/developer-reference)
- [Release notes](https://support.storeconnect.com/release-notes)
- [Troubleshooting](https://support.storeconnect.com/troubleshooting)
- [Trust Center](https://trust.getstoreconnect.com/)
- [Status Page](https://status.storeconnect.com/)

## Contact

- info@getstoreconnect.com
- US +1 415 745 3230
- AUS +61 2 8365 2308

100 S Ashley Dr, Suite 600-2461
Tampa FL 33602-600 USA

Level 22, Sydney Place
180 George Street
Sydney, NSW, 2000, AUS

## Machine-readable

- [Site index for agents](https://storeconnect.com/llms.txt): curated map of the StoreConnect site in llms.txt format
- [Documentation index for agents](https://support.storeconnect.com/llms.txt): full technical and product documentation map

Every page and article on this site has a Markdown rendering: append `.md` to its URL.

Continue in Markdown: [Help documentation](https://support.storeconnect.com/help-documentation.md) · [Developer reference](https://support.storeconnect.com/developer-reference.md) · [Videos & tutorials](https://support.storeconnect.com/videos-tutorials.md) · [Release notes](https://support.storeconnect.com/release-notes.md)

---

StoreConnect Support — https://support.storeconnect.com/articles/customer-address-liquid-object-reference