> 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.

# Translations for Tax Rates

The following entities are translatable for tax rates:

* Tax Rate Name as `tax_rate_name`

## Resource fields

| Entity Type | `resourceType` | `resourceId` Format     |
| ----------- | -------------- | ----------------------- |
| Tax Rate    | `TAX_RATES`    | `bc/store/taxRate/{id}` |

## Examples

Below are examples of GraphQL queries and mutations for retrieving and managing translation settings for tax rates.

### Query a List of Translations

This query returns tax rate translations for the specified resource type, channel, and locale (up to 50).

#### Request

**`Example query: Query a list of translations`**

```graphql title="Example query: Query a list of translations" showLineNumbers={false}
GRAPHQL https://api.bigcommerce.com/stores/{{store_hash}}/graphql
X-Auth-Token: {{token}}

query {
  store {
    translations(filters: {
      resourceType: TAX_RATES,
      channelId: "bc/store/channel/{{channel_id}}",
      localeId: "bc/store/locale/{{locale_code}}"
    }) {
      edges {
        node {
          resourceId
          fields {
            fieldName
            original
            translation
          }
        }
        cursor
      }
      pageInfo {
        hasNextPage
        hasPreviousPage
        startCursor
        endCursor
      }
    }
  }
}
```

#### Response

**`Example query: Query a list of translations`**

```json title="Example query: Query a list of translations" showLineNumbers={false}
{
  "data": {
    "store": {
      "translations": {
        "edges": [
          {
            "node": {
              "resourceId": "bc/store/taxRate/1",
              "fields": [
                {
                  "fieldName": "tax_rate_name",
                  "original": "Standard Tax Rate",
                  "translation": "Tasa de Impuesto Estándar"
                }
              ]
            },
            "cursor": "eyJyZXNvdXJjZUlkIjoxfQ"
          }
        ],
        "pageInfo": {
          "hasNextPage": false,
          "hasPreviousPage": false,
          "startCursor": "eyJyZXNvdXJjZUlkIjoxfQ",
          "endCursor": "eyJyZXNvdXJjZUlkIjoxfQ"
        }
      }
    }
  }
}
```

### Query a Translation by Resource ID

This query returns translation(s) by `resourceId`.

> **Note**
>
> When querying by `resourceId`, provide the full ID in the format `bc/store/taxRate/{id}`.

#### Request

**`Example query: Query a translation by id`**

```graphql title="Example query: Query a translation by id" showLineNumbers={false}
GRAPHQL https://api.bigcommerce.com/stores/{{store_hash}}/graphql
X-Auth-Token: {{token}}

query {
  store {
    translations(
      filters: {
        resourceType: TAX_RATES
        channelId: "bc/store/channel/{{channel_id}}"
        localeId: "bc/store/locale/{{locale_code}}"
        resourceIds: ["bc/store/taxRate/1"]
      }
    ) {
      edges {
        node {
          resourceId
          fields {
            fieldName
            original
            translation
          }
        }
        cursor
      }
    }
  }
}
```

#### Response

**`Example query: Query a translation by id`**

```json title="Example query: Query a translation by id" showLineNumbers={false}
{
  "data": {
    "store": {
      "translations": {
        "edges": [
          {
            "node": {
              "resourceId": "bc/store/taxRate/1",
              "fields": [
                {
                  "fieldName": "tax_rate_name",
                  "original": "Standard Tax Rate",
                  "translation": "Tasa de Impuesto Estándar"
                }
              ]
            },
            "cursor": "eyJyZXNvdXJjZUlkIjoxfQ"
          }
        ]
      }
    }
  }
}
```

### Update a Translation

#### Request

**`Example mutation: Update a translation`**

```graphql title="Example mutation: Update a translation" showLineNumbers={false}
GRAPHQL https://api.bigcommerce.com/stores/{{store_hash}}/graphql
X-Auth-Token: {{token}}

mutation {
  translation {
    updateTranslations(input: {
      resourceType: TAX_RATES,
      channelId: "bc/store/channel/{{channel_id}}",
      localeId: "bc/store/locale/{{locale_code}}",
      entities: [
        {
          resourceId: "bc/store/taxRate/1",
          fields: [
            {
              fieldName: "tax_rate_name",
              value: "Tasa de Impuesto Estándar"
            }
          ]
        }
      ]
    }) {
      errors {
        __typename
        ... on Error {
          message
        }
        ... on EntityNotFoundError {
          message
        }
        ... on ValidationError {
          message
        }
      }
    }
  }
}
```

#### Response

**`Example mutation: Update a translation`**

```json title="Example mutation: Update a translation" showLineNumbers={false}
{
  "data": {
    "translation": {
      "updateTranslations": {
        "errors": []
      }
    }
  }
}
```

### Delete a Translation

#### Request

**`Example mutation: Delete a translation`**

```graphql title="Example mutation: Delete a translation" showLineNumbers={false}
GRAPHQL https://api.bigcommerce.com/stores/{{store_hash}}/graphql
X-Auth-Token: {{token}}

mutation {
  translation {
    deleteTranslations(input: {
      resourceType: TAX_RATES,
      channelId: "bc/store/channel/{{channel_id}}",
      localeId: "bc/store/locale/{{locale_code}}",
      resources: [
        {
          resourceId: "bc/store/taxRate/1",
          fields: ["tax_rate_name"]
        }
      ]
    }) {
      errors {
        __typename
        ... on Error {
          message
        }
        ... on EntityNotFoundError {
          message
        }
        ... on ValidationError {
          message
        }
      }
    }
  }
}
```

#### Response

**`Example mutation: Delete a translation`**

```json title="Example mutation: Delete a translation" showLineNumbers={false}
{
  "data": {
    "translation": {
      "deleteTranslations": {
        "errors": []
      }
    }
  }
}
```