Website template: "Encountered a script tag" error on 404 pages in development

Aperta
#19,577 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

@peteruithoven ci sta già lavorando.

Dal 13/11/2026.

  • #19580 di @peteruithoven — aperta
  • #19581 di @peteruithoven — aperta

Valutazione

Difficoltà
3/5
Tempo stimato
Mezza giornata
Idoneità per principianti
25/100
Tipo di issue
Bug
Chiarezza
Specificata chiaramente
Stato di attività
Ferma
Stack tecnologico
nextjs, react, typescript
Ambito
frontend

Direzione di ricerca

The error comes from src/providers/Theme/InitTheme/index.tsx, which renders the theme script via next/script in the root layout; the ThemeProvider sets data-theme in an effect. Reproduce by visiting a non-existent route in the website template in dev and checking the browser console. Done means no 'Encountered a script tag' error on not-found pages while the theme still applies. Open PR #19580 already targets this, so check it before starting.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

area: templates Bug Payload OSS
Describe the Bug

In the website template, visiting any page that doesn't exist (which calls notFound()) logs this error in the browser console during development:

Encountered a script tag while rendering React component. Scripts inside React components are never executed when rendering on the client. Consider using template tag instead (https://developer.mozilla.org/en-US/docs/Web/HTML/Element/template).

Regular pages don't have this error.

The error comes from src/providers/Theme/InitTheme/index.tsx, which renders the theme script with next/script and strategy="beforeInteractive" in the root layout. On a notFound() page, Next.js renders the root layout on the client instead of hydrating server-rendered HTML. React then encounters the <script> during a client render, where it never executes, and logs the error.

The theme is still applied on those pages, because ThemeProvider also sets data-theme in an effect, so the script isn't needed in that case.

A possible fix is to render a plain <script> only when the component is server-rendered or hydrated, and render nothing during a fresh client render. For example, use useSyncExternalStore with a server snapshot of true and a client snapshot of false. I'm using this in my project and I'm happy to open a PR if that approach is acceptable.

ecommerce and with-vercel-website use the same InitTheme component.

Link to the code that reproduces this issue

https://github.com/peteruithoven/payload-website-404-issue

Reproduction Steps

The linked repo is an unmodified website template, created with pnpx create-payload-app@latest -t website (SQLite, Payload 3.93.0).

  1. Clone the repo and run pnpm install
  2. cp .env.example .env, then set DATABASE_URL=file:./payload-website-404-issue.db and PAYLOAD_SECRET to any string
  3. pnpm dev
  4. Open http://localhost:3000/this-page-does-not-exist
  5. Open the browser console: the "Encountered a script tag while rendering React component" error is logged.
  6. Open http://localhost:3000/ for comparison: no error.

No seeding is needed; it reproduces with an empty database.

Which area(s) are affected?

area: templates

Environment Info
Payload: 3.93.0
Next.js: 16.4.1
React: 19.2.9
Node.js: 24.22.3
Lingua principale
TypeScript
Stelle
45.8k
Fork
4.4k
Merge medio
2g 16h
PR unite (30g)
251

Preparare l'ambiente

Apri in Codespaces

Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di payloadcms/payload

Tutte le issue di payloadcms/payload

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.