> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# Tax Settings

Tax settings allow you to choose how a store handles tax calculation and price display. For example, you can set how a store handles taxes if an enabled tax service is unavailable. You can also choose whether prices include taxes when displayed on orders and invoices. For more info, see [Tax Settings](https://support.bigcommerce.com/s/article/Tax-Overview?language=en_US#tax-settings).

## Estimate taxes and display prices based on tax zone

The Tax Settings API supports cross-border transactions. You can localize storefront prices for shoppers from different regions. For example, you can display tax-inclusive or exclusive prices depending on the tax zone. This benefits single-storefront stores that sell to shoppers from different regions. This functionality applies to Stencil and GraphQL-powered storefronts.

To support cross-border transactions, the store identifies a tax zone for the shopper. The store then applies the tax zone and its settings to estimate taxes and display prices. For logged-in customers, the store uses the customer address to identify the tax zone. For guest shoppers, the store can use the shopper's geolocation to identify the zone if you enable this setting. Otherwise, the store uses the provided guest shopper tax zone ID.

This guide shows you how to use the Tax Settings API. For more info, see the [Tax Settings API Reference](/developer/api-reference/rest/admin/management/tax/tax-settings).

## Get tax settings

To get tax settings, send a request to the [Get tax settings](/developer/api-reference/rest/admin/management/tax/tax-settings/get-tax-settings) endpoint.

#### Request

**`Example request: Get tax settings`**

```http title="Example request: Get tax settings"
GET https://api.bigcommerce.com/stores/{{STORE_HASH}}/v3/tax/settings
X-Auth-Token: {{ACCESS_TOKEN}}
Content-Type: application/json
Accept: application/json
```

#### Response

**`Example response: Get tax settings`**

```json title="Example response: Get tax settings"
{
  "data": {
    "tax_entered_with_prices": true,
    "price_display_settings": {
      "show_inclusive_in_control_panel": true,
      "invoice_price_display_strategy": "ZONE"
    },
    "fallback_strategy": "DISABLE",
    "should_subtract_store_tax": false,
    "should_use_geolocation_to_determine_guest_shopper_tax_zone": true,
    "guest_shopper_tax_zone_id": 1,
    "store_tax_zone_id": 1,
    "document_submission_strategy": "ON_ORDER_CREATION"
  },
  "meta": {}
}
```

> **Note**
>
> When a merchant enters tax-inclusive prices, the `should_subtract_store_tax` field allows you to choose how a store calculates the tax-inclusive price displayed to shoppers. This setting affects the tax-inclusive price displayed to a shopper if the shopper and merchant are in different tax zones. For more information, see the [Tax Settings API Reference](/developer/api-reference/rest/admin/management/tax/tax-settings).

## Update tax settings

To update tax settings, send a request to the [Update tax settings](/developer/api-reference/rest/admin/management/tax/tax-settings/update-tax-settings) endpoint. The request updates only the fields that you specify.

#### Request

**`Example request: Update tax settings`**

```json title="Example request: Update tax settings" showLineNumbers={false}
PUT https://api.bigcommerce.com/stores/{{STORE_HASH}}/v3/tax/settings
X-Auth-Token: {{ACCESS_TOKEN}}
Content-Type: application/json
Accept: application/json

{
  "tax_entered_with_prices": false,
  "price_display_settings": {
    "invoice_price_display_strategy": "INCLUSIVE"
  }
}
```

#### Response

**`Example response: Update tax settings`**

```json title="Example response: Update tax settings" showLineNumbers={false}
{
  "data": {
    "tax_entered_with_prices": false,
    "price_display_settings": {
      "show_inclusive_in_control_panel": true,
      "invoice_price_display_strategy": "INCLUSIVE"
    },
    "fallback_strategy": "DISABLE",
    "should_subtract_store_tax": false,
    "should_use_geolocation_to_determine_guest_shopper_tax_zone": true,
    "guest_shopper_tax_zone_id": 1,
    "store_tax_zone_id": 1,
    "document_submission_strategy": "ON_ORDER_CREATION"
  },
  "meta": {}
}
```

## Resources

* [Tax Settings API Reference](/developer/api-reference/rest/admin/management/tax/tax-settings)
* [Get Tax Settings](/developer/api-reference/rest/admin/management/tax/tax-settings/get-tax-settings)
* [Update Tax Settings](/developer/api-reference/rest/admin/management/tax/tax-settings/update-tax-settings)