Skip to content
Home / Migrations / tRPC v10tRPC v11

tRPC v10 tRPC v11

medium

v11 adds TanStack Query v5 support, FormData inputs, and improved subscriptions. TypeScript 5.7.2+ required.

Estimated: 3-6h · 5 steps
Progress0%
Step 1: Bump TypeScript

Update to TS 5.7.2 or later. Most projects already have this.

Step 2: Update packages
npm install @trpc/server@11 @trpc/client@11 @trpc/react-query@11 @tanstack/react-query@5
Step 3: Migrate React Query integration

createTRPCReact() API mostly unchanged but follows v5 patterns. useQuery returns isPending. Subscriptions API changed.

Step 4: Adopt FormData inputs

v11 supports non-JSON content via httpFormDataLink and httpBatchStreamLink. Useful for file uploads.

Step 5: Test SSE subscriptions

If using subscriptions, switch to httpSubscriptionLink (SSE) instead of WebSocket where possible.

All procedures call correctly. Types still inferred end-to-end.

What this migration involves

Moving from tRPC v10 to tRPC v11 is rated medium and takes about 3-6h on a typical project. The guide breaks it into 5 steps, 1 of which ship with runnable commands and 1 with a verification check.

FAQ

How long does migrating from tRPC v10 to tRPC v11 take?

Around 3-6h for a typical project — 5 steps, difficulty rated medium, 1 of them with copy-paste commands.

Is moving from tRPC v10 to tRPC v11 reversible?

No reverse guide is tracked yet, so treat this as a one-way move and keep a full export of your tRPC v10 data before you start.

What does tRPC v11 cost compared to tRPC v10?

Pricing for both tools is contact-based or not tracked yet.