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 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 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 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:
- In the tax settings Dashboard, scroll to the Advanced options section.
- Select the + Create rules button in the Custom tax rules section.
- Review the information about tax customisations and click Continue.
- The Customisations tab now appears in your tax Dashboard.
Create a tax customisation
Create your first tax customisation in a sandbox to make sure you get the tax outcome you expect:
- In the Dashboard, navigate to the Customisations tab in the Tax page.
- Click + Create customisation.
- In the section Product tax code, choose the product tax code your customisation applies to.
- (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.
- 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.
- For Tax type, choose the type of tax your customisation applies to.
- Click the Tax behaviour you want to apply. We indicate whether the product tax code you chose is taxable or non-taxable in that specific location and for the particular tax type (for example, sales tax or VAT).
- If you choose Taxable, you have two options:
- Apply the standard rate. This means that your rule always uses the standard rate that Stripe has determined for that product tax code, tax, and location. If the standard rate changes, that change also applies to your products.
- Apply a custom rate. This means that your rule uses the tax rate that you set. If the standard rate changes for that product, your custom rate still applies.
Regional considerationsUnited StatesYou 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.
- If you choose Taxable, you have two options:
- Verify that all the details in the Summary panel are correct. The Rate preview displays the expected tax rate that applies for a location within the jurisdiction you chose.
- The calculated tax might vary for other addresses within the same jurisdiction.
- In some cases, the tax code, tax, and location you select might be taxed at the location of your business, rather than the destination of the customer. In these cases, the preview displays how tax applies in your business location. We don’t use your tax customisation rule in these cases.
- Click 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. 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:
- In the Dashboard, navigate to the Customisations tab in the Tax page.
- Find the customisation rule you want to edit.
- Click the overflow menu () next to the rule and choose Edit rule.
- Make your changes to the time and date.
- 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:
- In the Dashboard, navigate to the Customisations tab in the Tax page.
- Find the tax customisation you want to archive.
- Click the overflow menu () next to the rule and choose Archive rule.
- 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.
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.
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:
- Navigate to the Customisations tab in the Tax page, then choose Colorado from the Rule location dropdown.
- Enable Include all jurisdictions.
- Choose Sales Tax from the Tax type dropdown.
- 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:
- Navigate to the Customisations tab in the Tax page, then choose Colorado from the Choose location dropdown under Rule location.
- Disable Include all jurisdictions.
- Choose Boulder from the Choose a jurisdiction* dropdown.
- Choose Sales Tax from the Tax type dropdown.
- 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.
When you can’t use customisations
Some parts of a tax calculation can’t be overridden. The following things will continue to affect the final tax calculation:
- Sourcing rules: These rules determine whether tax is calculated using the destination of the buyer or the origin of the seller. If you create a customisation that applies to a jurisdiction, but your product is sourced to the origin instead, your customisation rule won’t apply.
- Tiers, thresholds, and taxable basis apply in some jurisdictions:
- Taxable basis: In certain locations, only a specific portion of the tax code is taxable. For example, in Texas, only 80% of the cost of Software as a service is subject to tax.
- Treatment based on price: Products might be treated differently based on their price. For example, in New York, clothing is exempt from tax if it costs under 110 USD, 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 110 USD is still considered exempt.
Regional considerationsUnited States
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 (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 software platform can create a customisation for their connected account by doing the following:
- Navigate to the connected account details page from the Connected accounts page.
- Log in as the connected account.
- Create a tax customisation in the Dashboard.
However, you can’t create a tax customisation at the software platform level that applies to all of your connected accounts.