Skip to content

[Website] Add Gutenberg branch setting - #4254

Draft
fellyph wants to merge 1 commit into
trunkfrom
codex/query-api-source-branches
Draft

[Website] Add Gutenberg branch setting#4254
fellyph wants to merge 1 commit into
trunkfrom
codex/query-api-source-branches

Conversation

@fellyph

@fellyph fellyph commented Aug 10, 2026

Copy link
Copy Markdown
Collaborator

What changed

  • Add a Gutenberg Branch selector to Site Settings with shortcuts for trunk, wp/next, and wp/latest.
  • Carry the selected branch through the Sites API to the existing gutenberg-branch Query API parameter.
  • Treat changing the branch as an installation-level setting that creates a fresh Playground.
  • Preserve custom branch values from existing setup URLs and document the new UI/Sites API option.

Why

The Query API already supports Gutenberg branch previews, but Site Settings only exposed WordPress, PHP, language, networking, and multisite controls. Users had to edit the URL manually to preview the maintained Gutenberg branches.

WordPress Core branch previews are intentionally not exposed because wordpress-develop does not publish matching branch artifacts; the existing WordPress Version control continues to cover release, beta, and trunk builds.

User impact

Developers can choose the main Gutenberg development channels directly from Site Settings. Applying a branch creates a fresh Playground and installs the selected Gutenberg artifact.

Before and after

Before

Site Settings had no Gutenberg branch selector, so branch previews required manually editing the Query API URL.

Site Settings before the change, without a Gutenberg Branch selector

After

Site Settings includes a Gutenberg Branch dropdown with trunk, wp/next, and wp/latest shortcuts.

Site Settings after the change, with the Gutenberg Branch selector

Validation

  • npm exec nx test playground-website (370 tests)
  • npm exec nx typecheck playground-website
  • npm exec nx lint playground-website
  • Manual browser verification with wp/next: branch download completed, selection persisted, and Gutenberg was active.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

[Aspect] Browser [Aspect] Website [Type] Documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant