Choose a version:

translationsRemove

mutation

Requires write_translations access scope.

Deletes translations.

Anchor to Arguments

Arguments

Anchor to localeslocales •[String!]! required: The list of translation locales. Only locales returned in shopLocales are valid.
Anchor to marketIdsmarketIds •[ID!]: The list of market IDs.
Anchor to resourceIdresourceId •ID! required: ID of the translatable resource for which translations are being deleted.
Anchor to translationKeystranslationKeys •[String!]! required: The list of translation keys.

Was this section helpful?

Anchor to TranslationsRemovePayload returnsTranslationsRemovePayload returns

Anchor to translationstranslations •[Translation!]: The translations that were deleted.
Anchor to userErrorsuserErrors •[TranslationUserError!]! non-null: The list of errors that occurred from executing the mutation.

Was this section helpful?

Examples

Remove a French product title translation

Description

Translations matching all of the inputs will be removed. In this example, we are removing the product title's French translation that is not specific to any market.

Query

mutation translationsRemove($resourceId: ID!, $translationKeys: [String!]!, $locales: [String!]!) {
  translationsRemove(resourceId: $resourceId, translationKeys: $translationKeys, locales: $locales) {
    userErrors {
      message
      field
    }
    translations {
      key
      value
    }
  }
}

Variables

{
  "resourceId": "gid://shopify/Product/20995642",
  "locales": [
    "fr"
  ],
  "translationKeys": [
    "title"
  ]
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-07/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation translationsRemove($resourceId: ID!, $translationKeys: [String!]!, $locales: [String!]!) { translationsRemove(resourceId: $resourceId, translationKeys: $translationKeys, locales: $locales) { userErrors { message field } translations { key value } } }",
 "variables": {
    "resourceId": "gid://shopify/Product/20995642",
    "locales": [
      "fr"
    ],
    "translationKeys": [
      "title"
    ]
  }
}'

Remix

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(
  `#graphql
  mutation translationsRemove($resourceId: ID!, $translationKeys: [String!]!, $locales: [String!]!) {
    translationsRemove(resourceId: $resourceId, translationKeys: $translationKeys, locales: $locales) {
      userErrors {
        message
        field
      }
      translations {
        key
        value
      }
    }
  }`,
  {
    variables: {
        "resourceId": "gid://shopify/Product/20995642",
        "locales": [
            "fr"
        ],
        "translationKeys": [
            "title"
        ]
    },
  },
);

const data = await response.json();

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation translationsRemove($resourceId: ID!, $translationKeys: [String!]!, $locales: [String!]!) {
    translationsRemove(resourceId: $resourceId, translationKeys: $translationKeys, locales: $locales) {
      userErrors {
        message
        field
      }
      translations {
        key
        value
      }
    }
  }
QUERY

variables = {
  "resourceId": "gid://shopify/Product/20995642",
  "locales": [
    "fr"
  ],
  "translationKeys": [
    "title"
  ]
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation translationsRemove($resourceId: ID!, $translationKeys: [String!]!, $locales: [String!]!) {
      translationsRemove(resourceId: $resourceId, translationKeys: $translationKeys, locales: $locales) {
        userErrors {
          message
          field
        }
        translations {
          key
          value
        }
      }
    }`,
    "variables": {
        "resourceId": "gid://shopify/Product/20995642",
        "locales": [
            "fr"
        ],
        "translationKeys": [
            "title"
        ]
    },
  },
});

Response

{
  "translationsRemove": {
    "userErrors": [],
    "translations": [
      {
        "key": "title",
        "value": "L'élément"
      }
    ]
  }
}

Remove a French product title translation specific to a market

Description

To remove content that surfaces only to buyers in specific markets, make use of the optional `marketIds` argument. In this example, the targeted market has an ID of `gid://shopify/Market/128989799`.

Query

mutation translationsRemove($resourceId: ID!, $translationKeys: [String!]!, $locales: [String!]!, $marketIds: [ID!]) {
  translationsRemove(resourceId: $resourceId, translationKeys: $translationKeys, locales: $locales, marketIds: $marketIds) {
    userErrors {
      message
      field
    }
    translations {
      key
      value
      market {
        id
      }
    }
  }
}

Variables

{
  "resourceId": "gid://shopify/Product/20995642",
  "locales": [
    "fr"
  ],
  "translationKeys": [
    "title"
  ],
  "marketIds": [
    "gid://shopify/Market/128989799"
  ]
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-07/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation translationsRemove($resourceId: ID!, $translationKeys: [String!]!, $locales: [String!]!, $marketIds: [ID!]) { translationsRemove(resourceId: $resourceId, translationKeys: $translationKeys, locales: $locales, marketIds: $marketIds) { userErrors { message field } translations { key value market { id } } } }",
 "variables": {
    "resourceId": "gid://shopify/Product/20995642",
    "locales": [
      "fr"
    ],
    "translationKeys": [
      "title"
    ],
    "marketIds": [
      "gid://shopify/Market/128989799"
    ]
  }
}'

Remix

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(
  `#graphql
  mutation translationsRemove($resourceId: ID!, $translationKeys: [String!]!, $locales: [String!]!, $marketIds: [ID!]) {
    translationsRemove(resourceId: $resourceId, translationKeys: $translationKeys, locales: $locales, marketIds: $marketIds) {
      userErrors {
        message
        field
      }
      translations {
        key
        value
        market {
          id
        }
      }
    }
  }`,
  {
    variables: {
        "resourceId": "gid://shopify/Product/20995642",
        "locales": [
            "fr"
        ],
        "translationKeys": [
            "title"
        ],
        "marketIds": [
            "gid://shopify/Market/128989799"
        ]
    },
  },
);

const data = await response.json();

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation translationsRemove($resourceId: ID!, $translationKeys: [String!]!, $locales: [String!]!, $marketIds: [ID!]) {
    translationsRemove(resourceId: $resourceId, translationKeys: $translationKeys, locales: $locales, marketIds: $marketIds) {
      userErrors {
        message
        field
      }
      translations {
        key
        value
        market {
          id
        }
      }
    }
  }
QUERY

variables = {
  "resourceId": "gid://shopify/Product/20995642",
  "locales": [
    "fr"
  ],
  "translationKeys": [
    "title"
  ],
  "marketIds": [
    "gid://shopify/Market/128989799"
  ]
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation translationsRemove($resourceId: ID!, $translationKeys: [String!]!, $locales: [String!]!, $marketIds: [ID!]) {
      translationsRemove(resourceId: $resourceId, translationKeys: $translationKeys, locales: $locales, marketIds: $marketIds) {
        userErrors {
          message
          field
        }
        translations {
          key
          value
          market {
            id
          }
        }
      }
    }`,
    "variables": {
        "resourceId": "gid://shopify/Product/20995642",
        "locales": [
            "fr"
        ],
        "translationKeys": [
            "title"
        ],
        "marketIds": [
            "gid://shopify/Market/128989799"
        ]
    },
  },
});

Response

{
  "translationsRemove": {
    "userErrors": [],
    "translations": [
      {
        "key": "title",
        "value": "L'élément canadien",
        "market": {
          "id": "gid://shopify/Market/128989799"
        }
      }
    ]
  }
}

translationsRemove reference

Examples

Open in GraphiQL

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(

`#graphql

mutation translationsRemove($resourceId: ID!, $translationKeys: [String!]!, $locales: [String!]!) {

translationsRemove(resourceId: $resourceId, translationKeys: $translationKeys, locales: $locales) {

userErrors {

message

field

}

translations {

key

value

}

}`,

{

variables: {

"resourceId": "gid://shopify/Product/20995642",

"locales": [

"fr"

"translationKeys": [

"title"

]

);

const data = await response.json();

mutation translationsRemove($resourceId: ID!, $translationKeys: [String!]!, $locales: [String!]!) {
  translationsRemove(resourceId: $resourceId, translationKeys: $translationKeys, locales: $locales) {
    userErrors {
      message
      field
    }
    translations {
      key
      value
    }
  }
}

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-07/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation translationsRemove($resourceId: ID!, $translationKeys: [String!]!, $locales: [String!]!) { translationsRemove(resourceId: $resourceId, translationKeys: $translationKeys, locales: $locales) { userErrors { message field } translations { key value } } }",
 "variables": {
    "resourceId": "gid://shopify/Product/20995642",
    "locales": [
      "fr"
    ],
    "translationKeys": [
      "title"
    ]
  }
}'

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(
  `#graphql
  mutation translationsRemove($resourceId: ID!, $translationKeys: [String!]!, $locales: [String!]!) {
    translationsRemove(resourceId: $resourceId, translationKeys: $translationKeys, locales: $locales) {
      userErrors {
        message
        field
      }
      translations {
        key
        value
      }
    }
  }`,
  {
    variables: {
        "resourceId": "gid://shopify/Product/20995642",
        "locales": [
            "fr"
        ],
        "translationKeys": [
            "title"
        ]
    },
  },
);

const data = await response.json();

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation translationsRemove($resourceId: ID!, $translationKeys: [String!]!, $locales: [String!]!) {
      translationsRemove(resourceId: $resourceId, translationKeys: $translationKeys, locales: $locales) {
        userErrors {
          message
          field
        }
        translations {
          key
          value
        }
      }
    }`,
    "variables": {
        "resourceId": "gid://shopify/Product/20995642",
        "locales": [
            "fr"
        ],
        "translationKeys": [
            "title"
        ]
    },
  },
});

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation translationsRemove($resourceId: ID!, $translationKeys: [String!]!, $locales: [String!]!) {
    translationsRemove(resourceId: $resourceId, translationKeys: $translationKeys, locales: $locales) {
      userErrors {
        message
        field
      }
      translations {
        key
        value
      }
    }
  }
QUERY

variables = {
  "resourceId": "gid://shopify/Product/20995642",
  "locales": [
    "fr"
  ],
  "translationKeys": [
    "title"
  ]
}

response = client.query(query: query, variables: variables)

Input variables

JSON

{

"resourceId": "gid://shopify/Product/20995642",

"locales": [

"fr"

"translationKeys": [

"title"

]

}

Response

JSON

{

"translationsRemove": {

"userErrors": [],

"translations": [

{

"key": "title",

"value": "L'élément"

}

]

}