Repository navigation
Phase 2: Customization #33094
Description
This supersedes #24551 for tracking upcoming tasks around the main site editing projects. There are a few separate tracking issues for covering some general improvements and then some broader projects:
Main Tasks
Browse
- Re-Introduce Content Editing in the Site Editor #44461
- Finalize site hub elements #50394
- Meta actions on details view #50379
- Details View → Templates #49597
- Update Templates panel #51454
- Details View → Template Part #50392
- Details View → Page #50390
- Details view → Styles #50429
- Template Parts and path towards "library" management #50397
- Navigation on Browse Mode #50396
- Display home / loop icon on the relevant page details view #50582
Editor
- Stabilize the Title Bar #50378
- Introduce "Browser" and surface main navigation UI #36667
- Creation modal for "New Page" #48456
- Add new Template modal #50395
- Command Center: Quick search for jumping to other pages or templates in the editor. #48457
- Editor: expose revisions in the UI for all available post types #49601 (E.g. templates, template parts, patterns, global styles)
- Top Toolbar improvements #40450
- Refine the Site Editor loading state #35503
Patterns
- The
wp:patternblock #48458 - Library: enable ability to create & classify a pattern library alongside reusable blocks #50028
- Surface related patterns in the template inspector #44582
Blocks
- Image Block: Surface aspect-ratio tool for custom image dimensions #38990
- Link UI (<LinkControl>) Overview Issue #49091
- Navigation 6.3 Priorities #50165
Styles
Tasks below were done in WordPress 6.2.
- [Patterns] Pattern Inserter: Next #41379
- [Blocks] Navigation Overview: Phase 2 priorities #41549
- [Blocks] Split block tools between "settings" and "appearance" #40204
- [Patterns] Revisiting / contextualising pattern categories, and default inclusions #44501
- [Editor] Inserter: Add Media tab and explore basic Openverse integration #44496
- [Editor] Move document information and outline to list view panel #44193
- [Editor] Colorise template parts and reusable blocks in the UI #32163
- [Tools] Make it possible to set the width of blocks within Row #44467
- [Tools] Group: Add setup state to allow picking a variant (default/row/stack) #43433
- [Editor] Add a shortcut for template browsing #37001
- [Patterns] Improving intuition of the 'Query' pattern category #43427
- [Blocks] Layout jumps when selecting an image #44359
- [Styles] Global Styles: display inline preview on per-block settings #42919
- [Styles] Add Box Shadow Component #44651
- [Styles] Make it possible to push local block styles to global block styles #44361
- [Styles] Global Styles: an input for custom CSS #30142
- [Styles] Global styles – per-block custom css #44412
- [Tools] Fixed Position Header and Footer Template Parts #30121
- [Styles] Global styles: Offer a way to view a document containing all blocks and styles #44420
⤵️ - [Blocks] Make it easy to copy (and paste) block styles #44418
⤵️ - [Templates] Provide a pathway to migrate widgets to block themes #39270
Editor
The template editor is what powers editing wp_template entries and files.
Patterns
From directory browsing to placeholder setup to transformations, patterns are a crucial component of the entire site editing scope and the planned improvements are outlined here.
Styling
Includes the global styles project, design tools in specific site editing blocks, and any further work around theme integration (palettes, gradients, content width, etc).
Themes
Flows regarding themes as a whole, from theme switching to theme export.
Gradual Adoption
While full block themes are at the avant-garde of using blocks everywhere, there's still valuable work to be done to improve how all themes can interact with blocks and make use of the new tools gradually and at their own pace.



Activity
[-]Remaining scope for Site Editing projects[/-][+]Updated scope for site editing projects[/+]mtias commentedon Jul 3, 2021
They will work once the remaining infrastructure pieces and dependencies (missing blocks) are included even without the theme editor.
carolinan commentedon Jul 4, 2021
The theme editor is what WordPress calls the built in file editor in the WordPress admin area,. Please help me understand what part that editor plays in whether or not a block theme/ full site editing theme can be activated.
mtias commentedon Jul 8, 2021
Sorry, I was using "theme editor" to mean "site editor" in the above (the block editor that is able to edit all templates of a theme). The current built in file editor would still be there for any kind of theme, though it remains to be seen if it's de-emphasized in the block theme case given you still hace access to all files, provided it's not mixing php files with html templates.
mtias commentedon Jul 15, 2021
Update: broke design tools into its sub-tracking issue at #33447.
mtias commentedon Aug 6, 2021
Update: added "focused template part" mode as a separate item under Template Editor #33926.
priethor commentedon Aug 12, 2021
Update: added "A lighter Navigation Block Experience" as a complement to the existing Navigation Block Tracking Issue #34041
mtias commentedon Sep 6, 2021
Update: added "The Global Styles Interface" to the styling milestone #34574.
gingerling commentedon Oct 9, 2021
Hi, Is there a plan for category pages etc to be fully editable with blocks like any other page? This would be brilliant for woocommerce. There are some hacky ways round it at the moment, using redirects to replace category pages with normal pages etc, or using canonical url and linking from the menu, but it feels like a huge seo risk to start messing with my site structure this way. I'm wondering how much more research and effort i should put into this, with the way wordpress is going maybe this will be resolved in a year or so?
mtias commentedon Oct 9, 2021
@gingerling with block themes you'd indeed be able to edit category templates, either globally, or for a specific category:
gingerling commentedon Oct 9, 2021
Sounds great. Forgive my ignorance, is this available now? Or is this in the works? Is there a roadmap with expected release if so? Thanks for your help!
mtias commentedon Oct 13, 2021
@gingerling the above is available in the Gutenberg plugin paired with a block theme. It's currently targeted for inclusion in WP 5.9.
39 remaining items
annezazu commentedon Jan 30, 2023
January 30th Update
☑️ = work has completed - 21 (no change)
🟢 = means dev work is underway - 5 (-4)
🟡 🖌️ = means we’re in the design stage still - 2 (no change)
🟡 💻 = means a dev is assigned but hasn’t started or work hasn't continued in 14+ days - 6 (+4)
🔴 🖌️ = means design is blocked/on hold due to other work - 2 (no change)
🔴 💻 = means ready for dev with no dev assigned - 0 (no c hange)
🆕 = New issue since the last update - 0 (-1)
🤚 = anywhere this is used means we're stuck, but tracking down what's going on/where we can get unstuck - 0 (no change)
Patterns
Styles
Editor
Tools
Blocks
Templates
annezazu commentedon Feb 7, 2023
February 7th Update
The overall issue was modified and updated by @mtias after the publishing of an update post on Phase 2 found here. As a result, there are some new items without any corresponding issues and the format might adjust slightly. Finally, the update was delayed due to sickness on my end!
☑️ = work has completed - 22 (+1)
🟢 = means dev work is underway - 7 (+2)
🟡 🖌️ = means we’re in the design stage still - 2 (no change)
🟡 💻 = means a dev is assigned but hasn’t started or work hasn't continued in 14+ days - 4 (-2)
🔴 🖌️ = means design is blocked/on hold due to other work - 8 (+6)
🔴 💻 = means ready for dev with no dev assigned - 0 (no change)
🆕 = New issue since the last update - 6 (+6)
🤚 = anywhere this is used means we're stuck, but tracking down what's going on/where we can get unstuck - 0 (no change)
Patterns
Styles
Editor
Tools
Blocks
Templates
kevin940726 commentedon Feb 8, 2023
I have another one about shuffling template parts opened in #47763 that we could get some eyes on too. There are some unanswered questions and alternative approaches in the PR description. Would love to get some early feedback on it and #47594 too ❤️ !
annezazu commentedon Feb 14, 2023
FYI: Updates are going to move to monthly for a time
This is to better reflect where we are in the 6.2 release cycle and to prevent these updates from becoming more noise rather than signal. After a period of monthly updates, this will be re-evaluated as 6.3 begins to get closer as well with a strong chance for a return to weekly updates to once more track work more closely.
annezazu commentedon Mar 13, 2023
March 13th Update
☑️ = work has completed - 21 (-1)
🟢 = means dev work is underway - 3 (-4)
🟡 🖌️ = means we’re in the design stage still - 0 (-2)
🟡 💻 = means a dev is assigned but hasn’t started or work hasn't continued in 14+ days - 6 (+2)
🔴 🖌️ = means design is blocked/on hold due to other work - 5 (-3)
🔴 💻 = means ready for dev with no dev assigned - 0 (no change)
🆕 = New issue since the last update - 0 (-6)
🤚 = anywhere this is used means we're stuck, but tracking down what's going on/where we can get unstuck - 1 (+1)
Note that two issues that were previously mentioned have been removed: Shuffle content blocks when templateLock is contentOnly (incomplete) and Style variations for block types (complete). This is why there’s a -1 next to work completed.
Patterns
Styles
Editor
Tools
Blocks
Templates
Browse
colorful-tones commentedon Mar 24, 2023
I would like to suggest that this get some attention and be added to the Gutenberg Phase 2: Customization board:
annezazu commentedon Apr 17, 2023
April 16th Update
☑️ = work has completed - 21 (no change)
🟢 = means dev work is underway - 5 (+2)
🟡 🖌️ = means we’re in the design stage still - 5 (+5)
🟡 💻 = means a dev is assigned but hasn’t started or work hasn't continued in 14+ days - 5 (-1)
🔴 🖌️ = means design is blocked/on hold due to other work - 3 (-2)
🔴 💻 = means ready for dev with no dev assigned - 0 (no change)
🆕 = New issue since the last update - 0 (no change)
🤚 = anywhere this is used means we're stuck, but tracking down what's going on/where we can get unstuck - 3 (+2)
Patterns
Styles
Editor
Tools
Blocks
Templates
Browse
carolinan commentedon Apr 17, 2023
There is an early WIP for this here: #49607
annezazu commentedon May 15, 2023
May 15th Update
Important notes:
Numerous changes happened since the last update and the following bulleted list captures those:
As a result of the changing items, “work completed” is going to include the Main Tasks along with the list just below as that’s where the completed items from a few months ago are listed.
☑️ = work has completed - 24 (+3)
🟢 = means dev work is underway - 6 (+1)
🟡 🖌️ = means we’re in the design stage still - 13 (+7)
🟡 💻 = means a dev is assigned but hasn’t started or work hasn't continued in 14+ days - 3 (-2)
🔴 🖌️ = means design is blocked/on hold due to other work - 2 (-1)
🔴 💻 = means ready for dev with no dev assigned - 1 (+1)
🆕 = New issue since the last update - 12 (+12)
🤚 = anywhere this is used means we're stuck, but tracking down what's going on/where we can get unstuck - 13 (+10)
Browse
Editor
Patterns
Blocks
Styles
annezazu commentedon Jun 28, 2023
June 28th 2023
I was off work for two weeks leading to a delay in this update. Thanks for the patience. As we settle into the new order, sharing updated numbers but removing the change for this round since it isn't 1:1 with the last update.
☑️ = work has completed - 20
🟢 = means dev work is underway - 1
🟡 🖌️ = means we’re in the design stage still - 3
🟡 💻 = means a dev is assigned but hasn’t started or work hasn't continued in 14+ days - 1
🔴 🖌️ = means design is blocked/on hold due to other work - 0
🔴 💻 = means ready for dev with no dev assigned - 1
🆕 = New issue since the last update - 0
🤚 = anywhere this is used means we're stuck, but tracking down what's going on/where we can get unstuck - 1
Browse
Editor
Patterns
Blocks
Open in new tabwithin Link Control #50961Styles
mtias commentedon Jun 29, 2023
I'm closing this issue as WordPress 6.3 is now out in beta. It has served us well for a couple years, tracking the progress and main scope of the customization phase. As the project moves on, we'll be looking at improvements to the customization experience as distinct milestones and complimenting the work soon to be started on phase 3. Active areas of work will be referenced in #52128.
So long, phase 2! And huge kudos to everyone that contributed to getting us to this point. 🌟🌟🌟🌟