# Set Up an Organization Tax Table

A **tax table** is a reusable set of sales-tax rates that your organization
defines once and applies to any auction. Rates are entered per country and per
state/province, so the correct rate is applied automatically at checkout based
on the winning bidder's address.

:::note
Tax Tables is an add-on feature. If you don't see a **Tax Tables** tab in
Organization Settings, it isn't enabled on your account — contact your Handbid
representative.
:::

## Enter only the rates you're registered to collect

Handbid does **not** pre-load any tax rates. You enter the rates your
organization is registered to collect (your tax nexus). A blank cell means "no
rate here" — nothing is charged for that jurisdiction unless you fill it in.
Deciding where you have a tax obligation is up to your organization; when in
doubt, consult your tax advisor.

## Create a tax table

1. Go to **Organization Settings → Tax Tables**.
2. Click **+ New Tax Table** (or **Edit** on an existing one). If you have none
   yet, you'll see **"No tax tables yet."**
3. Give it a clear **Tax Table Name**, for example `US Sales Tax 2026`.
4. Add a country section, then fill in rates:
   - **Country default** — an optional single rate applied to any address in
     that country that doesn't match a specific state/province rate below.
   - **State/province rates** — every state/province for the country is listed.
     Enter a rate only where you collect tax; leave the rest blank.
5. Click **Save Tax Table**.

![The tax table editor — a country section showing the Country default field, Set all / Clear all, and a rate input for each state or province.](/tax-tables/org-tax-table-editor.png)

### Entering rates

- Rates are **percentages**. You can type `8.25`, `8.25%`, or use a comma
  (`8,25`) — all are accepted.
- Rates must be between **0 and 100**. Anything outside that range is rejected.
- A rate above **25%** is saved but highlighted in **yellow**, in case it was a
  typo. It won't block you.
- The **"n of m set"** chip shows how many of a country's jurisdictions have a
  rate.
- **Set all / Clear all** fill or empty a country's grid quickly.

### How a rate is chosen at checkout

When a bidder wins and pays, the rate is chosen in this order:

1. The **state/province rate** matching the bidder's address.
2. If there's no state rate, the **country default**.
3. If the table has no rate for that address, the **item's own tax rate**, if
   one is set (a fallback, not an override).
4. Otherwise **no tax** is charged.

## Managing tables

![The Tax Tables list, showing each table's name, number of jurisdictions, how many auctions use it, and when it was last updated.](/tax-tables/org-tax-tables-list.png)

- The list shows each table's **Name**, **Jurisdictions**, **Auctions using**,
  and **Last updated**.
- A table shown as **"Not in use"** can be deleted. **Delete is disabled while a
  table is attached to any auction** — detach it from those auctions first.
- Editing a table's rates does **not** change tax on receipts that have already
  been paid. Settled receipts keep the rate that was applied at payment time.

## Related articles

- [Apply a Tax Table to an Auction](/apply-a-tax-table-to-an-auction/)
- [Why Bidders Are Asked for an Address at Checkout](/why-bidders-are-asked-for-an-address-at-checkout/)