shopify-developer

Shopify Developer Reference Comprehensive reference for professional Shopify development - API version 2026-01 . Quick Reference Item Value API version 2026-01 (stable) GraphQL Admin POST https://{store}.myshopify.com/admin/api/2026-01/graphql.json Storefront API POST https://{store}.myshopify.com/api/2026-01/graphql.json Ajax API (theme) /cart.js , /cart/add.js , /cart/change.js CLI install npm install -g @shopify/cli Theme dev shopify theme dev --store {store}.myshopify.com App dev shopify app dev Deploy shopify app deploy Docs shopify.dev Choose Your Path Read the reference file(s) that match your task: Liquid templating - writing or debugging .liquid files: references/liquid-syntax.md - Tags, control flow, iteration, whitespace, LiquidDoc references/liquid-filters.md - All filter categories with examples references/liquid-objects.md - Product, collection, cart, customer, and global objects Theme development - building or customising themes: references/theme-development.md - OS 2.0 architecture, sections, blocks, JSON templates, settings schema API integration - fetching or modifying data programmatically: references/api-admin.md - GraphQL Admin API (primary), REST (legacy), OAuth, webhooks, rate limiting references/api-storefront.md - Storefront API, Ajax API, cart operations App development - building Shopify apps: references/app-development.md - Shopify CLI, extensions, Polaris Web Components, App Bridge Serverless logic - custom business rules: references/functions.md - Shopify Functions (replacing Scripts), Rust/JS targets, deployment Headless commerce - custom storefronts: references/hydrogen.md - Hydrogen framework, React Router 7, Storefront API integration Optimisation and troubleshooting : references/performance.md - Images, JS, CSS, fonts, Liquid, Core Web Vitals references/debugging.md - Liquid errors, API errors, cart issues, webhook failures Deprecation Notices Deprecated Replacement Deadline Shopify Scripts Shopify Functions August 2025 (migration), sundown TBD checkout.liquid Checkout Extensibility August 2024 (Plus), done REST Admin API GraphQL Admin API Active deprecation (no removal date yet) Legacy custom apps New auth model January 2025 (done) Polaris React Polaris Web Components Active migration Remix (app framework) React Router 7 Hydrogen 2025.5.0+ Liquid Essentials Three syntax types: {{ product . title | upcase }} {# Output with filter #} {% if product . available %} In stock {% endif %} {# Logic tag #} {% assign sale = product . price | times : 0.8 %} {# Assignment #} {%- if condition -%} Stripped whitespace {%- endif -%} Key patterns: {% for product in collection . products limit : 5 %} {% render 'product-card' , product : product %} {% endfor %} {% paginate collection . products by 12 %} {% for product in paginate . collection . products %} ... {% endfor %} {{ paginate | default_pagination }} {% endpaginate %} API Essentials // GraphQL Admin - always use GraphQL over REST const response = await fetch ( https:// ${ store } .myshopify.com/admin/api/2026-01/graphql.json , { method : 'POST' , headers : { 'X-Shopify-Access-Token' : accessToken , 'Content-Type' : 'application/json' , } , body : JSON . stringify ( { query , variables } ) , } ) const { data , errors } = await response . json ( ) if ( errors ) throw new Error ( errors [ 0 ] . message ) // Ajax API (theme-only cart operations) fetch ( '/cart/add.js' , { method : 'POST' , headers : { 'Content-Type' : 'application/json' } , body : JSON . stringify ( { id : variantId , quantity : 1 } ) , } ) Reference Files File Lines Coverage liquid-syntax.md ~600 Tags, control flow, iteration, variables, whitespace, LiquidDoc liquid-filters.md ~870 String, numeric, array, Shopify-specific, date, URL, colour filters liquid-objects.md ~695 All Shopify objects: product, variant, collection, cart, customer, order, etc. theme-development.md ~1200 File structure, JSON templates, sections, blocks, settings schema, layout api-admin.md ~595 GraphQL queries/mutations, REST (legacy), OAuth, webhooks, rate limiting api-storefront.md ~235 Storefront API, Ajax API, cart operations, Customer Account API app-development.md ~760 CLI, app architecture, extensions, Polaris Web Components, deployment functions.md ~300 Function types, Rust/JS targets, CLI workflow, Scripts migration hydrogen.md ~375 Setup, routing, data loading, Storefront API, deployment performance.md ~605 Images, JS, CSS, fonts, Liquid, third-party scripts, Core Web Vitals debugging.md ~650 Liquid, JavaScript, API, cart, webhook, theme editor troubleshooting