Description
This issue was previously reported and marked as fixed in Gutenberg 16.4 (#53264)
and again in 16.6.0 (#55431), but the problem is still reproducible in current
versions of WordPress and Gutenberg.
When a block theme includes front-page.html and the site is configured to display
a static homepage under Settings → Reading, the Site Editor landing view
(/wp-admin/site-editor.php) renders only the page title with no content —
effectively a blank canvas. The front-page.html template is not loaded on
the initial view, even though it takes precedence over all other templates per
WordPress template hierarchy.
This is a Site Editor-only issue. The frontend renders correctly.
Why this is not a duplicate of #53264 or #55431
Both previous issues were closed as resolved, but the regression persists:
| Issue |
Reported fix |
Status |
| #53264 |
Fixed in GB 16.4 via #53169 |
Regression — still reproducible |
| #55431 |
Fixed in GB 16.6.0 |
Regression — still reproducible |
The root cause appears not to have been fully addressed: the Site Editor
determines its landing template based on the assigned static page rather than
respecting front-page.html template hierarchy.
Expected behavior
The Site Editor should load and preview front-page.html, since that template
takes precedence over all others on the homepage per WordPress template hierarchy.
Navigating to Editor → Templates → Front Page does correctly display
front-page.html — confirming the template exists and is valid.
Actual behavior
The Site Editor landing view renders only the page title (e.g. "Front") with no
content. It appears to load the static page's content rather than the
front-page.html template.
The frontend (/) renders correctly using front-page.html.
Impact
This inconsistency between the Site Editor preview and the actual frontend output
causes significant confusion, particularly for:
- Non-technical users who assume their theme is broken and begin unnecessary
debugging
- Theme authors testing templates in the Site Editor
- Site builders
who have no clear way to diagnose the discrepancy
Because the frontend renders correctly, users often cannot determine whether the
issue is with their theme, their configuration, or the editor itself.
Additional notes
- Navigating directly to Editor → Templates → Front Page shows the correct
template — the issue is isolated to the initial landing view of the Site Editor
- This suggests the landing view URL resolution logic does not account for
front-page.html taking priority over a static page assignment
Related issues: #52388, #53264, #55431, #63783
Step-by-step reproduction instructions
- Use a block theme that includes a
front-page.html template
- Go to Settings → Reading and set "Your homepage displays" to A static page
- Assign a page (e.g. "Front") as Homepage, and another (e.g. "Blog") as
Posts page
- Navigate to Appearance → Editor (
/wp-admin/site-editor.php)
Screenshots, screen recording, code snippet
Environment info
- WordPress: 7.0, RC2, 7.0 beta 5
- PHP: 8.4
- Theme: [twentytwentyfive] (includes
front-page.html)
- Browser: Chrome
Please confirm that you have searched existing issues in the repo.
Please confirm that you have tested with all plugins deactivated except Gutenberg.
Please confirm which theme type you used for testing.
Description
This issue was previously reported and marked as fixed in Gutenberg 16.4 (#53264)
and again in 16.6.0 (#55431), but the problem is still reproducible in current
versions of WordPress and Gutenberg.
When a block theme includes
front-page.htmland the site is configured to displaya static homepage under Settings → Reading, the Site Editor landing view
(
/wp-admin/site-editor.php) renders only the page title with no content —effectively a blank canvas. The
front-page.htmltemplate is not loaded onthe initial view, even though it takes precedence over all other templates per
WordPress template hierarchy.
This is a Site Editor-only issue. The frontend renders correctly.
Why this is not a duplicate of #53264 or #55431
Both previous issues were closed as resolved, but the regression persists:
The root cause appears not to have been fully addressed: the Site Editor
determines its landing template based on the assigned static page rather than
respecting
front-page.htmltemplate hierarchy.Expected behavior
The Site Editor should load and preview
front-page.html, since that templatetakes precedence over all others on the homepage per WordPress template hierarchy.
Navigating to Editor → Templates → Front Page does correctly display
front-page.html— confirming the template exists and is valid.Actual behavior
The Site Editor landing view renders only the page title (e.g. "Front") with no
content. It appears to load the static page's content rather than the
front-page.htmltemplate.The frontend (
/) renders correctly usingfront-page.html.Impact
This inconsistency between the Site Editor preview and the actual frontend output
causes significant confusion, particularly for:
debugging
who have no clear way to diagnose the discrepancy
Because the frontend renders correctly, users often cannot determine whether the
issue is with their theme, their configuration, or the editor itself.
Additional notes
template — the issue is isolated to the initial landing view of the Site Editor
front-page.htmltaking priority over a static page assignmentRelated issues: #52388, #53264, #55431, #63783
Step-by-step reproduction instructions
front-page.htmltemplatePosts page
/wp-admin/site-editor.php)Screenshots, screen recording, code snippet
Environment info
front-page.html)Please confirm that you have searched existing issues in the repo.
Please confirm that you have tested with all plugins deactivated except Gutenberg.
Please confirm which theme type you used for testing.