Skip to content
Tutorials Center
My learning

Topics

Shopify App Development Tutorial

Learn Shopify App Development step by step: 55 lessons in 12 chapters with examples, quizzes, diagrams and projects.

Start learning →

of lessons completed

Orientation

  1. 1 What Is a Shopify App? Learn what a Shopify app is, the difference between public and custom apps, where apps show up (admin, storefront, checkout, POS) and how development stores work.
  2. 2 App Architecture at a Glance See how a Shopify app fits together: the embedded admin app, your backend, extensions, webhooks and Shopify as the source of truth, with a request-flow diagram.
  3. 3 Tooling and Setup Set up your machine for Shopify app development: Node.js, Git, the Shopify CLI, a developer account, a development store and shopify auth login, step by step.
  4. 4 Creating an App with the CLI Create your first Shopify app with shopify app init, tour the React Router template folder by folder and learn what shopify app dev and its tunnel do for you.
  5. 5 App Configuration with shopify.app.toml Understand shopify.app.toml: app URLs, redirect URLs, access scopes, webhook subscriptions and how shopify app deploy turns configuration into app versions.

Authentication and Sessions

  1. 6 The OAuth Authorization Code Flow Learn the OAuth authorization code flow Shopify apps use to get access tokens: install URL, consent, state, HMAC validation and code exchange, with a simulator.
  2. 7 Managed Installation and Access Scopes Learn how a Shopify app declares access scopes in shopify.app.toml, how managed installation asks merchants for consent, and how to keep scopes minimal and safe to change.
  3. 8 Session Tokens for Embedded Apps Understand Shopify session tokens: why cookies fail inside the admin iframe, the JWT claims iss, dest, aud and exp, and how to verify the signature on your server.
  4. 9 Token Exchange and Access Tokens Learn how Shopify token exchange swaps a session token for an online or offline access token, how expiring tokens work, and how to store and reuse tokens safely.
  5. 10 Online vs Offline Tokens Understand Shopify online and offline access tokens: who they belong to, how long they live, when to use each, and how to store, rotate and choose between them in code.
  6. 11 Authenticated Requests and Route Protection See how a Shopify app protects every route: authenticate.admin in the React Router template, session storage with Prisma, iframe redirects and public routes, with a pipeline you can run.

Admin GraphQL API

  1. 12 GraphQL for Shopify Developers Learn the GraphQL you need for Shopify apps: queries, mutations, variables, fragments, aliases, introspection and gid:// global IDs, with a runnable query builder.
  2. 13 API Versioning and Deprecations Learn how Shopify's quarterly Admin API versions work: the support window, release candidates, the version in the URL, deprecations and an upgrade checklist.
  3. 14 Querying Products and Variants Learn to read products, variants, options and media with the Shopify Admin GraphQL API, use the search query syntax, and build safe queries with runnable stand-ins.
  4. 15 Pagination with Cursors Page through Shopify Admin GraphQL connections with first, after, pageInfo and cursors, choose sort keys, go in reverse, and test a paginator on mock data.
  5. 16 Mutations and userErrors Write data with Shopify Admin GraphQL mutations, read userErrors versus top-level errors, handle partial failure, and build a safe error-handling wrapper.
  6. 17 Metafields and Metaobjects from the API Store custom data on Shopify with metafields and metaobjects: definitions, namespaces, types, metafieldsSet, app-owned namespaces and a runnable type validator.
  7. 18 Orders, Customers and Protected Data Query Shopify orders, line items, fulfillment orders and customers with the Admin GraphQL API, and understand protected customer data, scopes and money fields.
  8. 19 Rate Limits and Query Cost Understand the Shopify Admin GraphQL cost model: calculated query cost, the leaky bucket, restore rate, THROTTLED errors and backoff, with runnable simulators.
  9. 20 Bulk Operations Export or update thousands of Shopify objects with bulk operations: bulkOperationRunQuery, JSONL results, polling or webhooks, staged uploads and a runnable JSONL parser.

Storefront API and Headless

  1. 21 Storefront API Basics Learn what the Shopify Storefront API is for, how public and private tokens differ, how it differs from the Admin API, and how to query products, collections and carts.
  2. 22 Building a Cart with the Storefront API Build a cart with the Shopify Storefront API: cartCreate, cartLinesAdd, buyer identity, attributes, discount codes and the checkoutUrl, with a runnable in-memory stand-in.
  3. 23 Headless Commerce and Hydrogen Understand headless commerce on Shopify: when it pays off, what Hydrogen and Oxygen provide, the real trade-offs, and a runnable storefront fetch layer with mock data.

Webhooks

  1. 24 Webhooks in Shopify Learn how Shopify webhooks work: topics, TOML and API subscriptions, HTTPS, EventBridge and Pub/Sub delivery, request headers, and a runnable webhook dispatcher stand-in.
  2. 25 Verifying Webhook Signatures Verify the X-Shopify-Hmac-Sha256 header correctly: use the raw body, compute a base64 HMAC-SHA256, compare in constant time and reject forgeries. Includes a runnable verifier.
  3. 26 Reliable Webhook Handlers Build Shopify webhook handlers that survive retries, duplicates and out-of-order events: answer fast, queue the work, de-duplicate by webhook id and reconcile with scheduled jobs.

App Extensions

  1. 27 App Extensions Overview Learn what Shopify app extensions are, how to generate one, how shopify.extension.toml declares targets, and how app versions and deploys ship extensions to merchants.
  2. 28 Theme App Extensions Add your app to a merchant's storefront with theme app extensions: app blocks, app embeds, the Liquid schema, assets and how merchants place them in the theme editor.
  3. 29 Admin UI Extensions Extend the Shopify admin with admin action, block, print and link extensions: targets, Polaris web components and calling the GraphQL Admin API from an extension.
  4. 30 Checkout UI Extensions Add upsells, gift messages and custom fields to Shopify checkout: targets, Polaris checkout components, cart line data, sandbox limits and applying cart changes.
  5. 31 Polaris and App Home Design Design your Shopify app's home inside the admin: Polaris web components, App Bridge navigation, the contextual save bar, toasts, and the layout rules merchants expect.
  6. 32 Customer Account and POS Extensions Extend Shopify beyond the storefront: customer account pages, the order status page and point of sale. Learn targets, use cases, constraints and when to pick each.
  7. 33 App Proxy and Storefront Pages Serve pages and data from your own server under a store's domain with an app proxy: URL mapping, the signature check, Liquid responses and when to choose it.

Shopify Functions

  1. 34 Shopify Functions Overview Learn what Shopify Functions are, which function APIs exist (discounts, delivery, payment, validation, cart transform), the input and output model and the Wasm sandbox.
  2. 35 Building a Function from Scratch Build a Shopify discount function step by step: generate the extension, write the input query, read merchant settings from a metafield, then run and replay it locally.
  3. 36 Discount Functions in Depth Understand Shopify discount functions in depth: product, order and shipping classes, targets, percentage vs fixed values, selection strategies and how discounts combine.
  4. 37 Cart Validation, Delivery and Payment Customization Use Shopify Functions to block invalid carts with validation errors and to hide, move or rename delivery and payment options at checkout, with runnable stand-ins.
  5. 38 Testing and Debugging Functions Test Shopify Functions with fixture inputs, the function run and replay commands, unit tests for pure logic, and a close watch on instruction and size limits.

Billing

  1. 39 App Pricing Models and Billing Options Compare free, recurring, usage-based and one-time pricing for Shopify apps, learn how trials and managed pricing work, and try a runnable pricing simulator.
  2. 40 Implementing Billing with the Billing API Create app subscriptions, send merchants to the confirmation URL, record capped usage charges, upgrade and cancel plans, with a runnable subscription state machine.

Compliance, Security, Review

  1. 41 Privacy, GDPR and Mandatory Webhooks Handle Shopify's mandatory privacy webhooks: customer data request, customer redact and shop redact. Includes uninstall cleanup and a runnable redaction handler.
  2. 42 App Security Checklist A practical security checklist for Shopify apps: secrets, least-privilege scopes, XSS and CSRF in embedded apps, CSP frame-ancestors and validating every inbound request.
  3. 43 App Store Requirements and Review Prepare a Shopify app for review: listing content, technical requirements, Built for Shopify, performance, common rejection reasons and a runnable pre-submission scorer.

Testing, Deployment and Operations

  1. 44 Testing Shopify Apps Test a Shopify app with confidence: unit tests with a mocked admin client, signed webhook tests, factories, development stores and test charges, with runnable stand-ins.
  2. 45 Databases and Session Storage in Production Move a Shopify app from SQLite to Postgres or MySQL: Prisma schema, session storage, multi-tenant data keyed by shop, migrations and safe uninstall cleanup.
  3. 46 Deploying Your App Deploy a Shopify app the right way: host the server, set environment variables, point the TOML URLs at production, and release app versions with shopify app deploy.
  4. 47 Monitoring, Logging and Scaling Run a Shopify app in production: structured logs, error tracking, queue workers with backpressure, rate-limit-aware scheduling and install and uninstall analytics.

Real-World Projects

  1. 48 Project: Bulk Product Tagger Build an embedded Shopify app that tags thousands of products by rules: bulk query, a rule engine, bulk mutations, progress and retries, with runnable stand-ins.
  2. 49 Project: Low-Stock Alerts App Build a Shopify low-stock alerts app: inventory webhooks, thresholds stored in metafields, a notification queue with digests, and a runnable alert engine.
  3. 50 Project: Tiered Volume Discount Build a tiered volume discount for Shopify: function configuration in a metafield, input query, tier math in integer cents, an admin UI and runnable tests.
  4. 51 Project: Checkout Upsell Extension Build a Shopify checkout upsell extension: merchant settings, a recommendation engine, adding a cart line safely, and a runnable cart and ranking stand-in.
  5. 52 Project: A Paid App with Plans and Usage Billing Add plans and usage charges to a Shopify app: plan gating, a billing check on load, capped usage records with idempotency, uninstall cleanup and runnable simulators.

Practice and Review

  1. 53 Practice Exercises with Solutions Ten Shopify app exercises with runnable solutions: GraphQL queries, HMAC checks, cursor pagination, rate limits, function logic, scope diffs and billing states.
  2. 54 Shopify App Developer Interview Questions Prepare for a Shopify app developer interview: architecture, auth, API limits, webhooks, extensions, functions, billing and security, with concise answers and demos.
  3. 55 Shopify App Development Cheat Sheet A quick Shopify app reference: CLI commands, shopify.app.toml keys, auth flow, GraphQL patterns, webhook checklist, extension targets and a pre-submission review checklist.