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
Article → Update
AI-generatedSummary
Updates a Shopify article's content and metadata via GraphQL. The operation accepts a global Article ID (required) and optional fields for title, author, body, tags, image, and publish status.
Inputs
- Authentication (required) — Select Admin API Credentials (legacy token or OAuth2) or OAuth2 flow.
- Article ID (required) — Global article ID in Shopify (e.g., gid://shopify/Article/123456).
- Blog ID — Global blog ID in Shopify (e.g., gid://shopify/Blog/123456).
- Title — Article title.
- Author Source — Whether to use Author Name or Staff User ID.
- Author Name — Author name (used when Author Source is 'name').
- Author User ID — Global staff user ID (used when Author Source is 'userId').
- Handle — Article handle for the URL.
- Body HTML — Article body content as HTML.
- Summary HTML — Article summary content as HTML.
- Article Image — Image object with alt text and public URL.
- Publish Date — ISO datetime when the article becomes visible.
- Tags — Comma-separated tags.
- Template Suffix — Custom template suffix (e.g., 'custom').
- Article Options — Boolean options for 'Is Published' and 'Redirect New Handle'.
- Output Mode — Controls output shape: 'simplified', 'raw', or 'selectedFields'.
- Selected Fields — Comma-separated list of fields to return (e.g., 'ID,title,status').
Output shape
a single record (the updated article data)
The 'raw' output mode returns the full GraphQL response; 'selectedFields' returns only specified fields. Errors are exposed in the item's error envelope.
Examples
Example 1: Update an article's title and publish status
Article ID set to 'gid://shopify/Article/123456', Title set to 'New Title', Article Options: Is Published = true.
Example 2: Update article body, tags, and image
Body HTML provided, Tags set to 'news,featured', Article Image with URL and alt text.
Example 3: Update article author using Staff User ID
Article ID provided, Author Source set to 'userId', Author User ID set to 'gid://shopify/StaffMember/789'.