docs: improvements to tax related docs (#13845)

This commit is contained in:
Shahed Nasser
2025-10-24 09:44:47 +03:00
committed by GitHub
parent 226984cf0f
commit 8d574d6f29
4 changed files with 64 additions and 19 deletions
@@ -14,10 +14,12 @@ Refer to this [Medusa Admin User Guide](!user-guide!/settings/tax-regions#manage
## What are Tax Rates?
A tax rate is a percentage amount used to calculate the tax amount for each taxable items price, such as line items or shipping methods, in a cart. The sum of all calculated tax amounts are then added to the carts total as a tax total.
A tax rate, represented by the [TaxRate data model](/references/tax/models/TaxRate), is a percentage amount used to calculate the tax amount for each taxable items price, such as line items or shipping methods, in a cart. The sum of all calculated tax amounts are then added to the carts total as a tax total.
Each tax region has a default tax rate. This tax rate is applied to all taxable items of a cart in that region.
The `TaxRate` data model has a `rate` property that represents the percentage amount. For example, a `rate` of `10` means a tax rate of 10%.
### Combinable Tax Rates
Tax regions can have parent tax regions. To inherit the tax rates of the parent tax region, set the `is_combinable` of the childs tax rates to `true`.