🚀 Feature Request: Support for Streaming Head Metadata from Deferred Data #4761

GhostvOne · 2025-07-24T09:07:58Z

GhostvOne
Jul 24, 2025

🚀 Feature Request: Support for Streaming Head Metadata from Deferred Data

Hello TanStack team 👋

Feature Request

I’d like to propose a feature that allows support for streaming metadata (head elements) from deferred data, similar to Next.js 15.2's streaming metadata.

Here the discussion with @schiller-manuel on Discord : https://discord.com/channels/719702312431386674/1376595249052520651

Use Case

I’m working on a route like /posts/$postId, where I load a post with all the relevant data including:

Title
Canonical URL
Localization info (for language switchers, etc.)

Currently, I can use loaderData to populate the <head> metadata — and that works great for synchronously loaded data. However, I would love to go further and use deferred (streamed) data in the head as well.

Why it matters

Improves Time to First Byte (TTFB) by streaming the shell early
Allows for dynamic SEO metadata to be injected as soon as the deferred data is resolved
Aligns TanStack Router with modern patterns seen in frameworks like Next.js App Router

Possible API / Behavior Suggestion

Maybe something like:

{
  head: ({ deferredData }) => ({
    title: deferredData?.post?.title ?? 'Loading...',
    link: [{ rel: 'canonical', href: deferredData?.post?.canonicalUrl }],
  });
}

schiller-manuel · 2025-07-24T16:02:19Z

schiller-manuel
Jul 24, 2025
Maintainer

how would that look like in the browser then? would this after hydration insert elements in head?

0 replies

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

🚀 Feature Request: Support for Streaming Head Metadata from Deferred Data #4761

Uh oh!

{{title}}

Uh oh!

Replies: 1 comment

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

Uh oh!

🚀 Feature Request: Support for Streaming Head Metadata from Deferred Data #4761

Uh oh!

GhostvOne Jul 24, 2025