---
title: Tax settings
subtitle: Learn how to allow connected accounts to set up Stripe Tax.
route: /connect/supported-embedded-components/tax-settings
---

# Tax settings

Learn how to allow connected accounts to set up Stripe Tax.

The Tax settings component allows your connected accounts to [set up Stripe Tax](https://docs.stripe.com/tax/set-up.md) in your platform. Connected accounts can change their head office address and [preset tax code](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md#product-tax-code) with this component. This component is suitable for [software platforms](https://docs.stripe.com/tax/tax-for-platforms.md), which means that your connected accounts are liable to collect taxes.

To calculate taxes on payments of your connected accounts you have to collect four data points of information:

* The head office address
* The type of product the connected account sells
* The address of the customer
* The registrations of the connected account with the tax authorities

The tax settings component helps you to collect the first two pieces of information of your connected accounts with minimal integration effort.

The embedded tax settings component uses the [Tax Settings API](https://docs.stripe.com/tax/settings-api.md) to display the head office address and [preset tax code](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md#product-tax-code) to your connected accounts.

## Requirements

- Your integration must follow the [software platforms guide](https://docs.stripe.com/tax/tax-for-platforms.md) for [Tax on Connect](https://docs.stripe.com/tax/connect.md). This means that your connected accounts are liable to collect taxes.
- After integrating the Tax settings component, render the [Tax registrations component](https://docs.stripe.com/connect/supported-embedded-components/tax-registrations.md) to collect tax registration information of your connected accounts. This is a requirement for Tax to calculate tax in a specific location.

## Integrate the tax settings component 

When [creating an Account Session](https://docs.stripe.com/api/account_sessions/create.md), enable tax settings by specifying `tax_settings` in the `components` parameter.

After creating the account session and [initializing ConnectJS](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions), you can render the tax settings component in the frontend:

```jsx
// Include this React component
import {
  ConnectTaxSettings,
  ConnectComponentsProvider,
} from "@stripe/react-connect-js";

return (
  <ConnectComponentsProvider connectInstance={stripeConnectInstance}>
    <div>
      <h2>Tax Settings</h2>
      <ConnectTaxSettings
        // Optional
        // displayHeadOfficeCountries={["US", "CA", "DE"]}
        // onTaxSettingsUpdated={({id: settingsId}) => console.log({settingsId})}
        // hideProductTaxCodeSelector
       />
    </div>
  </ConnectComponentsProvider>
);
```

```js
// Include this element in your HTML
const container = document.getElementById("container");

const taxSettings = stripeConnectInstance.create('tax-settings');
container.appendChild(taxSettings);
// Optional
// taxSettings.setDisplayHeadOfficeCountries(["US", "CA", "DE"])
// taxSettings.setOnTaxSettingsUpdated(({id: settingsId}) => console.log({settingsId}))
// taxSettings.setHideProductTaxCodeSelector(true)
```

| Method                          | Type                     | Description                                                                                                                                             | Default                                        |
| ------------------------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
| `setDisplayHeadOfficeCountries` | `string[]`               | Array of [two-letter country codes](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) that the connected account can choose from for their head office. | undefined (all countries permitted)            |
| `setOnTaxSettingsUpdated`       | `({id: string}) => void` | Callback executed with an object containing the newly updated tax settings ID                                                                           | undefined (not a required method)              |
| `setHideProductTaxCodeSelector` | Boolean                  | Set to true to hide the tab where users select a default Product Tax Code                                                                               | false (users can by default set a default PTC) |

| React prop                   | Type                     | Description                                                                                                                                             | Default                                        | Required or optional |
| ---------------------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | -------------------- |
| `displayHeadOfficeCountries` | `string[]`               | Array of [two-letter country codes](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) that the connected account can choose from for their head office. | undefined (all countries permitted)            | optional             |
| `onTaxSettingsUpdated`       | `({id: string}) => void` | Callback executed with the newly updated tax settings ID                                                                                                | undefined (not a required method)              | optional             |
| `hideProductTaxCodeSelector` | Boolean                  | Include this Boolean prop to hide the tab where users select a default Product Tax Code                                                                 | false (users can by default set a default PTC) | optional             |

To give your connected accounts full control over their tax compliance, you need to integrate the tax registrations component as well. Please follow the guide for [tax compliance for software platforms](https://docs.stripe.com/tax/tax-for-platforms.md). The guide also covers how to calculate and collect the taxes and help your connected accounts to report their taxes.

## See Also

- [Tax on Connect](https://docs.stripe.com/tax/connect.md)
- [Tax for software platforms](https://docs.stripe.com/tax/tax-for-platforms.md)
- [Tax registrations component](https://docs.stripe.com/connect/supported-embedded-components/tax-registrations.md)