Skip to content

[Regression] Site Editor landing view shows blank page instead of front-page.html when static homepage is configured #76927

@369work

Description

@369work

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

  1. Use a block theme that includes a front-page.html template
  2. Go to Settings → Reading and set "Your homepage displays" to A static page
  3. Assign a page (e.g. "Front") as Homepage, and another (e.g. "Blog") as
    Posts page
  4. Navigate to Appearance → Editor (/wp-admin/site-editor.php)

Screenshots, screen recording, code snippet

Image

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.

  • Yes

Please confirm that you have tested with all plugins deactivated except Gutenberg.

  • Yes

Please confirm which theme type you used for testing.

  • Block
  • Classic
  • Hybrid (e.g. classic with theme.json)
  • Not sure

Metadata

Metadata

Assignees

No one assigned

    Labels

    Needs TestingNeeds further testing to be confirmed.[Feature] Site EditorRelated to the overarching Site Editor (formerly "full site editing")[Type] BugAn existing feature does not function as intended

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions