Shopify storefront engineering · field note

Shopify webhook topics are never subscribed — orders/create etc. never reach our fully-built handler

A working diagnosis of this problem and the sequence that actually resolves it, written from the operational side rather than the marketing side.

Reported context: ## What's missing `apps/api/src/routes/shopifyWebhooks.ts` has complete, tested handling for `orders/create`, `orders/updated`, `orders/cancelled`, `refunds/create`, `fulfillments/create`, `fulfillments/update`, `app/uninstalled`, and the mandatory compliance topics (SPEC §8.1). But **nothing ever tells Shopify to send these webhooks to us**: - `apps/shopify-app/shopify.app.toml`'s `[webhooks]` block only sets `api_v

What is actually going on

Cart recovery leaks happen when the recovery email fires before the buyer's session expires, or when the discount code in the email has already expired by the time it is opened.

Theme performance regressions typically come from render-blocking third-party apps injected in the head, each adding 200-600ms of blocking time.

The sequence that works

  1. Reproduce the failure in a clean browser with a real destination address and a real payment method in test mode. Log the exact gateway response code.
  2. Disable all discount scripts, then re-enable one at a time to isolate the conflict.
  3. Rebuild cart recovery timing: first touch at 1 hour, second at 24 hours, third at 72 hours with a freshly minted code, each with a distinct message angle.
  4. Audit every app for where it injects assets. Move non-critical scripts to deferred loading and remove apps that duplicate native functionality.
  5. Measure again with field data, not lab data — lab scores on fast hardware hide the real mobile experience.

Where people lose time

Verify before you trust it

Run the checks above against your own data instead of adopting them at face value. The failure modes are specific enough that a single afternoon of measurement will either confirm this diagnosis or rule it out — both outcomes are useful, and guessing is not.

Automation Workflow Pack
A ready-to-use package for exactly this workflow — $27.55, delivered immediately.
Get Automation Workflow Pack · $27.55
Sold via Gumroad, which acts as merchant of record and handles payment and applicable taxes. All sales are final; see the return policy before purchase.