Choose a version:

themeDelete

mutation

Requires The user needs write_themes and an exemption from Shopify to modify themes. If you think that your app is eligible for an exemption and should have access to this API, then you can submit an exception request.

Deletes a theme.

Arguments

Anchor to idid •ID!required: The ID of the theme to be deleted.

Was this section helpful?

Anchor to ThemeDeletePayload returnsThemeDeletePayload returns

Anchor to deletedThemeIddeletedThemeId •ID: The ID of the deleted theme.
Anchor to userErrorsuserErrors •[ThemeDeleteUserError!]!non-null: The list of errors that occurred from executing the mutation.

Was this section helpful?

Delete a theme by its ID
Remove an existing Theme
themeDelete reference

Examples

Open in GraphiQL

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

const response = await admin.graphql(

`#graphql

mutation themeDelete($id: ID!) {

themeDelete(id: $id) {

deletedThemeId

userErrors {

field

message

}

}`,

{

variables: {

"id": "gid://shopify/OnlineStoreTheme/908009861"

);

const data = await response.json();

mutation themeDelete($id: ID!) {
  themeDelete(id: $id) {
    deletedThemeId
    userErrors {
      field
      message
    }
  }
}

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation themeDelete($id: ID!) { themeDelete(id: $id) { deletedThemeId userErrors { field message } } }",
 "variables": {
    "id": "gid://shopify/OnlineStoreTheme/908009861"
  }
}'

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

const response = await admin.graphql(
  `#graphql
  mutation themeDelete($id: ID!) {
    themeDelete(id: $id) {
      deletedThemeId
      userErrors {
        field
        message
      }
    }
  }`,
  {
    variables: {
      "id": "gid://shopify/OnlineStoreTheme/908009861"
    },
  },
);

const data = await response.json();

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation themeDelete($id: ID!) {
      themeDelete(id: $id) {
        deletedThemeId
        userErrors {
          field
          message
        }
      }
    }`,
    "variables": {
      "id": "gid://shopify/OnlineStoreTheme/908009861"
    },
  },
});

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 themeDelete($id: ID!) {
    themeDelete(id: $id) {
      deletedThemeId
      userErrors {
        field
        message
      }
    }
  }
QUERY

variables = {
  "id": "gid://shopify/OnlineStoreTheme/908009861"
}

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

Input variables

JSON

{

"id": "gid://shopify/OnlineStoreTheme/908009861"

}

Response

JSON

{

"themeDelete": {

"deletedThemeId": "gid://shopify/OnlineStoreTheme/908009861",

"userErrors": []

}