Skip to content

docs: clarify that preloads are sent as a Link header on dynamically rendered pages#16309

Merged
teemingc merged 4 commits into
sveltejs:version-3from
Nic-Polumeyv:docs-preload-link-header
Jul 13, 2026
Merged

docs: clarify that preloads are sent as a Link header on dynamically rendered pages#16309
teemingc merged 4 commits into
sveltejs:version-3from
Nic-Polumeyv:docs-preload-link-header

Conversation

@Nic-Polumeyv

@Nic-Polumeyv Nic-Polumeyv commented Jul 10, 2026

Copy link
Copy Markdown
Contributor

closes #16139

The preload docs say the selected files "should be added to the <head> tag". Since #14200 that only happens for prerendered pages. Dynamically rendered pages send a Link response header instead, with no tag in the HTML.

The old wording produced #16139. The reporter enabled font preloading, searched the served HTML for a <link rel="preload" as="font"> tag, and reasonably concluded the feature was broken. Running their reproduction, the font was preloaded the whole time:

link: <./_app/immutable/assets/SUIT-Variable.gqD86R3M.woff2>; rel="preload"; as="font"; type="font/woff2"; crossorigin; nopush

This updates the hooks docs and the ResolveOptions JSDoc to name both delivery paths.

Please don't delete this checklist! Before submitting the PR, please make sure you do the following:

  • It's really useful if your PR references an issue where it is discussed ahead of time. In many cases, features are absent for a reason. For large changes, please create an RFC: https://github.com/sveltejs/rfcs
  • This message body should clearly illustrate what problems it solves.
  • Ideally, include a test that fails without this PR but passes with it.

Tests

  • Run the tests with pnpm test and lint the project with pnpm lint and pnpm check

Changesets

  • If your PR makes a change that should be noted in one or more packages' changelogs, generate a changeset by running pnpm changeset and following the prompts. Changesets that add features should be minor and those that fix bugs should be patch. Please prefix changeset messages with feat:, fix:, or chore:.

Edits

  • Please ensure that 'Allow edits from maintainers' is checked. PRs without this option may be closed.

@pkg-svelte-dev

pkg-svelte-dev Bot commented Jul 10, 2026 •
edited
Loading

Copy link
Copy Markdown

Install the latest version of @sveltejs/kit from b54c716:

pnpm add https://pkg.svelte.dev/@sveltejs/kit/c/b54c7165e7692b619376cb6069776cfb44d83043

Open in pkg.svelte.dev: https://pkg.svelte.dev/repos/kit/pr/16309

Note

This PR is from a fork. A maintainer must approve approve each commit before it can be built and installed.

@changeset-bot

changeset-bot Bot commented Jul 10, 2026 •
edited
Loading

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: b54c716

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@Nic-Polumeyv Nic-Polumeyv mentioned this pull request Jul 10, 2026
Closed
@teemingc teemingc added the documentation Improvements or additions to documentation label Jul 10, 2026
@svelte-docs-bot

svelte-docs-bot Bot commented Jul 10, 2026

Copy link
Copy Markdown

Preview: https://svelte-dev-git-preview-kit-16309-svelte.vercel.app/

teemingc
teemingc reviewed Jul 10, 2026
View reviewed changes
Comment thread documentation/docs/30-advanced/20-hooks.md Outdated
@teemingc

teemingc commented Jul 10, 2026

Copy link
Copy Markdown
Member

Thanks! Can you rebase this on the version-3 branch?

@Nic-Polumeyv
Nic-Polumeyv force-pushed the docs-preload-link-header branch from 573ffdf to 7d59e63 Compare July 10, 2026 18:59
@Nic-Polumeyv
Nic-Polumeyv changed the base branch from main to version-3 July 10, 2026 18:59
vercel[bot]
vercel Bot reviewed Jul 10, 2026
View reviewed changes
Comment thread documentation/docs/30-advanced/20-hooks.md Outdated
@Nic-Polumeyv
Nic-Polumeyv force-pushed the docs-preload-link-header branch from c7528c9 to 0d3a6c4 Compare July 11, 2026 22:19
@Nic-Polumeyv
Nic-Polumeyv requested a review from teemingc July 13, 2026 20:11
@teemingc
teemingc merged commit ca8d60f into sveltejs:version-3 Jul 13, 2026
18 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@vercel vercel[bot] vercel[bot] left review comments
@teemingc teemingc teemingc approved these changes

Assignees

No one assigned

Labels

documentation Improvements or additions to documentation

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Font preloading does not work

2 participants

@Nic-Polumeyv @teemingc