# Tax customisations

Learn how to customise tax behaviour using Stripe Tax.

Set up Stripe Tax to fit your business needs with tax customisations. Create rules that apply to a product tax code in any supported location.

For example, you can:

- Change the [Software as a service (SaaS) - personal use](https://docs.stripe.com/tax/tax-codes.md?tax_code=txcd_10103000) tax code from taxable to non-taxable in Louisiana to reflect the uncertainty of how SaaS might be taxed.
- Apply a 5% tax rate to the [Newspapers](https://docs.stripe.com/tax/tax-codes.md?tax_code=txcd_35020100%09) tax code in Poland, instead of the applied rate of 8%, to reflect that your product is a regional newspaper and not a national one.
- Treat the [Food for non-immediate consumption](https://docs.stripe.com/tax/tax-codes.md?tax_code=txcd_40040000) tax code as taxable at the standard rate in New York, to reflect that you sell bagels with cream cheese.

After you create a tax customisation, you’re responsible for keeping the rate and taxability up to date with any changes in tax law. When you remove a tax customisation, Stripe manages the updates.

## Access tax customisations

Calculations and transactions with tax customisations applied incur no additional charge over other tax calculations or transactions. To enable access to tax customisations on your account:

1. Go to the [tax settings](https://dashboard.stripe.com/settings/tax/advanced-options/) page.
1. Select the **+ Create rules** button in the **Custom tax rules** section.
1. Review the information about tax customisations and click **Continue**.
1. The **Customisations** tab now appears in your [tax Dashboard](https://dashboard.stripe.com/tax/).

## Create a tax customisation

Create your first tax customisation in a sandbox to make sure you get the tax outcome you expect:

1. In the Dashboard, go to the [Customisations tab](https://dashboard.stripe.com/tax/customizations) in the Tax page.
1. Click **+ Create customisation**.
1. In the section **Product tax code**, choose the product tax code your customisation applies to.
1. (Optional) Specify the date and time for the customisation rule to become effective under **Effective date**. For example, you can set the customisation rule to start from the first day of the month. If you don’t set a date, the rule takes effect immediately.
1. In the section **Rule location**, choose a jurisdiction where your customisation applies.
   - You can create a rule that applies to a country or state.
   - For US jurisdictions, you can also create a rule that only applies to a specific city, county, or district.
1. For **Tax type**, choose the type of tax your customisation applies to.
1. Select the **Tax behaviour** you want to apply. Stripe indicates whether the product tax code you chose is taxable or non-taxable at that location and for that tax type (for example, sales tax or VAT).
   - If you select **Taxable**, you can apply either the:
     - **Standard rate**: Your rule always applies the standard rate Stripe has determined for that jurisdiction. If the standard rate changes, the update also applies to your products.
     - **Custom rate**: Your rule uses the tax rate you set. If the standard rate changes, your custom rate still applies.

     > You can’t apply a custom rate in the US when creating a rule for a state that applies to all jurisdictions in a state because several cities and counties have different tax rates. To determine a custom rate for these jurisdictions, select a specific city, county, or district in the jurisdiction dropdown.
1. In the **Summary** panel, verify the information is correct. The **Rate preview** displays the expected tax rate for the jurisdiction you chose.
   - In the US, the calculated tax can vary for other addresses within the same jurisdiction, as multiple jurisdictions can apply tax to a single location.
   - Some tax codes are taxed at your business location, rather than the location of your customer. In these cases, the **Rate preview** shows how tax applies in the jurisdiction your business is based in. You can only set a tax customisation rule for your business location, meaning if you select a different location, your rule won’t apply.
1. Select **Create rule** to apply your rule immediately, or at the time and date you chose.

## View and maintain your tax customisations

View all your customisation rules in the [Customisations tab](https://dashboard.stripe.com/tax/customizations). Click a customisation to view the following information:

- When the rule was created or edited.
- Who created or edited the rule.
- The taxability and rate that’s applied.
- The tax code, location, and tax the rule applies to.

If you have a customisation in place, Stripe won’t automatically update the taxability or custom rate of your product if something changes. It’s your responsibility to maintain your tax customisations to make sure they reflect what’s needed for your business.

## Edit a tax customisation

If your customisation is scheduled to start in the future, you can edit the start or end time of your customisation rule. If your rule is already active, you can edit the end date and time. To change the tax code, location, or tax rate, you must archive the rule and create a new one in its place.

To edit your tax rule:

1. In the Dashboard, go to the [Customisations tab](https://dashboard.stripe.com/tax/customizations) in the Tax page.
1. Find the customisation rule you want to edit.
1. Click the overflow menu (⋯) next to the rule and choose **Edit rule**.
1. Make your changes to the time and date.
1. Click **Save**.

## Archive a tax customisation

You can archive a customisation that you created. After you archive a customisation rule, it no longer applies to your tax transactions and Stripe’s default behaviour applies instead. Rules can’t be unarchived, but you can create a new rule instead.

To archive your tax customisation:

1. In the Dashboard, go to the [Customisations tab](https://dashboard.stripe.com/tax/customizations) in the Tax page.
1. Find the tax customisation you want to archive.
1. Click the overflow menu (⋯) next to the rule and choose **Archive rule**.
1. Confirm your changes, then click **Archive**.

## Verify which transactions have a tax customisation rule applied

To verify which tax customisation applies to a transaction, view the **customizations\_applied\_ids** column of the [itemised export](https://docs.stripe.com/tax/reports.md?#itemized-exports).

We don’t include transactions that contain tax customizations in the US-specific location reports or summarised reports. Learn more about the [different tax reports](https://docs.stripe.com/tax/reports.md).

## How we choose which customisation applies

When two rules apply to the same product in the same jurisdiction, Stripe only applies the more specific rule.

For example, this might apply if Stripe treats your product as taxable in the state of Colorado, but you want to treat it as non-taxable in all of Colorado except for the city of Boulder, where it should be taxed at the standard rate.

To change this, you can create a rule for the tax code that you apply to your product for the state of Colorado:

1. Navigate to the [Customisations tab](https://dashboard.stripe.com/tax/customizations) in the Tax page, then choose **Colorado** from the **Rule location** dropdown.
1. Enable **Include all jurisdictions**.
1. Choose **Sales Tax** from the **Tax type** dropdown.
1. Set **Non-taxable** as the **Tax behaviour**.

Additionally, you can create a second rule for the same tax code to apply tax in Boulder, but not elsewhere in Colorado:

1. Navigate to the [Customisations tab](https://dashboard.stripe.com/tax/customizations) in the Tax page, then choose **Colorado** from the **Choose location** dropdown under **Rule location**.
1. Disable **Include all jurisdictions**.
1. Choose **Boulder** from the *Choose a jurisdiction*\* dropdown.
1. Choose **Sales Tax** from the **Tax type** dropdown.
1. Set **Standard rate** as the **Tax behaviour**.

You can’t create a tax customisation that applies to the same specific jurisdiction (for example, Boulder) for the same tax code, during the same time period.

## Tax customisation limits

Tax customisations can’t override the following:

- **Registration status**: Customisations don’t apply in jurisdictions where you’re [not registered](https://docs.stripe.com/tax/zero-tax.md#not-registered).
- **Tax jurisdiction**: The rules that determine where your product is delivered and which jurisdiction collects the tax. If you create a customisation for one jurisdiction but your product is taxed in another, your customisation won’t apply.
- **Zero rate and reverse charge**: The rules that determine whether a zero rate or [reverse charge](https://docs.stripe.com/tax/zero-tax.md#reverse-charges) applies to a cross-border sale.
- **Customer exempt status**: Customisations don’t apply to sales to customers with [exempt](https://docs.stripe.com/tax/zero-tax.md#exempt-customers) status.
- **Unsupported locations**: Customisations don’t apply to sales to customers in an [unsupported country](https://docs.stripe.com/tax/supported-countries.md) or [excluded territory](https://docs.stripe.com/tax/zero-tax.md#excluded-territories).
- **Tiers, thresholds and taxable basis**: These apply in some jurisdictions:
  - **Taxable basis**: In certain locations, tax applies to a portion of the price. For example, in Texas, 80% of the cost of software-as-a-service is subject to tax.
  - **Treatment based on price**: Products can be treated differently based on their price. For example, in New York, clothing is exempt from tax if it costs under US$110, but taxable if it exceeds that amount. Even if you create a rule for New York City with a custom rate, sales of clothing in New York under US$110 are still considered exempt.

> Tax customisations in Stripe don’t transfer to TaxJar. When using TaxJar for filing, these customisations aren’t taken into account when TaxJar recalculates the tax you’re expected to file. As a result, tax customisations might not be suitable for your specific use case.

## Tax customisations for Connect platforms

### Connect use cases that qualify for tax customisations

- [Marketplaces](https://docs.stripe.com/tax/tax-for-marketplaces.md) (Connect platforms that assume responsibility for collecting and remitting taxes for their connected accounts)
- Connected accounts with access to the Stripe Dashboard and that are liable for collecting taxes

### Connect software platforms partially supported by tax customisations

A platform can create a customisation for an individual connected account by doing the following:

- In your Dashboard, go to the connected account details page from the [Connected accounts](https://dashboard.stripe.com/connect/accounts) page.
- From the overflow menu (⋯) in the top-right of the page, select **View Dashboard as {account name}**.
- From the account Dashboard, create a [tax customisation](https://docs.stripe.com/tax/tax-customizations.md#create-a-tax-customization).

You can’t create a tax customisation at the platform level that applies to all your connected accounts.