Actions83
- Product Actions
- Product Variant Actions
- Collection Actions
- Article Actions
- Blog Actions
- Customer Actions
- Order Actions
- Draft Order Actions
- Inventory Actions
- File Actions
- Publication Actions
- Translation Actions
- Taxonomy Actions
- Metaobject Actions
- Metaobject Definition Actions
- Metafield Value Actions
- Metafield Definition Actions
- Service Actions
Blog → Create
AI-generatedSummary
Creates a new blog in a Shopify store through the Admin GraphQL API and returns the created blog in the chosen output format.
Inputs
- Authentication — Credential method: Admin API Credentials (legacy access token or Dev Dashboard client credentials) or OAuth2. Defaults to Admin API.
- Title (required) — Title of the new blog.
- Handle — URL handle for the blog. If left empty, it is presumably generated by Shopify.
- Template Suffix — Theme template suffix (e.g. 'custom' for blog.custom.json). Leave empty to use the default template.
- Options — Collection of optional settings. Currently only Comment Policy: Auto Published, Closed, or Moderated (default Moderated).
- Output Mode — Simplified (default), Raw (full API payload), or Selected Fields.
- Selected Fields — Comma-separated field names to keep (e.g. ID,title,status). Shown only when Output Mode is Selected Fields.
Output shape
The created blog as a single item, shaped according to Output Mode: simplified fields, the raw API response, or only the selected fields.
Shopify user errors returned by the mutation are thrown as node errors. The source pack shows only signatures, so the exact simplified field list is not visible. The registry's blog return helper defaults to commentPolicy, createdAt, tags and templateSuffix.
Examples
Example 1: Create a moderated news blog
Title='Company News', Handle='news', Options > Comment Policy=Moderated, Output Mode=Simplified.
Example 2: Create a blog with a custom theme template and comments closed
Title='Lookbook', Template Suffix='lookbook', Comment Policy=Closed.
Example 3: Get only the new blog's ID for later article creation
Title='Guides', Output Mode=Selected Fields, Selected Fields='id,title'.