> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwoty.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Currencies and taxes

> Configure the currencies you quote in and the tax rates you apply across your workspace.

Qwoty separates currency and tax configuration into two dedicated pages under your workspace settings. Both are set once at the workspace level and then used when creating quotes.

<Note>
  You must have the **Admin** role to add, edit, or delete currencies and taxes.
</Note>

## Currencies vs taxes

Currencies define **what denominations** you can price in. Taxes define **what levies** you apply on top of (or inside) those prices. Qwoty keeps them separate because they change for different reasons — you might add a currency when opening a new market, while taxes change whenever a country updates its fiscal rules.

| Setting        | What it controls                             | Where to find it                    |
| -------------- | -------------------------------------------- | ----------------------------------- |
| **Currencies** | Available currencies for pricing and quoting | **Settings → Workspace → Currency** |
| **Taxes**      | Tax types and rates applied on quotes        | **Settings → Workspace → Tax**      |

## Manage currencies

Currencies are available at the workspace level. Each quote is issued in exactly one currency, chosen at quote creation.

### Access the currencies screen

<Steps>
  <Step title="Open Settings">
    In the left sidebar, click **Settings**.
  </Step>

  <Step title="Navigate to Currency">
    Under the **Workspace** section, click **Currency**. You'll see the list of currencies enabled in your workspace.
  </Step>
</Steps>

### Add a currency

<Steps>
  <Step title="Open the currency form">
    Click **+ New currency** (or equivalent add action) at the top of the Currency list.
  </Step>

  <Step title="Select a currency">
    In **General Information**, click the **Currency** dropdown. Qwoty shows a searchable list of world currencies with their ISO code and native symbol — for example:

    * Albanian Lek (ALL) — L
    * Australian Dollar (AUD) — A\$
    * Argentine Peso (ARS) — \$
    * Bahraini Dinar (BHD) — د.ب

    Use the search field to filter by name or code.
  </Step>

  <Step title="Set the status">
    In the right panel, set **Active** to make the currency available for new quotes. Inactive currencies remain in the list but cannot be selected.
  </Step>

  <Step title="Add an API Name (optional)">
    Fill in **API Name** if you need to reference this currency programmatically in integrations or webhooks. This identifier is separate from the ISO code.
  </Step>

  <Step title="Set as default (optional)">
    Set **Is default** to `true` if this currency should be the default for new quotes. Only one currency can be the default at a time — setting a new default removes the flag from the previous one.
  </Step>

  <Step title="Save">
    Click **Save** in the top-right corner. The currency appears in your list and becomes available on quote templates and quotes.
  </Step>
</Steps>

<Warning>
  Once a quote is created, its currency is locked. To change the currency, duplicate the quote and select a different currency at creation.
</Warning>

## Manage taxes

Taxes are configured per country and can apply as a percentage (calculated automatically on quote totals) or as a fixed amount (manually defined per transaction).

### Access the taxes screen

<Steps>
  <Step title="Open Settings">
    In the left sidebar, click **Settings**.
  </Step>

  <Step title="Navigate to Tax">
    Under the **Workspace** section, click **Tax**. You'll see the list of taxes configured in your workspace.
  </Step>
</Steps>

### Tax types

When you add a tax, you first choose a **Type** from four predefined values. The type drives which fields the form asks for.

| Type          | Use case                                              | Available modes      |
| ------------- | ----------------------------------------------------- | -------------------- |
| **VAT**       | Value-Added Tax (most of Europe, many other regions)  | Percentage only      |
| **GST**       | Goods and Services Tax (Australia, Canada, India, NZ) | Percentage only      |
| **Sales Tax** | US state and local sales tax                          | Percentage only      |
| **Custom**    | Any other levy not covered by the three above         | Percentage or Amount |

<Info>
  Choose **Custom** when you need to configure a flat-fee tax (for example, a stamp duty or a regulatory contribution that isn't a percentage of the total).
</Info>

### Calculation modes

Qwoty supports two modes of calculation:

* **Percentage** — The tax amount is automatically calculated as a percentage of the taxable base. You enter a **Rate** (for example, `20` for 20%).
* **Amount** — The tax is a fixed value you configure manually, either directly on the quote or through specific calculations. You enter a **Currency** and an **Amount** (for example, `15` EUR).

<Note>
  Percentage is available for all tax types. Amount is only available when **Type** is set to **Custom**. VAT, GST, and Sales Tax are always percentage-based.
</Note>

### Add a tax

<Steps>
  <Step title="Open the tax form">
    Click **+ New tax** (or equivalent add action) at the top of the Tax list.
  </Step>

  <Step title="Choose the tax type">
    In **General Information**, select **Type** from the dropdown: `VAT`, `GST`, `Sales Tax`, or `Custom`.

    <Tip>
      If you pick **Custom**, a **Name** field appears so you can label the tax yourself (for example, `Eco-participation`). For VAT, GST, and Sales Tax, the name is derived from the type.
    </Tip>
  </Step>

  <Step title="Select the country">
    Pick the **Country** to which this tax applies. One tax configuration is scoped to one country — create separate entries for each jurisdiction.
  </Step>

  <Step title="Choose the calculation mode">
    Click either **Percentage** or **Amount**.

    * **Percentage** is the default and is the only mode available for VAT, GST, and Sales Tax.
    * **Amount** is only clickable when Type is **Custom**.
  </Step>

  <Step title="Configure the mode">
    <Tabs>
      <Tab title="Percentage mode">
        Enter the percentage in the **Rate** field. For example, `20` for a 20% VAT.
      </Tab>

      <Tab title="Amount mode">
        * Select the **Currency** the amount is denominated in.
        * Enter the fixed **Amount** value (for example, `15`).
      </Tab>
    </Tabs>
  </Step>

  <Step title="Save">
    Click **Save** to create the tax. It becomes available for selection on quotes and quote templates.
  </Step>
</Steps>

### Apply a tax to a quote

Taxes are applied at the quote line level or at the quote level, depending on the template configuration.

* **Default tax per template** — set a tax in a quote template so new quotes inherit it.
* **Override on a quote** — a sales rep can override or add taxes when editing a quote, based on permissions.
* **Line-item taxes** — different lines in the same quote can use different tax rates (useful for mixed-rate catalogs).

<Info>
  Taxes flow through the quote-to-revenue cycle: they appear on the quote, the published Dealroom view, the signed document, and eventually the order.
</Info>

## Common questions

<AccordionGroup>
  <Accordion title="Can I change a quote's currency after it's created?">
    No. Currency is locked at quote creation to avoid pricing inconsistencies. Duplicate the quote if you need to issue it in another currency.
  </Accordion>

  <Accordion title="Can a customer see prices in their own currency automatically?">
    Qwoty displays the quote in the currency chosen at creation. If you need the same quote in a different currency, duplicate the quote and change the currency at the top of the form.
  </Accordion>

  <Accordion title="Can I deactivate a currency?">
    Yes — set **Active** to `Inactive` on a currency to prevent new quotes from using it. Existing quotes keep their original currency.
  </Accordion>

  <Accordion title="Why is Amount greyed out for VAT, GST, and Sales Tax?">
    These three tax types are always calculated as a percentage of the taxable base. To use a fixed-amount tax, choose **Custom** as the type.
  </Accordion>

  <Accordion title="Can I apply multiple taxes on the same quote?">
    Yes. You can apply different taxes on different line items (for example, 20% VAT on products, 0% VAT on services), and the total is the sum of all line-level taxes.
  </Accordion>

  <Accordion title="What does the API Name field do?">
    It's a technical identifier used by integrations and API calls to reference the currency or tax. Use a short, unique string without spaces or special characters. It's optional if you don't plan to use the API.
  </Accordion>

  <Accordion title="What happens if I delete a tax used on existing quotes?">
    You cannot delete a tax while it's referenced by active quotes or orders. Deactivate it or reassign the affected quotes to a new tax first.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Workspace general settings" icon="building" href="/user-guide/settings/workspace/general">
    Configure language, country, and other workspace-wide defaults.
  </Card>

  <Card title="Quote settings" icon="hashtag" href="/user-guide/settings/workspace/quote-settings">
    Customize quote numbering and association resolution.
  </Card>

  <Card title="Business units" icon="building-user" href="/user-guide/settings/workspace/business-units">
    Add tax IDs per legal entity and manage multi-entity tax configuration.
  </Card>

  <Card title="Pricing types" icon="tag" href="/user-guide/catalog/reference/pricing-types">
    Learn how prices, currencies, and taxes combine on quote line items.
  </Card>
</CardGroup>