Website template: "Encountered a script tag" error on 404 pages in development
Maintainers usually reply within 1 day
@peteruithoven is already working on this.
Since Nov 13, 2026.
Assessment
- Difficulty
- 3/5
- Estimated time
- Half a day
- Newbie friendliness
- 25/100
- Issue type
- Bug
- Clarity
- Clearly specified
- Activity status
- Stale
- Tech stack
- nextjs, react, typescript
- Domain
- frontend
Research direction
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.
Written by the indexing model from the issue text.
Description
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).
- Clone the repo and run
pnpm install cp .env.example .env, then setDATABASE_URL=file:./payload-website-404-issue.dbandPAYLOAD_SECRETto any stringpnpm dev- Open http://localhost:3000/this-page-does-not-exist
- Open the browser console: the "Encountered a script tag while rendering React component" error is logged.
- 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
- Dominant language
- TypeScript
- Stars
- 45.8k
- Forks
- 4.4k
- Avg merge
- 2d 16h
- Merged PRs (30d)
- 251
Getting set up
Starts the project's dev container in your browser, under your own GitHub account.
- No Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from payloadcms/payload
-
db-d1-sqlite: upsert is aliased to updateOne, so payload.kv.set never inserts new keysPossibly taken @pcbeingused333 claimed this today. OpenBug db: d1-sqlite Payload OSS
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
payloadcms/payload#19766 ·
Maintainers usually reply within 1 day
-
Document bar (.doc-controls__content) overflows a 375 px viewport, clips "Created" and fails axe scrollable-region-focusablePossibly taken A pull request linked to this issue is open or already merged. Openarea: ui Bug
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
payloadcms/payload#19690 ·
Maintainers usually reply within 1 day
-
[v4] Blocks thumbnails croped 3:2Possibly taken @samiarif02 claimed this 2 days ago. Openarea: ui Bug Payload OSS status: needs-triage v3
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
payloadcms/payload#19609 ·
Maintainers usually reply within 1 day
-
Scheduled publish jobs are not deleted when their document is deleted (string id in the job, raw id in the cleanup)Possibly taken @volodymyrshk claimed this 10 days ago. Openarea: core Bug db: sqlite
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
payloadcms/payload#19448 ·
Maintainers usually reply within 1 day
-
plugin-multi-tenant: `isGlobal` collections redirect tenant-scoped users to `/admin` since 3.93.0 (GlobalViewRedirect prop-name mismatch)Possibly taken @JarrodMFlesch claimed this 10 days ago. OpenBug plugin: multi-tenant
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
payloadcms/payload#19420 · 1 assignee ·
Maintainers usually reply within 1 day
All issues in payloadcms/payload
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
milind-soni/OpenMausBot#6730 ·
Maintainers usually reply within 1 day
-
`@angular/[email protected]` depends on vulnerable Vite 7.3.7 - GHSA-p4f5-76q4-ffq7 (Critical RCE)Openarea: @angular/build
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
angular/angular-cli#34764 ·
Maintainers usually reply within 1 day
-
status/need-triage
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
google-gemini/gemini-cli#30384 · 1 comment ·
Maintainers usually reply within 1 day
-
P2
Difficulty 1/5 Under an hour Newbie friendliness 84/100
Maintainers usually reply within 1 day
-
area:image documentation good first issue
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
Maintainers usually reply within 1 day