## Update the Customer's email address

Use this method to update the Customer's email address. If your integration uses [Link](/payments/link.md) and you do not provide an email during Checkout Session creation, you must call `updateEmail` for Link to appear as a payment option for returning users. If your integration uses the [Express Checkout Element](/elements/express-checkout-element.md), the email address is collected directly from the wallet and the value set by `updateEmail` is not used for express checkout payments.

This method returns a `Promise` that resolves with an object containing the following fields:
* `type`: one of either `"success"` or `"error"`
* `session`: only populated when `type` is `"success"`. Contains a [Session](/js/custom_checkout/session_object) instance representing the updated state.
* `error`: only populated when `type` is `"error"`. Contains an object with a string `message` field which can be displayed to your customer.

**Syntax:** `actions.updateEmail(...)`

- `email` (nullable string) **required**
  The Customer's email address.

### Update the Customer's email address

```jsx
actions.updateEmail('jenny.rosen@example.com');
```