Engineering hub

Shopify engineering guides for app and storefront teams

Start with the boundary that owns the failure: event reliability, installation and request authentication, Admin API or bulk work, embedded app structure, app proxies, or a specific extension surface.

What this hub covers

The pipeline guide owns end-to-end reliability while webhook idempotency owns duplicate delivery. OAuth owns installation and API credentials; session-token guides own frontend-to-backend request authentication. Surface guides then apply those primitives without collapsing them into one architecture.

Updated August 1, 2026

Curated topic archive

14 pages grouped around platform engineering

Search the library
Shopify webhook idempotency in Rails cover image
Developer guide
Guides
14 min readUpdated March 12, 2026

Shopify webhook idempotency in Rails

A Rails guide to Shopify webhook idempotency using event IDs, durable deduplication, and processing patterns that survive retries, duplicates, and delayed deliveries.

guidesShopify developerwebhooks
Shopify OAuth and managed install in Rails apps cover image
Developer guide
Guides
15 min readUpdated March 12, 2026

Shopify OAuth and managed install in Rails apps

A guide to the current Shopify installation model for Rails apps, explaining where managed install replaces older OAuth assumptions and where authorization code grant still matters.

guidesShopify developerOAuth
Shopify session tokens in Rails cover image
Developer guide
Guides
15 min readUpdated March 12, 2026

Shopify session tokens in Rails

A Rails-focused guide to Shopify session tokens for embedded apps, covering the Shopify App gem, token exchange, frontend request flow, and the mistakes that still break production auth.

guidesShopify developersession tokens
Shopify Admin GraphQL patterns in Rails cover image
Developer guide
Guides
18 min readUpdated March 12, 2026

Shopify Admin GraphQL patterns in Rails

Production patterns for using the Shopify Admin GraphQL API from Rails, including service boundaries, pagination strategy, throttling, partial failure handling, and when to switch to bulk operations.

guidesShopify developerAdmin GraphQL API
Shopify Bulk Operations in Rails cover image
Developer guide
Guides
16 min readUpdated August 1, 2026

Shopify Bulk Operations in Rails

A Rails implementation guide for Shopify Bulk Operations covering job orchestration, JSONL downloads, polling versus webhooks, and the service boundaries that make large syncs maintainable.

guidesShopify developerbulk operations
React frontend plus Rails backend for Shopify embedded apps cover image
Developer guide
Guides
16 min readUpdated August 1, 2026

React frontend plus Rails backend for Shopify embedded apps

How to structure a Shopify embedded app with React on the frontend and Rails on the backend, including auth boundaries, deployment shape, and the operational tradeoffs that matter in production.

guidesShopify developerRails
When app proxies do not work for Shopify UI extensions cover image
Developer guide
Guides
12 min readUpdated March 12, 2026

When app proxies do not work for Shopify UI extensions

An explanation of why Shopify app proxies are the wrong integration path for many UI extension scenarios, especially in checkout and customer account surfaces where session tokens and extension APIs are the real auth model.

guidesShopify developerapp proxy
Checkout UI Extensions with a custom backend architecture cover image
Developer guide
Guides
15 min readUpdated August 1, 2026

Checkout UI Extensions with a custom backend architecture

A practical backend architecture guide for Shopify Checkout UI Extensions, covering when to call your own backend, how to keep the extension thin, and where teams overbuild the server side.

guidesShopify developerCheckout UI Extensions
Shopify Customer Account UI Extensions with a Rails backend cover image
Developer guide
Guides
15 min readUpdated August 1, 2026

Shopify Customer Account UI Extensions with a Rails backend

A backend architecture guide for Shopify Customer Account UI Extensions using Rails for app logic, persistence, and API orchestration without turning the extension into a fragile mini-app.

guidesShopify developerCustomer Account UI Extensions
Theme App Extensions with a Rails-backed Shopify app cover image
Developer guide
Guides
16 min readUpdated March 12, 2026

Theme App Extensions with a Rails-backed Shopify app

How to structure Theme App Extensions when your Shopify app backend is Rails, including configuration ownership, data flow, and the boundary between theme-safe data and app-owned backend logic.

guidesShopify developertheme app extensions