Billing address section - Overflow Documentation

Enable the billing address section by passing billingAddress. The section accepts every option the standalone Billing address element accepts.

Enable the section

overflow.checkout({
  paymentMethods: ['card'],
  billingAddress: {},
});

An empty object renders the default field set: line1, line2, city, state, ZIP, country. Country defaults to the shopper’s inferred locale.

Configure fields

overflow.checkout({
  paymentMethods: ['card'],
  billingAddress: {
    fields: {
      country: { supportedCountries: ['US', 'CA'] },
      line2: { hidden: true },
    },
  },
});

Default country

Set defaultCountry to pre-select a country instead of inferring from the shopper’s locale:

overflow.checkout({
  paymentMethods: ['card'],
  billingAddress: {
    defaultCountry: 'US',
  },
});

Autocomplete

Opt into address autocomplete with addressAutocomplete. Bring your own Google Maps API key:

overflow.checkout({
  paymentMethods: ['card'],
  billingAddress: {
    addressAutocomplete: {
      provider: 'googlePlaces',
      apiKey: 'AIza...',
    },
  },
});

See Address autocomplete.

Submitted value

checkout.on('onSubmit', ({ value }) => {
  // value.billingAddress: { line1, line2?, city, state, zip, country, ... }
});

See also

Last modified on July 29, 2026

Related topics

Billing address Checkout Shipping address section Sections overview Address elements