---
title: "Account Address Form - Liquid Form Reference"
source: https://support.storeconnect.com/articles/account-address-form-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.
---
# Account Address Form - Liquid Form Reference

## Usage


```liquid

{% form "account-address", path: address.path, method: "patch", address: address %}
  {% assign label = form.fields["label"] %}
  <input name="{{ label.name }}" value="{{ label.value }}">

  {% assign country = form.fields["country"] %}
  <select name="{{ country.name }}">
    {% for c in all_countries %}
      <option value="{{ c.alpha2 }}">{{ c.name }}</option>
    {% endfor %}
  </select>

  <button type="submit">Save</button>
{% endform %}
```


The `account-address` form creates or updates an address book entry for the signed-in customer. It backs the new and edit surfaces on the account dashboard's addresses section. The address book is scoped per contact, so the form always writes against the signed-in contact and never against a colleague on the same account.

| Property | Value |
|----------|-------|
| **Form Name** | `account-address` |
| **Category** | Accounts |

## Parameters

| Parameter | Required | Description |
|-----------|----------|-------------|
| `path` | Yes | The path the form posts to. Use `address.path` with `method: "patch"` for an edit, or `current_store.addresses_path` to create. Do not post to `address.edit_path` or `current_store.new_address_path`, which are the pages that display the forms. |
| `method` | No | The HTTP method. Defaults to POST. Pass `"patch"` for an update. |
| `address` | No | A [CustomerAddress](customer-address-liquid-object-reference) entry whose values pre-fill the fields. Omit it when creating. |

Any other tag option is passed through as an HTML attribute on the `<form>` element.

## Fields

Reach each field as `form.fields["name"]` inside the block:

| Field | Notes |
|-------|-------|
| `label` | Optional. When it is left empty, the record is named after a one-line summary of the address |
| `address_lines` | A collection of one or more lines |
| `city` | |
| `state` | |
| `postal_code` | |
| `country` | Always required |
| `is_default_shipping` | Boolean |
| `is_default_billing` | Boolean |

Which of `city`, `state`, `postal_code` and the street lines are required depends on the country, using the same per-country rules the checkout applies.

## Form Object

Inside the form block, you can access the `form` object which provides:

- `form.fields["name"]` — Each field above, carrying its `name` and `value`
- `form.errors` — Any validation errors after submission

---

## 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/account-address-form-reference