Choose a version:

articleUpdate

mutation

Requires Any of write_content, write_online_store_pages access scopes.

Updates an existing Article. You can modify the article's content, metadata, publication status, and associated properties like author information and tags.

If you update the handle, then you can optionally create a redirect from the old URL to the new one by setting redirectNewHandle to true.

Anchor to Arguments

Arguments

Anchor to articlearticle •ArticleUpdateInput! required: The properties of the article to be updated.
Anchor to blogblog •ArticleBlogInput: The properties of the blog to be created.
Anchor to idid •ID! required: The ID of the article to be updated.

Was this section helpful?

Anchor to ArticleUpdatePayload returnsArticleUpdatePayload returns

Anchor to articlearticle •Article: The article that was updated.
Anchor to userErrorsuserErrors •[ArticleUpdateUserError!]! non-null: The list of errors that occurred from executing the mutation.

Was this section helpful?

Examples

Updates an article

Query

mutation UpdateArticle($id: ID!, $article: ArticleUpdateInput!) {
  articleUpdate(id: $id, article: $article) {
    article {
      id
      title
      handle
      body
      summary
      tags
      image {
        altText
        originalSrc
      }
    }
    userErrors {
      code
      field
      message
    }
  }
}

Variables

{
  "id": "gid://shopify/Article/959752435",
  "article": {
    "title": "Updated Article Title",
    "handle": "updated-article-title",
    "body": "This is the updated content of the article.",
    "summary": "This is an updated summary of the article.",
    "tags": [
      "UpdatedTag1",
      "UpdatedTag2"
    ],
    "image": {
      "altText": "Updated alt text for the image",
      "url": "http://example.com/fake_image.jpg"
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-10/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation UpdateArticle($id: ID!, $article: ArticleUpdateInput!) { articleUpdate(id: $id, article: $article) { article { id title handle body summary tags image { altText originalSrc } } userErrors { code field message } } }",
 "variables": {
    "id": "gid://shopify/Article/959752435",
    "article": {
      "title": "Updated Article Title",
      "handle": "updated-article-title",
      "body": "This is the updated content of the article.",
      "summary": "This is an updated summary of the article.",
      "tags": [
        "UpdatedTag1",
        "UpdatedTag2"
      ],
      "image": {
        "altText": "Updated alt text for the image",
        "url": "http://example.com/fake_image.jpg"
      }
    }
  }
}'

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 UpdateArticle($id: ID!, $article: ArticleUpdateInput!) {
    articleUpdate(id: $id, article: $article) {
      article {
        id
        title
        handle
        body
        summary
        tags
        image {
          altText
          originalSrc
        }
      }
      userErrors {
        code
        field
        message
      }
    }
  }`,
  {
    variables: {
        "id": "gid://shopify/Article/959752435",
        "article": {
            "title": "Updated Article Title",
            "handle": "updated-article-title",
            "body": "This is the updated content of the article.",
            "summary": "This is an updated summary of the article.",
            "tags": [
                "UpdatedTag1",
                "UpdatedTag2"
            ],
            "image": {
                "altText": "Updated alt text for the image",
                "url": "http://example.com/fake_image.jpg"
            }
        }
    },
  },
  );
  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 UpdateArticle($id: ID!, $article: ArticleUpdateInput!) {
    articleUpdate(id: $id, article: $article) {
      article {
        id
        title
        handle
        body
        summary
        tags
        image {
          altText
          originalSrc
        }
      }
      userErrors {
        code
        field
        message
      }
    }
  }
QUERY

variables = {
  "id": "gid://shopify/Article/959752435",
  "article": {
    "title": "Updated Article Title",
    "handle": "updated-article-title",
    "body": "This is the updated content of the article.",
    "summary": "This is an updated summary of the article.",
    "tags": [
      "UpdatedTag1",
      "UpdatedTag2"
    ],
    "image": {
      "altText": "Updated alt text for the image",
      "url": "http://example.com/fake_image.jpg"
    }
  }
}

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

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation UpdateArticle($id: ID!, $article: ArticleUpdateInput!) {
      articleUpdate(id: $id, article: $article) {
        article {
          id
          title
          handle
          body
          summary
          tags
          image {
            altText
            originalSrc
          }
        }
        userErrors {
          code
          field
          message
        }
      }
    }`,
    "variables": {
        "id": "gid://shopify/Article/959752435",
        "article": {
            "title": "Updated Article Title",
            "handle": "updated-article-title",
            "body": "This is the updated content of the article.",
            "summary": "This is an updated summary of the article.",
            "tags": [
                "UpdatedTag1",
                "UpdatedTag2"
            ],
            "image": {
                "altText": "Updated alt text for the image",
                "url": "http://example.com/fake_image.jpg"
            }
        }
    },
  },
});

Response

{
  "articleUpdate": {
    "article": {
      "id": "gid://shopify/Article/959752435",
      "title": "Updated Article Title",
      "handle": "updated-article-title",
      "body": "This is the updated content of the article.",
      "summary": "This is an updated summary of the article.",
      "tags": [
        "UpdatedTag1",
        "UpdatedTag2"
      ],
      "image": {
        "altText": "Updated alt text for the image",
        "originalSrc": "https://cdn.shopify.com/s/files/1/2637/1970/articles/fake_image.jpg?v=1730243702"
      }
    },
    "userErrors": []
  }
}

articleUpdate reference

Examples

Open in GraphiQL

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

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

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

const response = await admin.graphql(

`#graphql

mutation UpdateArticle($id: ID!, $article: ArticleUpdateInput!) {

articleUpdate(id: $id, article: $article) {

article {

title

handle

body

summary

GQL

mutation UpdateArticle($id: ID!, $article: ArticleUpdateInput!) {
  articleUpdate(id: $id, article: $article) {
    article {
      id
      title
      handle
      body
      summary
      tags
      image {
        altText
        originalSrc
      }
    }
    userErrors {
      code
      field
      message
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-10/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation UpdateArticle($id: ID!, $article: ArticleUpdateInput!) { articleUpdate(id: $id, article: $article) { article { id title handle body summary tags image { altText originalSrc } } userErrors { code field message } } }",
 "variables": {
    "id": "gid://shopify/Article/959752435",
    "article": {
      "title": "Updated Article Title",
      "handle": "updated-article-title",
      "body": "This is the updated content of the article.",
      "summary": "This is an updated summary of the article.",
      "tags": [
        "UpdatedTag1",
        "UpdatedTag2"
      ],
      "image": {
        "altText": "Updated alt text for the image",
        "url": "http://example.com/fake_image.jpg"
      }
    }
  }
}'

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 UpdateArticle($id: ID!, $article: ArticleUpdateInput!) {
    articleUpdate(id: $id, article: $article) {
      article {
        id
        title
        handle
        body
        summary
        tags
        image {
          altText
          originalSrc
        }
      }
      userErrors {
        code
        field
        message
      }
    }
  }`,
  {
    variables: {
        "id": "gid://shopify/Article/959752435",
        "article": {
            "title": "Updated Article Title",
            "handle": "updated-article-title",
            "body": "This is the updated content of the article.",
            "summary": "This is an updated summary of the article.",
            "tags": [
                "UpdatedTag1",
                "UpdatedTag2"
            ],
            "image": {
                "altText": "Updated alt text for the image",
                "url": "http://example.com/fake_image.jpg"
            }
        }
    },
  },
  );
  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 UpdateArticle($id: ID!, $article: ArticleUpdateInput!) {
      articleUpdate(id: $id, article: $article) {
        article {
          id
          title
          handle
          body
          summary
          tags
          image {
            altText
            originalSrc
          }
        }
        userErrors {
          code
          field
          message
        }
      }
    }`,
    "variables": {
        "id": "gid://shopify/Article/959752435",
        "article": {
            "title": "Updated Article Title",
            "handle": "updated-article-title",
            "body": "This is the updated content of the article.",
            "summary": "This is an updated summary of the article.",
            "tags": [
                "UpdatedTag1",
                "UpdatedTag2"
            ],
            "image": {
                "altText": "Updated alt text for the image",
                "url": "http://example.com/fake_image.jpg"
            }
        }
    },
  },
});

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 UpdateArticle($id: ID!, $article: ArticleUpdateInput!) {
    articleUpdate(id: $id, article: $article) {
      article {
        id
        title
        handle
        body
        summary
        tags
        image {
          altText
          originalSrc
        }
      }
      userErrors {
        code
        field
        message
      }
    }
  }
QUERY

variables = {
  "id": "gid://shopify/Article/959752435",
  "article": {
    "title": "Updated Article Title",
    "handle": "updated-article-title",
    "body": "This is the updated content of the article.",
    "summary": "This is an updated summary of the article.",
    "tags": [
      "UpdatedTag1",
      "UpdatedTag2"
    ],
    "image": {
      "altText": "Updated alt text for the image",
      "url": "http://example.com/fake_image.jpg"
    }
  }
}

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

Input variables

JSON

{

"id": "gid://shopify/Article/959752435",

"article": {

"title": "Updated Article Title",

"handle": "updated-article-title",

"body": "This is the updated content of the article.",

"summary": "This is an updated summary of the article.",

"tags": [

"UpdatedTag1",

"UpdatedTag2"

"image": {

"altText": "Updated alt text for the image",

"url": "http://example.com/fake_image.jpg"

}