Choose a version:

articleCreate

mutation

Requires Any of write_content, write_online_store_pages access scopes.

Creates an Article. Articles are content pieces that include a title, body text, and author information.

You can publish the article immediately or schedule it with a specific publish date. You can customize the article's URL handle, apply custom templates for rendering, and add optional fields like tags, an image, and Metafield objects.

The mutation validates article content and ensures proper blog association. Error handling provides specific feedback for content requirements.

Anchor to Arguments

Arguments

Anchor to articlearticle

•ArticleCreateInput!

required

The properties of the new article.

Show input fields

Anchor to blogblog

•ArticleBlogInput

The properties of the new blog.

Show input fields

Was this section helpful?

Anchor to ArticleCreatePayload returnsArticleCreatePayload returns

Anchor to articlearticle •Article: The article that was created.

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

Show fields

Was this section helpful?

Examples

Creates an article for a blog

Query

mutation CreateArticle($article: ArticleCreateInput!) {
  articleCreate(article: $article) {
    article {
      id
      title
      author {
        name
      }
      handle
      body
      summary
      tags
      image {
        altText
        originalSrc
      }
    }
    userErrors {
      code
      field
      message
    }
  }
}

Variables

{
  "article": {
    "blogId": "gid://shopify/Blog/389767568",
    "title": "New Article Title",
    "author": {
      "name": "Test User"
    },
    "handle": "new-article-title",
    "body": "This is the content of the article.",
    "summary": "This is a summary of the article.",
    "isPublished": true,
    "publishDate": "2023-01-01T12:00:00Z",
    "tags": [
      "Tag1",
      "Tag2"
    ],
    "image": {
      "altText": "Alt text for the image",
      "url": "http://example.com/fake_image.jpg"
    }
  }
}

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 CreateArticle($article: ArticleCreateInput!) { articleCreate(article: $article) { article { id title author { name } handle body summary tags image { altText originalSrc } } userErrors { code field message } } }",
 "variables": {
    "article": {
      "blogId": "gid://shopify/Blog/389767568",
      "title": "New Article Title",
      "author": {
        "name": "Test User"
      },
      "handle": "new-article-title",
      "body": "This is the content of the article.",
      "summary": "This is a summary of the article.",
      "isPublished": true,
      "publishDate": "2023-01-01T12:00:00Z",
      "tags": [
        "Tag1",
        "Tag2"
      ],
      "image": {
        "altText": "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 CreateArticle($article: ArticleCreateInput!) {
    articleCreate(article: $article) {
      article {
        id
        title
        author {
          name
        }
        handle
        body
        summary
        tags
        image {
          altText
          originalSrc
        }
      }
      userErrors {
        code
        field
        message
      }
    }
  }`,
  {
    variables: {
        "article": {
            "blogId": "gid://shopify/Blog/389767568",
            "title": "New Article Title",
            "author": {
                "name": "Test User"
            },
            "handle": "new-article-title",
            "body": "This is the content of the article.",
            "summary": "This is a summary of the article.",
            "isPublished": true,
            "publishDate": "2023-01-01T12:00:00Z",
            "tags": [
                "Tag1",
                "Tag2"
            ],
            "image": {
                "altText": "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 CreateArticle($article: ArticleCreateInput!) {
    articleCreate(article: $article) {
      article {
        id
        title
        author {
          name
        }
        handle
        body
        summary
        tags
        image {
          altText
          originalSrc
        }
      }
      userErrors {
        code
        field
        message
      }
    }
  }
QUERY

variables = {
  "article": {
    "blogId": "gid://shopify/Blog/389767568",
    "title": "New Article Title",
    "author": {
      "name": "Test User"
    },
    "handle": "new-article-title",
    "body": "This is the content of the article.",
    "summary": "This is a summary of the article.",
    "isPublished": true,
    "publishDate": "2023-01-01T12:00:00Z",
    "tags": [
      "Tag1",
      "Tag2"
    ],
    "image": {
      "altText": "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 CreateArticle($article: ArticleCreateInput!) {
      articleCreate(article: $article) {
        article {
          id
          title
          author {
            name
          }
          handle
          body
          summary
          tags
          image {
            altText
            originalSrc
          }
        }
        userErrors {
          code
          field
          message
        }
      }
    }`,
    "variables": {
        "article": {
            "blogId": "gid://shopify/Blog/389767568",
            "title": "New Article Title",
            "author": {
                "name": "Test User"
            },
            "handle": "new-article-title",
            "body": "This is the content of the article.",
            "summary": "This is a summary of the article.",
            "isPublished": true,
            "publishDate": "2023-01-01T12:00:00Z",
            "tags": [
                "Tag1",
                "Tag2"
            ],
            "image": {
                "altText": "Alt text for the image",
                "url": "http://example.com/fake_image.jpg"
            }
        }
    },
  },
});

Shopify CLI

shopify app execute \
--query \
'mutation CreateArticle($article: ArticleCreateInput!) {
  articleCreate(article: $article) {
    article {
      id
      title
      author {
        name
      }
      handle
      body
      summary
      tags
      image {
        altText
        originalSrc
      }
    }
    userErrors {
      code
      field
      message
    }
  }
}' \
--variables \
'{
  "article": {
    "blogId": "gid://shopify/Blog/389767568",
    "title": "New Article Title",
    "author": {
      "name": "Test User"
    },
    "handle": "new-article-title",
    "body": "This is the content of the article.",
    "summary": "This is a summary of the article.",
    "isPublished": true,
    "publishDate": "2023-01-01T12:00:00Z",
    "tags": [
      "Tag1",
      "Tag2"
    ],
    "image": {
      "altText": "Alt text for the image",
      "url": "http://example.com/fake_image.jpg"
    }
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-07/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      mutation CreateArticle($article: ArticleCreateInput!) {
        articleCreate(article: $article) {
          article {
            id
            title
            author {
              name
            }
            handle
            body
            summary
            tags
            image {
              altText
              originalSrc
            }
          }
          userErrors {
            code
            field
            message
          }
        }
      }
    `,
    variables: {
        "article": {
            "blogId": "gid://shopify/Blog/389767568",
            "title": "New Article Title",
            "author": {
                "name": "Test User"
            },
            "handle": "new-article-title",
            "body": "This is the content of the article.",
            "summary": "This is a summary of the article.",
            "isPublished": true,
            "publishDate": "2023-01-01T12:00:00Z",
            "tags": [
                "Tag1",
                "Tag2"
            ],
            "image": {
                "altText": "Alt text for the image",
                "url": "http://example.com/fake_image.jpg"
            }
        }
    },
  }),
});

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

Response

{
  "articleCreate": {
    "article": {
      "id": "gid://shopify/Article/1051293784",
      "title": "New Article Title",
      "author": {
        "name": "Test User"
      },
      "handle": "new-article-title",
      "body": "This is the content of the article.",
      "summary": "This is a summary of the article.",
      "tags": [
        "Tag1",
        "Tag2"
      ],
      "image": {
        "altText": "Alt text for the image",
        "originalSrc": "https://cdn.shopify.com/s/files/1/2637/1970/articles/fake_image.jpg?v=1730243735"
      }
    },
    "userErrors": []
  }
}

articleCreate 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 CreateArticle($article: ArticleCreateInput!) {

articleCreate(article: $article) {

article {

title

author {

name

}

handle

body

summary

GQL

mutation CreateArticle($article: ArticleCreateInput!) {
  articleCreate(article: $article) {
    article {
      id
      title
      author {
        name
      }
      handle
      body
      summary
      tags
      image {
        altText
        originalSrc
      }
    }
    userErrors {
      code
      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 CreateArticle($article: ArticleCreateInput!) { articleCreate(article: $article) { article { id title author { name } handle body summary tags image { altText originalSrc } } userErrors { code field message } } }",
 "variables": {
    "article": {
      "blogId": "gid://shopify/Blog/389767568",
      "title": "New Article Title",
      "author": {
        "name": "Test User"
      },
      "handle": "new-article-title",
      "body": "This is the content of the article.",
      "summary": "This is a summary of the article.",
      "isPublished": true,
      "publishDate": "2023-01-01T12:00:00Z",
      "tags": [
        "Tag1",
        "Tag2"
      ],
      "image": {
        "altText": "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 CreateArticle($article: ArticleCreateInput!) {
    articleCreate(article: $article) {
      article {
        id
        title
        author {
          name
        }
        handle
        body
        summary
        tags
        image {
          altText
          originalSrc
        }
      }
      userErrors {
        code
        field
        message
      }
    }
  }`,
  {
    variables: {
        "article": {
            "blogId": "gid://shopify/Blog/389767568",
            "title": "New Article Title",
            "author": {
                "name": "Test User"
            },
            "handle": "new-article-title",
            "body": "This is the content of the article.",
            "summary": "This is a summary of the article.",
            "isPublished": true,
            "publishDate": "2023-01-01T12:00:00Z",
            "tags": [
                "Tag1",
                "Tag2"
            ],
            "image": {
                "altText": "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 CreateArticle($article: ArticleCreateInput!) {
      articleCreate(article: $article) {
        article {
          id
          title
          author {
            name
          }
          handle
          body
          summary
          tags
          image {
            altText
            originalSrc
          }
        }
        userErrors {
          code
          field
          message
        }
      }
    }`,
    "variables": {
        "article": {
            "blogId": "gid://shopify/Blog/389767568",
            "title": "New Article Title",
            "author": {
                "name": "Test User"
            },
            "handle": "new-article-title",
            "body": "This is the content of the article.",
            "summary": "This is a summary of the article.",
            "isPublished": true,
            "publishDate": "2023-01-01T12:00:00Z",
            "tags": [
                "Tag1",
                "Tag2"
            ],
            "image": {
                "altText": "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 CreateArticle($article: ArticleCreateInput!) {
    articleCreate(article: $article) {
      article {
        id
        title
        author {
          name
        }
        handle
        body
        summary
        tags
        image {
          altText
          originalSrc
        }
      }
      userErrors {
        code
        field
        message
      }
    }
  }
QUERY

variables = {
  "article": {
    "blogId": "gid://shopify/Blog/389767568",
    "title": "New Article Title",
    "author": {
      "name": "Test User"
    },
    "handle": "new-article-title",
    "body": "This is the content of the article.",
    "summary": "This is a summary of the article.",
    "isPublished": true,
    "publishDate": "2023-01-01T12:00:00Z",
    "tags": [
      "Tag1",
      "Tag2"
    ],
    "image": {
      "altText": "Alt text for the image",
      "url": "http://example.com/fake_image.jpg"
    }
  }
}

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

Shopify CLI

shopify app execute \
--query \
'mutation CreateArticle($article: ArticleCreateInput!) {
  articleCreate(article: $article) {
    article {
      id
      title
      author {
        name
      }
      handle
      body
      summary
      tags
      image {
        altText
        originalSrc
      }
    }
    userErrors {
      code
      field
      message
    }
  }
}' \
--variables \
'{
  "article": {
    "blogId": "gid://shopify/Blog/389767568",
    "title": "New Article Title",
    "author": {
      "name": "Test User"
    },
    "handle": "new-article-title",
    "body": "This is the content of the article.",
    "summary": "This is a summary of the article.",
    "isPublished": true,
    "publishDate": "2023-01-01T12:00:00Z",
    "tags": [
      "Tag1",
      "Tag2"
    ],
    "image": {
      "altText": "Alt text for the image",
      "url": "http://example.com/fake_image.jpg"
    }
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-07/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      mutation CreateArticle($article: ArticleCreateInput!) {
        articleCreate(article: $article) {
          article {
            id
            title
            author {
              name
            }
            handle
            body
            summary
            tags
            image {
              altText
              originalSrc
            }
          }
          userErrors {
            code
            field
            message
          }
        }
      }
    `,
    variables: {
        "article": {
            "blogId": "gid://shopify/Blog/389767568",
            "title": "New Article Title",
            "author": {
                "name": "Test User"
            },
            "handle": "new-article-title",
            "body": "This is the content of the article.",
            "summary": "This is a summary of the article.",
            "isPublished": true,
            "publishDate": "2023-01-01T12:00:00Z",
            "tags": [
                "Tag1",
                "Tag2"
            ],
            "image": {
                "altText": "Alt text for the image",
                "url": "http://example.com/fake_image.jpg"
            }
        }
    },
  }),
});

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

Input variables

JSON

{

"article": {

"blogId": "gid://shopify/Blog/389767568",

"title": "New Article Title",

"author": {

"name": "Test User"

"handle": "new-article-title",

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

"summary": "This is a summary of the article.",

"isPublished": true,

"publishDate": "2023-01-01T12:00:00Z",

"tags": [

"Tag1",

"Tag2"

"image": {

"altText": "Alt text for the image",

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

}