# Select Customer Address

A dropdown that shows all of the currently-selected customer's saved addresses, filtered to billing or shipping. The user picks one, and the chosen address becomes the active billing/shipping address for the order.

## Available in

* Page modules
* Order Form modules
* Catalog modules

## When to use

* On Order Form pages where the shipping or billing address may differ from the customer's default address.
* When the customer has multiple addresses on file and the user needs to pick a specific one.
* For checkout flows that distinguish between *Ship To* and *Bill To*.

If you only ever want to display the customer's default address, use **Address** alone — Select Customer Address is for picking when there are multiple to choose from.

## Settings

| Setting                       | Description                                                                     |
| ----------------------------- | ------------------------------------------------------------------------------- |
| **Title**                     | Heading text shown above the picker. Default: *Customer Address*.               |
| **Address Type**              | Which address kind this picker manages: Billing or Shipping. Default: Billing.  |
| **Show Preview in Edit Mode** | Show a sample preview while editing the page in the Page Builder. Default: Yes. |

## How it works

1. Reads the selected customer (from the page's session state, set by Customer/Vendor Selection).
2. Fetches the customer's address list from NetSuite.
3. Auto-selects the customer's default address (matching the configured Address Type).
4. The user can change the selection from the dropdown.
5. The chosen address is written back to session state and read by downstream **Address** blocks.

The block hides itself if the signed-in user isn't a customer entity, or if the customer has no addresses on file (in non-edit mode).

{% hint style="info" %}
JavaScript hooks are available for advanced flows: `selectCustomerAddress-afterAddressesFetch` (modify the address list before display), `selectCustomerAddress-beforeAddressSelect` (validate a pick), `selectCustomerAddress-afterAddressSelect` (run side effects after pick). See the [JavaScript](/client-admin-guide/active-workflows/getting-started/advanced-components/javascript.md) component.
{% endhint %}

## Examples

**Order with separate billing and shipping.** Two Select Customer Address blocks: one with Address Type = Billing, one with Address Type = Shipping. Two corresponding Address blocks below display the selected addresses.

**Pickup vs delivery flow.** A Select Customer Address with Address Type = Shipping, only enabled when the order type is *Delivery* — paired with the Address block's order-type filter.

## Related

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Address</strong></td><td>Displays the selected address — pair both blocks together.</td><td><a href="/pages/mz9aKhtOjrSU4uu6KToN">/pages/mz9aKhtOjrSU4uu6KToN</a></td></tr><tr><td><strong>Customer/Vendor Selection</strong></td><td>The upstream block that selects the customer this picker reads from.</td><td><a href="/pages/km19hjFIFOFjRK0yQAJp">/pages/km19hjFIFOFjRK0yQAJp</a></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.in8sync.com/client-admin-guide/active-workflows/getting-started/entity-components/select-customer-address.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
