Skip to content

Tax

Menu: Commerce -> Tax
Deep link: /_Admin/commerce/taxes?SiteId={siteGuid}
Create: /_Admin/commerce/taxes/create?SiteId=...&country={countryName}
Edit: /_Admin/commerce/taxes/edit?SiteId=...&id={taxRuleId}

Configure commerce tax by country/region: one rule per country with base tax rate, optional regional overrides for provinces/states, and product condition overrides. Cart trial and order checkout match rates by shipping country/region and products (line taxAmount, order tax total).

Permission

Menu permission feature name is tax (not taxes); edit requires tax · edit.

How to Open

  1. In the Edit menu, enable Commerce -> Tax (and the parent Commerce group).
  2. Open Commerce -> Tax in the left sidebar.

List Page

Path: /_Admin/commerce/taxes?SiteId=...

Column / ActionDescription
CountryFlag + localized country name (Commerce country library)
Base taxbaseTax, percentage display
CreateOpens Select country dialog; already configured countries excluded
EditRow pencil → create and edit
Batch deleteSelect rows → Delete → confirm
Tax rules list: country and base rate

Select Country Dialog

After Create, select country without tax rule yet; keyword filter supported; click table row to enter create page (query country). Dialog is SelectCountryDialog: search box + country table (name, code).

Create button permission

List Create button uses permission taxes · edit, while menu registers tax · edit. If button shows disabled "no permission", accounts with tax edit permission can still access taxes/create?SiteId=...&country={countryName} directly.

Create and Edit

Create path includes country; edit path includes id. Breadcrumb: Tax -> {country name}. Shared EditForm, bottom Save / Cancel returns to list.

Tax rule edit: base tax, regional and product overrides

Base Tax

FieldDescription
Base taxbaseTax, percentage number (ElInputNumber, step 0.1, min 0)

Regional Overrides

When country has provinces/states etc. in Commerce address library, Regional overrides card appears:

CapabilityDescription
SearchFilter regions by keyword
ResetClear keyword and remove all regional override entries
Pagination6 regions per page
Per-region ratePercentage + calculation method dropdown

Calculation methods (OverridesType) — copy includes current base tax {tax}%:

ValueMeaning
AddedAdd this percentage on top of base tax
InsteadReplace base tax; use only this percentage
CompoundedCompound on base tax (multiplication logic on server)

Regions without override use base tax.

Product Overrides

Product overrides can add multiple rules, each containing:

ItemDescription
RatePercentage
Calculation methodAdded / Instead / Compounded relative to "base tax + matched regional override" (similar copy to regional overrides, referencing regional result)
ConditionsCondition component: match product dimension fields (schema from getTaxSchemas), AND/OR multiple rules
DoneClick Done while editing to collapse to summary; click summary to expand again
DeleteRemove this product override
AddRound + adds new rule

Matching product lines use override rate at trial/checkout; otherwise fall back to regional/base tax.