Skip to content

ericrisco/rsc-harness / skills/shopify

shopify

Verified

Use when building or customizing a Shopify store across its three code surfaces — themes (Liquid, Online Store 2.0 sections, blocks and JSON templates), apps (Remix with the versioned GraphQL Admin API and its query-cost model), and checkout (UI extensions, Functions, Web Pixels), plus the CLI flow and checkout-extensibility migration. NOT WooCommerce or PHP stores (that is `wordpress`), NOT the React layer of a headless storefront (that is `nextjs`), NOT non-Shopify payment integrations (that is `stripe`).

FileKindSize
SKILL.mdskill md12.4 KB
evals/README.mdmarkdown1.0 KB
evals/cases.yamlconfig2.8 KB
references/apps-graphql.mdmarkdown3.5 KB
references/checkout-extensibility.mdmarkdown3.8 KB
references/liquid-themes.mdmarkdown3.8 KB
scripts/verify.shexecutablescript5.0 KB

references/checkout-extensibility.md

View on GitHub
# Checkout extensibility — migration off `checkout.liquid`

Companion to the Checkout surface section of `../SKILL.md`. The old model (`checkout.liquid`,
additional scripts, script tags, Script Editor) is deprecated and being removed.

## The dated deadlines

- **2024-08-13** — Information / Shipping / Payment steps stopped supporting `checkout.liquid`.
- **2025-08-28** — Plus self-migrate deadline for Thank-you and Order-status page customizations
  (additional scripts, script tags, `checkout.liquid`). This is the date to *act by*, not the
  auto-upgrade date.
- **2026-01** — **automatic upgrades** of Thank-you and Order-status pages begin. Shopify gives a
  30-day email notice, then upgrades the store; any remaining additional-scripts, script-tag, or
  `checkout.liquid` customizations stop running. (Non-Plus stores have a later self-migrate deadline
  of 2026-08-26.)
- **2026-04-15** — legacy Shopify Scripts can no longer be **edited or published** (existing
  published scripts keep running until the shutdown below — so a bug after this date has no in-Script fix).
- **2026-06-30** — legacy Shopify Scripts (Script Editor) **stop executing**. Replace with Functions.

If a store says "checkout customizations broke after the August upgrade," they usually mean the
2025-08-28 deadline passed and they were caught by the automatic upgrade (rolling out from 2026-01) —
the old script no longer runs. Rebuild it on the seam below.

## Migration map

| Old mechanism | New seam | What you build |
|---|---|---|
| `checkout.liquid` markup / additional scripts (UI) | **Checkout UI extensions** | a sandboxed extension targeting a checkout location |
| Script Editor discount logic | **Discount Function** | Wasm function returning discount operations |
| Script Editor shipping/delivery logic | **Delivery customization Function** | reorder/rename/hide shipping options |
| Script Editor payment logic | **Payment customization Function** | reorder/rename/hide payment methods |
| `<script>` analytics/tracking in checkout | **Web Pixels** (+ server-side events) | sandboxed pixel; subscribe to standard events |
| custom checkout CSS / branding | **Checkout Branding API** | GraphQL mutations on the checkout profile |

## Checkout UI extensions

React/JS extensions that render at defined **targets** (e.g. `purchase.checkout.block.render`,
`purchase.checkout.delivery-address.render-before`). You get a typed API and components — **no DOM
access**, by design (PCI + stability). Configure target + capabilities in the extension's TOML.

```jsx
import { reactExtension, Banner } from "@shopify/ui-extensions-react/checkout";
export default reactExtension("purchase.checkout.block.render", () => <Banner>Free gift over 50</Banner>);
```

## Functions

Deterministic server-side logic compiled to Wasm — author in Rust or JavaScript. A Function takes a
typed input (a GraphQL query you define against the function's input schema) and returns operations.
Categories: product discount, order discount, shipping discount, delivery customization, payment
customization, cart/checkout validation. Generate with `shopify app generate extension`, build, and
ship with `shopify app deploy`.

```rust
#[shopify_function]
fn run(input: input::ResponseData) -> Result<output::FunctionRunResult> {
    // return discount operations from typed input
}
```

## Web Pixels

For tracking/analytics that previously lived in checkout `<script>` tags. A pixel runs in a sandbox
and subscribes to standard customer events (`checkout_completed`, `product_viewed`, …). It cannot
reach the page DOM; send events to your endpoint or a destination.

## Plus-only surfaces

Full checkout UI customization and some Function/branding capabilities are **Shopify Plus-only**.
Non-Plus stores get a constrained set of UI extension targets. Confirm the merchant's plan before
promising a checkout customization.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall