## Create a Billing Address Element

`checkout.createBillingAddressElement(options?: object)`

This method creates an instance of a Billing Address Element.

- `options`
  Billing Address Element initialization options.
    - `contacts`
      An array of objects that can be displayed as saved addresses in the Billing Address Element. The first contact is automatically selected.
      - `name`
        The name of the contact. This might be a person, or a business name.
      - `address`
        The address of the contact.
        - `line1`
        - `line2`
        - `city`
          The name of a city, town, village, etc.
        - `state`
          The most coarse subdivision of a country. Depending on the country, this might correspond to a state, a province, an oblast, a prefecture, or something else along these lines.
        - `postal_code`
          The postal code or ZIP code, also known as PIN code in India.
        - `country`
          Two-letter country code, capitalized. Valid two-letter country codes are specified by ISO3166 alpha-2.
      - `phone`
        The phone number of the contact.
    - `display`
      You can customize how certain fields are displayed.
      - `name`
        By default, the Billing Address Element displays a full name field.
Specify 'split' to display a first name field and a last name field.
Specify 'organization' to display an organization field.
    - `autocomplete`
      By default, the Address Element will have autocomplete enabled with Stripe provided Google Maps API key for certain countries if any of the following condition is met:
* If Payment Element is mounted in the same elements group as Address Element in a single page application.
* If the Address Element is used in an active Link session (Link is also known as Onelink in the UK).

[Contact Legal before editing or deleting the Google Maps autocomplete callout]: #

By using autocomplete, you agree to comply with the [Google Maps Platform Acceptable Use Policy](https://cloud.google.com/maps-platform/terms/aup). If you violate this policy, we might disable autocomplete, or take any other action as necessary.

You can customize the autocomplete setting with this option.
      - `mode`
        Specify `disabled` to disable autocomplete in the Address Element.

Specify `google_maps_api` to enable [Google Maps API](https://developers.google.com/maps/documentation/javascript/places) with your own key. It will only be used when Stripe provided Google Maps API key is not available.

The default setting is `automatic`, where we'll support autocomplete when possible.
      - `apiKey`
        Specify your own [Google Maps API key](https://developers.google.com/maps/documentation/javascript/places#add-places-api-to-the-api-keys-api-restrictions-list) with it.

**Only needs to be passed in when `autocomplete.mode` is set to `google_maps_api`.**

### Example

```title
Create a Billing Address Element
```