> For the complete documentation index, see [llms.txt](https://docs.silkline.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.silkline.ai/profile-and-settings/organization-settings/taxes.md).

# Taxes

Enable the Tax Module and define tax codes with labels, rates, and statuses so buyers can apply one or more taxes per PO line item

The **Tax Module** lets you define and apply tax codes across Silkline. When enabled, organizations can manage tax rates and apply them directly to purchase order line items.

* **Taxes are applied at the line item level**, giving flexibility for mixed-tax orders.
* **Multiple tax codes can be assigned to a single line**, allowing combinations like state and local rates.
* **Total taxes**, broken down by tax rate, will display in the **Order Adjustments** section on a PO

## Tax Codes

Tax codes define the available tax rates for your organization. The **Tax Codes** table shows each code's:

* **Name** – e.g. "Standard Tax," "Reduced Tax," "Tax Exempt"
* **Tax Rate** – The percentage applied to line items
* **Status** – Active or Archived

Search matches a code's name, and the **Status** filter shows only active or only archived codes. While the module is enabled, click **Add Tax Code** to create a code, and use the row menu to **Edit**, **Archive** or **Restore**, or **Delete** one. Common examples include standard, reduced, and exempt rates.

### Bulk editing tax codes

With [data cleaning mode](https://docs.silkline.ai/administration-tools/data-cleaning-mode.md) on and the Tax Module enabled, the tax codes table shows a checkbox on every row:

* Select codes, click **Edit**, and set **Archived** to archive or restore them all at once
* Select codes and click **Delete** to remove them permanently

## Require Tax Codes on Order Lines

Turn on **Require tax code on order lines** (under **Tax Module**, visible once the module is enabled) to make every order line item carry at least one tax code:

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-ebf308b9b07c3526932290a41753fd44d1941ee7%2Frequire-tax-code-setting.png?alt=media" alt="Require tax code on order lines toggle under Tax Module"><figcaption><p>Require tax code on order lines setting</p></figcaption></figure>

* The **Tax Codes** field on each line is marked required, and the order can't be saved until every line has a tax code.
* Starting approvals on an order with an untaxed line shows a **Tax code assigned** error. It blocks the approval request when **Block approval request when order has validation errors** is on in Approvals settings.
* Shop carts open in the full order form, where tax codes can be picked for each line.
* The requirement applies only while your organization has at least one active tax code.

The requirement covers every line, including shipping and other charge lines. To cover a line that isn't taxed, create a 0% tax code (for example, "Tax Exempt") and apply it.

## How to Apply Taxes to Orders

### Adding Taxes to Line Items

When creating or editing an order, you can apply tax codes to individual line items using the **Tax Codes** column in the line items table:

* Each line item can have one or more tax codes applied
* In the example above, line 1 has "Sales Tax" applied, and line 2 has "Super Tax" applied
* To add a tax code, click the dropdown in the Tax Codes column and select from your organization's available tax codes

### Viewing Taxes on Purchase Orders

Once taxes are applied to line items, they are displayed in the **Taxes** column on the purchase order:

The Taxes column displays the total tax amount calculated for each line item, based on the applicable tax codes and rates.

### Tax Summary in Order Adjustments

Total taxes are automatically calculated and displayed in the **Order Summary** section, broken down by each tax code:

* Each tax code is listed separately (e.g., "Sales Tax" and "Super Tax" in the example)
* The individual amounts are shown for each tax code
* A total tax amount is displayed, which rolls up into the order total

### Tax Inclusivity

Purchase orders support a **Tax Inclusive** setting that determines whether taxes are included in the subtotal. When enabled at the PO level, tax amounts are included in the subtotal calculation rather than being added as a separate line item.
