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

The locations translatable fields are:

* Name
* Address 1
* Address 2
* Description
* City
* State (optional)
* Meta Keywords
* Name (Special hours)

## Examples

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

### Query translations

#### Query a list of translations

This query returns a paginated list of translations by resourceType, channel, and locale with a maximum of 50 results per request.

#### Request

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

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

  query {
      store {
          translations(filters: {
              resourceType: INVENTORY_LOCATIONS,
              channelId: "bc/store/channel/1",
              localeId: "bc/store/locale/en"
          } first: 50) {
              edges {
                  node {
                        resourceId
                          fields {
                              fieldName
                              original
                              translation
                          }
                      }
                  cursor
              }
          }
      }
  }
```

#### 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/inventoryLocation/1",
                            "fields": [
                                {
                                    "fieldName": "city",
                                    "original": "AUSTIN",
                                    "translation": "Ville (OVR) TEST EN"
                                },
                                {
                                    "fieldName": "state",
                                    "original": "TX",
                                    "translation": "État (OVR) TEST EN"
                                },
                                {
                                    "fieldName": "description",
                                    "original": "",
                                    "translation": null
                                },
                                {
                                    "fieldName": "label",
                                    "original": "LOCATION 1",
                                    "translation": null
                                },
                                {
                                    "fieldName": "address2",
                                    "original": "apt 111",
                                    "translation": null
                                }
                            ]
                        },
                        "cursor": "eyJpZCI6IjEifQ=="
                    }
                ]
            }
        }
    }
}
```

#### Query a translation by resourceId

> **Note**
>
> When querying a translation by resourceId, you must provide the full
> resourceId in the format `bc/store/inventoryLocation/{location_id}`.

This query returns a translation by resourceId.

#### Request

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

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

    query {
        store {
            translations(filters: {
                resourceType: INVENTORY_LOCATIONS,
                channelId: "bc/store/channel/2",
                localeId: "bc/store/locale/it",
                resourceIds: ["bc/store/inventoryLocation/1", "bc/store/inventoryLocation/2"]
            }) {
                edges {
                    node {
                        resourceId
                            fields {
                                fieldName
                                original
                                translation
                            }
                        }
                    cursor
                }
            }
        }
    }
```

#### Response

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

```json title="Example query: Query a translation by resource id" showLineNumbers={false}
  {
    "data": {
        "store": {
            "translations": {
                "edges": [
                    {
                        "node": {
                            "resourceId": "bc/store/inventoryLocation/1",
                            "fields": [
                                {
                                    "fieldName": "city",
                                    "original": "AUSTIN",
                                    "translation": "Ville (OVR) TEST EN"
                                },
                                {
                                    "fieldName": "state",
                                    "original": "TX",
                                    "translation": "État (OVR) TEST EN"
                                },
                                {
                                    "fieldName": "description",
                                    "original": "",
                                    "translation": null
                                },
                                {
                                    "fieldName": "label",
                                    "original": "LOCATION 1",
                                    "translation": null
                                },
                                {
                                    "fieldName": "address2",
                                    "original": "apt 111",
                                    "translation": null
                                }
                            ]
                        },
                        "cursor": "eyJpZCI6MjR9"
                    },
                    {
                        "node": {
                            "resourceId": "bc/store/inventoryLocation/2",
                            "fields": [
                                {
                                    "fieldName": "city",
                                    "original": "AUSTIN",
                                    "translation": "Ville (OVR) TEST EN"
                                },
                                {
                                    "fieldName": "state",
                                    "original": "TX",
                                    "translation": "État (OVR) TEST EN"
                                },
                                {
                                    "fieldName": "description",
                                    "original": "",
                                    "translation": null
                                },
                                {
                                    "fieldName": "label",
                                    "original": "LOCATION 1",
                                    "translation": null
                                },
                                {
                                    "fieldName": "address2",
                                    "original": "apt 111",
                                    "translation": null
                                }
                            ]
                        },
                        "cursor": "eyJpZCI6MjJ7"
                    }
                ]
            }
        }
    }
}
```

### Update a translation

This mutation updates a translation.

#### Request

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

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

  mutation {
    translation {
        updateTranslations(input: {
            resourceType: INVENTORY_LOCATIONS,
            channelId: "bc/store/channel/1",
            localeId: "bc/store/locale/es",
            entities: [
            {
                resourceId: "bc/store/inventoryLocation/1",
                fields: [
                    {
                        fieldName: "city",
                        value: "Ville (OVR) TEST ES"
                    },
                    {
                        fieldName: "state",
                        value: "État (OVR) TEST ES"
                    }
                ]
            },
            {
                resourceId: "bc/store/inventoryLocation/2",
                fields: [
                    {
                        fieldName: "city",
                        value: "Ville (OVR) TEST ES"
                    },
                    {
                        fieldName: "state",
                        value: "État (OVR) TEST ES"
                    }
                ]
            }
        ]
    }) {
        __typename
        errors {
            __typename
            ... on Error {
                message
            }
        }
    }
}

}

```

#### Response

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

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

### Delete a translation

The following mutation deletes a translation.

#### Request

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

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

  mutation {
    translation {
      deleteTranslations(input: {
        resourceType: INVENTORY_LOCATIONS,
        channelId: "bc/store/channel/1",
        localeId: "bc/store/locale/en",
        resources: [
            {
                resourceId: "bc/store/inventoryLocation/2",
                fields: ["city", "state"],
            }
        ]
    }) {
        __typename
        errors {
            __typename
            ... on Error {
                message
            }
        }
    }
}
}

```

#### Response

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

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