Choose a version:

scriptTagUpdate

mutation

Requires write_script_tags access scope. Also: Requires access to script tags.

Theme app extensions

If your app integrates with a Shopify theme and you plan to submit it to the Shopify App Store, you must use theme app extensions instead of Script tags. Script tags can only be used with vintage themes. Learn more.

Updates a script tag.

Anchor to Arguments

Arguments

Anchor to idid

•ID!

required

The ID of the script tag to update.

Anchor to inputinput

•ScriptTagInput!

required

Specifies the input fields for a script tag.

Was this section helpful?

Anchor to ScriptTagUpdatePayload returnsScriptTagUpdatePayload returns

Anchor to scriptTagscriptTag •ScriptTag: The script tag that was updated.
Anchor to userErrorsuserErrors •[UserError!]! non-null: The list of errors that occurred from executing the mutation.

Was this section helpful?

Examples

Updates a script tag

Query

mutation ScriptTagUpdate($id: ID!, $input: ScriptTagInput!) {
  scriptTagUpdate(id: $id, input: $input) {
    scriptTag {
      id
      cache
      createdAt
      displayScope
      src
      updatedAt
    }
    userErrors {
      field
      message
    }
  }
}

Variables

{
  "id": "gid://shopify/ScriptTag/421379493",
  "input": {
    "src": "https://js.example.org/updated.js",
    "displayScope": "ONLINE_STORE"
  }
}

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 ScriptTagUpdate($id: ID!, $input: ScriptTagInput!) { scriptTagUpdate(id: $id, input: $input) { scriptTag { id cache createdAt displayScope src updatedAt } userErrors { field message } } }",
 "variables": {
    "id": "gid://shopify/ScriptTag/421379493",
    "input": {
      "src": "https://js.example.org/updated.js",
      "displayScope": "ONLINE_STORE"
    }
  }
}'

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 ScriptTagUpdate($id: ID!, $input: ScriptTagInput!) {
    scriptTagUpdate(id: $id, input: $input) {
      scriptTag {
        id
        cache
        createdAt
        displayScope
        src
        updatedAt
      }
      userErrors {
        field
        message
      }
    }
  }`,
  {
    variables: {
        "id": "gid://shopify/ScriptTag/421379493",
        "input": {
            "src": "https://js.example.org/updated.js",
            "displayScope": "ONLINE_STORE"
        }
    },
  },
  );
  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 ScriptTagUpdate($id: ID!, $input: ScriptTagInput!) {
    scriptTagUpdate(id: $id, input: $input) {
      scriptTag {
        id
        cache
        createdAt
        displayScope
        src
        updatedAt
      }
      userErrors {
        field
        message
      }
    }
  }
QUERY

variables = {
  "id": "gid://shopify/ScriptTag/421379493",
  "input": {
    "src": "https://js.example.org/updated.js",
    "displayScope": "ONLINE_STORE"
  }
}

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

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation ScriptTagUpdate($id: ID!, $input: ScriptTagInput!) {
      scriptTagUpdate(id: $id, input: $input) {
        scriptTag {
          id
          cache
          createdAt
          displayScope
          src
          updatedAt
        }
        userErrors {
          field
          message
        }
      }
    }`,
    "variables": {
        "id": "gid://shopify/ScriptTag/421379493",
        "input": {
            "src": "https://js.example.org/updated.js",
            "displayScope": "ONLINE_STORE"
        }
    },
  },
});

Shopify CLI

shopify app execute \
--query \
'mutation ScriptTagUpdate($id: ID!, $input: ScriptTagInput!) {
  scriptTagUpdate(id: $id, input: $input) {
    scriptTag {
      id
      cache
      createdAt
      displayScope
      src
      updatedAt
    }
    userErrors {
      field
      message
    }
  }
}' \
--variables \
'{
  "id": "gid://shopify/ScriptTag/421379493",
  "input": {
    "src": "https://js.example.org/updated.js",
    "displayScope": "ONLINE_STORE"
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-07/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      mutation ScriptTagUpdate($id: ID!, $input: ScriptTagInput!) {
        scriptTagUpdate(id: $id, input: $input) {
          scriptTag {
            id
            cache
            createdAt
            displayScope
            src
            updatedAt
          }
          userErrors {
            field
            message
          }
        }
      }
    `,
    variables: {
        "id": "gid://shopify/ScriptTag/421379493",
        "input": {
            "src": "https://js.example.org/updated.js",
            "displayScope": "ONLINE_STORE"
        }
    },
  }),
});

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

Response

{
  "scriptTagUpdate": {
    "scriptTag": {
      "id": "gid://shopify/ScriptTag/421379493",
      "cache": false,
      "createdAt": "2024-12-18T11:35:33Z",
      "displayScope": "ONLINE_STORE",
      "src": "https://js.example.org/updated.js",
      "updatedAt": "2024-12-18T11:37:33Z"
    },
    "userErrors": []
  }
}

scriptTagUpdate 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 ScriptTagUpdate($id: ID!, $input: ScriptTagInput!) {

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

scriptTag {

cache

createdAt

displayScope

src

updatedAt

}

userErrors {

field

message

}

}`,

{

variables: {

"id": "gid://shopify/ScriptTag/421379493",

"input": {

"src": "https://js.example.org/updated.js",

"displayScope": "ONLINE_STORE"

}

);

const json = await response.json();

return json.data;

}

GQL

mutation ScriptTagUpdate($id: ID!, $input: ScriptTagInput!) {
  scriptTagUpdate(id: $id, input: $input) {
    scriptTag {
      id
      cache
      createdAt
      displayScope
      src
      updatedAt
    }
    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 ScriptTagUpdate($id: ID!, $input: ScriptTagInput!) { scriptTagUpdate(id: $id, input: $input) { scriptTag { id cache createdAt displayScope src updatedAt } userErrors { field message } } }",
 "variables": {
    "id": "gid://shopify/ScriptTag/421379493",
    "input": {
      "src": "https://js.example.org/updated.js",
      "displayScope": "ONLINE_STORE"
    }
  }
}'

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 ScriptTagUpdate($id: ID!, $input: ScriptTagInput!) {
    scriptTagUpdate(id: $id, input: $input) {
      scriptTag {
        id
        cache
        createdAt
        displayScope
        src
        updatedAt
      }
      userErrors {
        field
        message
      }
    }
  }`,
  {
    variables: {
        "id": "gid://shopify/ScriptTag/421379493",
        "input": {
            "src": "https://js.example.org/updated.js",
            "displayScope": "ONLINE_STORE"
        }
    },
  },
  );
  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 ScriptTagUpdate($id: ID!, $input: ScriptTagInput!) {
      scriptTagUpdate(id: $id, input: $input) {
        scriptTag {
          id
          cache
          createdAt
          displayScope
          src
          updatedAt
        }
        userErrors {
          field
          message
        }
      }
    }`,
    "variables": {
        "id": "gid://shopify/ScriptTag/421379493",
        "input": {
            "src": "https://js.example.org/updated.js",
            "displayScope": "ONLINE_STORE"
        }
    },
  },
});

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 ScriptTagUpdate($id: ID!, $input: ScriptTagInput!) {
    scriptTagUpdate(id: $id, input: $input) {
      scriptTag {
        id
        cache
        createdAt
        displayScope
        src
        updatedAt
      }
      userErrors {
        field
        message
      }
    }
  }
QUERY

variables = {
  "id": "gid://shopify/ScriptTag/421379493",
  "input": {
    "src": "https://js.example.org/updated.js",
    "displayScope": "ONLINE_STORE"
  }
}

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

Shopify CLI

shopify app execute \
--query \
'mutation ScriptTagUpdate($id: ID!, $input: ScriptTagInput!) {
  scriptTagUpdate(id: $id, input: $input) {
    scriptTag {
      id
      cache
      createdAt
      displayScope
      src
      updatedAt
    }
    userErrors {
      field
      message
    }
  }
}' \
--variables \
'{
  "id": "gid://shopify/ScriptTag/421379493",
  "input": {
    "src": "https://js.example.org/updated.js",
    "displayScope": "ONLINE_STORE"
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-07/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      mutation ScriptTagUpdate($id: ID!, $input: ScriptTagInput!) {
        scriptTagUpdate(id: $id, input: $input) {
          scriptTag {
            id
            cache
            createdAt
            displayScope
            src
            updatedAt
          }
          userErrors {
            field
            message
          }
        }
      }
    `,
    variables: {
        "id": "gid://shopify/ScriptTag/421379493",
        "input": {
            "src": "https://js.example.org/updated.js",
            "displayScope": "ONLINE_STORE"
        }
    },
  }),
});

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

Input variables

JSON

{

"id": "gid://shopify/ScriptTag/421379493",

"input": {

"src": "https://js.example.org/updated.js",

"displayScope": "ONLINE_STORE"

}

Response

JSON

{

"scriptTagUpdate": {

"scriptTag": {

"id": "gid://shopify/ScriptTag/421379493",

"cache": false,

"createdAt": "2024-12-18T11:35:33Z",

"displayScope": "ONLINE_STORE",

"src": "https://js.example.org/updated.js",

"updatedAt": "2024-12-18T11:37:33Z"

"userErrors": []

}