## Update an Express Checkout Element

Updates the options the [Express Checkout Element](/js/element/express_checkout_element.md)
was initialized with. Updates merge into the existing configuration.

**Syntax:** `element.update(...)`

- `options` (object)
  Options for updating the Express Checkout Element.

  - `allowedShippingCountries` (array)
    By default, the Express Checkout Element allows all countries for shipping.

You can specify which countries are allowed for shipping in the Express Checkout Element with a list of two-letter country codes.

  - `billingAddressRequired` (boolean)
    Controls whether the Express Checkout Element collects the billing address. The default value depends on your integration:

- If you pass `allowedShippingCountries`, `phoneNumberRequired`, `shippingAddressRequired`, `emailRequired`, `applePay`, `lineItems`, or `business` when creating the Express Checkout Element, `billingAddressRequired` defaults to false.
- Otherwise, `billingAddressRequired` defaults to true.

You can explicitly set `billingAddressRequired` to true or false to override the default behavior.

We highly recommend that you collect the billing address because it can be used to perform address verifications and block fraudulent payments.

  - `emailRequired` (boolean)
    Collect the customer's email by setting this option to `true`.

  - `layout` (object)
    Specify how the buttons are arranged in a grid-like layout in the Express Checkout Element.
Elements determines the layout by using certain factors, such as available space, number of buttons, and the defined `layout` object.

    - `maxColumns` (number)
      Defines the maximum number of columns the Express Checkout Element can use to render. Default is `0`, meaning unlimited.

    - `maxRows` (number)
      Defines the maximum number of rows the Express Checkout Element can use to render. Default is `0`, meaning unlimited.

    - `overflow` ('auto' | 'never')
      Specify whether or not to always hide the overflow menu or allow Elements to determine when to show the overflow menu. Default is `auto`.
You can't specify both `overflow: 'never'` and set `maxRows` to a number greater than 0.

  - `paymentMethodOrder` (array)
    By default, the Express Checkout Element uses a dynamic ordering that optimizes payment method display for each user.

You can override the default order in which payment methods display in the Express Checkout Element with a list of payment method types.

If there are payment methods that will show that are not specified in `paymentMethodOrder`, they display after the payment methods you specify. If you specify payment methods that will not show, they are ignored.

  - `phoneNumberRequired` (boolean)
    Collect the customer's phone number by setting this option to `true`.

PayPal doesn't provide a phone number, even when this option is set to `true`.

Google Pay makes a best effort to return the phone number registered to the wallet, but doesn't guarantee it will be provided in all cases.

  - `shippingAddressRequired` (boolean)
    Collect the customer's shipping address by setting this option to `true`.

If `true`, you must also supply a valid `shippingRates` option in either the `create`, `click`, or `shippingaddresschange` events.

### Update an Express Checkout Element

```js
var expressCheckoutElement = elements.getElement('expressCheckout');

expressCheckoutElement.update({
  layout: {
    maxColumns: 2,
    overflow: 'auto',
  },
});
```

```es_next
const expressCheckoutElement = elements.getElement('expressCheckout');

expressCheckoutElement.update({
  layout: {
    maxColumns: 2,
    overflow: 'auto',
  },
});
```