> ## Documentation Index
> Fetch the complete documentation index at: https://docs.upstackdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Address Properties

> Shipping and billing address fields — address1, city, province, country, zip for checkout and purchase events.

For shipping and billing information. Pass as an array of address objects.

## Address Array Structure

```javascript theme={null}
window._upstack('track', 'purchase', {
  transactionId: 'ORD-12345',
  value: 149.99,
  currency: 'USD',
  addresses: [
    {
      firstName: 'Jane',
      lastName: 'Smith',
      address1: '123 Main St',
      address2: 'Apt 4B',
      city: 'San Francisco',
      province: 'California',
      provinceCode: 'CA',
      country: 'US',
      zip: '94102'
    }
  ],
  items: [/* ... */]
});
```

## Address Properties

| Property       | Type   | Description                                              |
| -------------- | ------ | -------------------------------------------------------- |
| `firstName`    | string | First name                                               |
| `lastName`     | string | Last name                                                |
| `company`      | string | Company or organization name                             |
| `address1`     | string | Street address line 1                                    |
| `address2`     | string | Street address line 2                                    |
| `city`         | string | City                                                     |
| `province`     | string | State or province                                        |
| `provinceCode` | string | State/province code (e.g., `CA`, `NY`, `ON`)             |
| `country`      | string | Country name                                             |
| `countryCode`  | string | ISO 3166-1 alpha-2 country code (e.g., `US`, `CA`, `GB`) |
| `zip`          | string | ZIP or postal code                                       |

## Privacy

Address fields (city, zip, country code, state code) are normalized and SHA-256 hashed before being sent to advertising destinations.

<Note>
  Use `province` for the full state/province name and `provinceCode` for the abbreviated code. Use `zip` for postal codes.
</Note>