Shopify Content
Look up Admin API mutations and REST endpoints when your agent creates or updates Shopify pages, blog posts, redirects, and SEO fields.
Overview
Shopify Content is an agent skill for the Build phase that documents Shopify Admin API patterns for pages, blogs, articles, redirects, and SEO-related fields.
Install
npx skills add https://github.com/jezweb/claude-skills --skill shopify-contentWhat is this skill?
- GraphQL reference for pages (list, pageCreate, pageUpdate, pageDelete) with title, handle, body HTML, publish flag, and
- Blog and article CRUD via articleCreate, articleUpdate, articleDelete including author, tags, publishDate, and image alt
- REST redirect table for GET/POST/PUT/DELETE on /admin/api/2025-01/redirects.json with path and target fields
- Documents core content fields: templateSuffix, contentHtml, isPublished, and seo title/description in one place
- Pairs Admin API patterns with agent workflows so you do not guess mutation names mid-build
- Covers pages, blogs/articles, and redirects with explicit 2025-01 REST redirect paths
- Tables list GraphQL list/create/update/delete operations per content type
Adoption & trust: 853 installs on skills.sh; 841 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You are coding Shopify content changes but keep mixing GraphQL mutations, REST redirect routes, and field names across API versions.
Who is it for?
Indie devs and agents maintaining Shopify pages, blog posts, and redirects via the 2025-01 Admin API.
Skip if: Teams that only edit content in the Shopify admin UI with no API or automation, or builds that need full theme, checkout, or app OAuth setup from scratch.
When should I use this skill?
Implementing or debugging Shopify Admin content APIs for pages, articles, or redirects in an agent-driven build.
What do I get? / Deliverables
Your agent applies the correct Admin operation and field list for each content type without hunting scattered Shopify documentation.
- Correct GraphQL mutations and queries for Shopify content types
- REST redirect payloads matching documented endpoints
Recommended Skills
Journey fit
Store content is wired through Shopify Admin APIs during product build, before launch copy goes live. The skill is an integration cheat sheet for GraphQL page/article operations and REST redirects—not a merchandising or growth playbook.
How it compares
Use as a field-and-endpoint reference alongside generic REST skills—not as a storefront theme or Liquid templating guide.
Common Questions / FAQ
Who is shopify-content for?
Solo builders and small teams automating Shopify pages, articles, and redirects through an AI coding agent during store or headless-adjacent development.
When should I use shopify-content?
During Build integrations when you implement pageCreate, article updates, redirect JSON routes, or SEO blocks; also when validating content API shapes before launch migrations.
Is shopify-content safe to install?
It is documentation-only in your repo; review the Security Audits panel on this Prism page before trusting the package source, and treat Admin API tokens as secrets in your own project.
SKILL.md
READMESKILL.md - Shopify Content
# Shopify Content Types Reference ## API-Managed Content ### Pages | Operation | Method | Endpoint/Mutation | |-----------|--------|-------------------| | List | GraphQL | `{ pages(first: 50) { edges { node { id title } } } }` | | Create | GraphQL | `pageCreate(page: { ... })` | | Update | GraphQL | `pageUpdate(page: { id, ... })` | | Delete | GraphQL | `pageDelete(id: "...")` | Fields: `title`, `handle`, `body` (HTML), `isPublished`, `seo { title description }`, `templateSuffix` ### Blogs & Articles | Operation | Method | Endpoint/Mutation | |-----------|--------|-------------------| | List blogs | GraphQL | `{ blogs(first: 10) { edges { node { id title } } } }` | | List articles | GraphQL | `{ articles(first: 50) { edges { node { id title } } } }` | | Create article | GraphQL | `articleCreate(article: { blogId, ... })` | | Update article | GraphQL | `articleUpdate(article: { id, ... })` | | Delete article | GraphQL | `articleDelete(id: "...")` | Article fields: `blogId`, `title`, `handle`, `contentHtml`, `author { name }`, `tags`, `isPublished`, `publishDate`, `seo`, `image { src altText }` ### Redirects | Operation | Method | Endpoint | |-----------|--------|----------| | List | REST | `GET /admin/api/2025-01/redirects.json` | | Create | REST | `POST /admin/api/2025-01/redirects.json` | | Update | REST | `PUT /admin/api/2025-01/redirects/{id}.json` | | Delete | REST | `DELETE /admin/api/2025-01/redirects/{id}.json` | Fields: `path` (from), `target` (to) ### Metaobjects Custom structured content types (e.g. team members, FAQs, locations). | Operation | Method | |-----------|--------| | Define type | `metaobjectDefinitionCreate` | | Create entry | `metaobjectCreate` | | Update entry | `metaobjectUpdate` | | Query entries | `metaobjects(type: "custom_type")` | ## Browser-Only Operations These have limited or no API support — use browser automation: | Content | Admin URL | Notes | |---------|-----------|-------| | Navigation menus | `/admin/menus` | `menuUpdate` mutation exists but is limited | | Theme editor | `/admin/themes/current/editor` | Visual layout, no API | | Store policies | `/admin/settings/legal` | Privacy, terms, refund policies | | Checkout customisation | `/admin/settings/checkout` | Checkout flow and fields | | Notification templates | `/admin/settings/notifications` | Email/SMS templates | ## Content Best Practices ### Page Templates Shopify themes can define custom page templates. Use `templateSuffix` to select one: ```json { "templateSuffix": "contact" } ``` This uses `page.contact.liquid` (or `.json` for Online Store 2.0 themes). ### Metaobject vs Metafield | Use Case | Choose | |----------|--------| | Standalone content (FAQ page, team page) | Metaobject | | Extra data on a product/page | Metafield | | Repeatable structured entries | Metaobject | | Single value on a resource | Metafield | --- name: shopify-content description: "Create and manage Shopify pages, blog posts, navigation menus, redirects, and SEO metadata via the Admin API or browser automation. Use whenever the user wants to add a page to a Shopify store, write a Shopify blog post, update the storefront navigation, manage redirects, or tune SEO metadata on a Shopify site." compatibility: claude-code-only --- # Shopify Content Create and manage Shopify store content — pages, blog posts, navigation menus, and SEO metadata. Produces live content in the store via the Admin API or browser automation. ## Prerequisites - Admin API access token with `read_content`, `write_content` scopes (use **shopify-setup** skill) - For navigation: `read_online_store_navigation`, `write_online_store_navigation` scopes ## Workflow ### Step 1: Determine Content Type | Content Type | API Support | Method | |-------------|-------------|--------| | Pages | Full | GraphQL Admin API | | Blog posts | Full | GraphQL Admin API | | Navigation menus | Limited | Browser automation preferred | | Redirects | Full | REST Admin API | | SEO metadata |