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.

Anchor to blogblog

•ArticleBlogInput

The properties of the new blog.

Was this section helpful?

Anchor to ArticleCreatePayload returnsArticleCreatePayload returns

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

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-01/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"
    }
  }
}'

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

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 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-01/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"
    }
  }
}'

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"

}