Choose a version:

themeUpdate

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.

Updates a theme.

Anchor to Arguments

Arguments

Anchor to idid

•ID!

required

The ID of the theme to be updated.

Anchor to inputinput

•OnlineStoreThemeInput!

required

The attributes of the theme to be updated.

Show input fields

Was this section helpful?

Anchor to ThemeUpdatePayload returnsThemeUpdatePayload returns

Anchor to themetheme •OnlineStoreTheme: The theme that was updated.

Show fields
Anchor to userErrorsuserErrors •[ThemeUpdateUserError!]! non-null: The list of errors that occurred from executing the mutation.

Show fields

Was this section helpful?

Examples

Update the name of a theme

Query

mutation themeUpdate($id: ID!, $input: OnlineStoreThemeInput!) {
  themeUpdate(id: $id, input: $input) {
    theme {
      id
      name
    }
    userErrors {
      field
      message
    }
  }
}

Variables

{
  "id": "gid://shopify/OnlineStoreTheme/908009861",
  "input": {
    "name": "Dawn - Summer Sale"
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-07/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation themeUpdate($id: ID!, $input: OnlineStoreThemeInput!) { themeUpdate(id: $id, input: $input) { theme { id name } userErrors { field message } } }",
 "variables": {
    "id": "gid://shopify/OnlineStoreTheme/908009861",
    "input": {
      "name": "Dawn - Summer Sale"
    }
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation themeUpdate($id: ID!, $input: OnlineStoreThemeInput!) {
    themeUpdate(id: $id, input: $input) {
      theme {
        id
        name
      }
      userErrors {
        field
        message
      }
    }
  }`,
  {
    variables: {
        "id": "gid://shopify/OnlineStoreTheme/908009861",
        "input": {
            "name": "Dawn - Summer Sale"
        }
    },
  },
  );
  const json = await response.json();
  return json.data;
}

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 themeUpdate($id: ID!, $input: OnlineStoreThemeInput!) {
    themeUpdate(id: $id, input: $input) {
      theme {
        id
        name
      }
      userErrors {
        field
        message
      }
    }
  }
QUERY

variables = {
  "id": "gid://shopify/OnlineStoreTheme/908009861",
  "input": {
    "name": "Dawn - Summer Sale"
  }
}

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

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation themeUpdate($id: ID!, $input: OnlineStoreThemeInput!) {
      themeUpdate(id: $id, input: $input) {
        theme {
          id
          name
        }
        userErrors {
          field
          message
        }
      }
    }`,
    "variables": {
        "id": "gid://shopify/OnlineStoreTheme/908009861",
        "input": {
            "name": "Dawn - Summer Sale"
        }
    },
  },
});

Shopify CLI

shopify app execute \
--query \
'mutation themeUpdate($id: ID!, $input: OnlineStoreThemeInput!) {
  themeUpdate(id: $id, input: $input) {
    theme {
      id
      name
    }
    userErrors {
      field
      message
    }
  }
}' \
--variables \
'{
  "id": "gid://shopify/OnlineStoreTheme/908009861",
  "input": {
    "name": "Dawn - Summer Sale"
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-07/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      mutation themeUpdate($id: ID!, $input: OnlineStoreThemeInput!) {
        themeUpdate(id: $id, input: $input) {
          theme {
            id
            name
          }
          userErrors {
            field
            message
          }
        }
      }
    `,
    variables: {
        "id": "gid://shopify/OnlineStoreTheme/908009861",
        "input": {
            "name": "Dawn - Summer Sale"
        }
    },
  }),
});

const { data } = await response.json();
console.log(data);

Response

{
  "themeUpdate": {
    "theme": {
      "id": "gid://shopify/OnlineStoreTheme/908009861",
      "name": "Dawn - Summer Sale"
    },
    "userErrors": []
  }
}

themeUpdate reference

Examples

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {

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

const response = await admin.graphql(

`#graphql

mutation themeUpdate($id: ID!, $input: OnlineStoreThemeInput!) {

themeUpdate(id: $id, input: $input) {

theme {

name

}

userErrors {

field

message

}

}`,

{

variables: {

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

"input": {

"name": "Dawn - Summer Sale"

}

);

const json = await response.json();

return json.data;

}

GQL

mutation themeUpdate($id: ID!, $input: OnlineStoreThemeInput!) {
  themeUpdate(id: $id, input: $input) {
    theme {
      id
      name
    }
    userErrors {
      field
      message
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-07/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation themeUpdate($id: ID!, $input: OnlineStoreThemeInput!) { themeUpdate(id: $id, input: $input) { theme { id name } userErrors { field message } } }",
 "variables": {
    "id": "gid://shopify/OnlineStoreTheme/908009861",
    "input": {
      "name": "Dawn - Summer Sale"
    }
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation themeUpdate($id: ID!, $input: OnlineStoreThemeInput!) {
    themeUpdate(id: $id, input: $input) {
      theme {
        id
        name
      }
      userErrors {
        field
        message
      }
    }
  }`,
  {
    variables: {
        "id": "gid://shopify/OnlineStoreTheme/908009861",
        "input": {
            "name": "Dawn - Summer Sale"
        }
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation themeUpdate($id: ID!, $input: OnlineStoreThemeInput!) {
      themeUpdate(id: $id, input: $input) {
        theme {
          id
          name
        }
        userErrors {
          field
          message
        }
      }
    }`,
    "variables": {
        "id": "gid://shopify/OnlineStoreTheme/908009861",
        "input": {
            "name": "Dawn - Summer Sale"
        }
    },
  },
});

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 themeUpdate($id: ID!, $input: OnlineStoreThemeInput!) {
    themeUpdate(id: $id, input: $input) {
      theme {
        id
        name
      }
      userErrors {
        field
        message
      }
    }
  }
QUERY

variables = {
  "id": "gid://shopify/OnlineStoreTheme/908009861",
  "input": {
    "name": "Dawn - Summer Sale"
  }
}

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

Shopify CLI

shopify app execute \
--query \
'mutation themeUpdate($id: ID!, $input: OnlineStoreThemeInput!) {
  themeUpdate(id: $id, input: $input) {
    theme {
      id
      name
    }
    userErrors {
      field
      message
    }
  }
}' \
--variables \
'{
  "id": "gid://shopify/OnlineStoreTheme/908009861",
  "input": {
    "name": "Dawn - Summer Sale"
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-07/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      mutation themeUpdate($id: ID!, $input: OnlineStoreThemeInput!) {
        themeUpdate(id: $id, input: $input) {
          theme {
            id
            name
          }
          userErrors {
            field
            message
          }
        }
      }
    `,
    variables: {
        "id": "gid://shopify/OnlineStoreTheme/908009861",
        "input": {
            "name": "Dawn - Summer Sale"
        }
    },
  }),
});

const { data } = await response.json();
console.log(data);

Input variables

JSON

{

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

"input": {

"name": "Dawn - Summer Sale"

}

Response

JSON

{

"themeUpdate": {

"theme": {

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

"name": "Dawn - Summer Sale"

"userErrors": []

}