Customize component

The Customize component covers all aspects of the Customizer, WordPress’ framework for live-previewing any change to your site. Tickets in this component cover issues including bugs in the Customizer (wp-admin/customize.php), PHP and JS API improvements, UI/UX changes, new features, and improvements to the Customizer internals. For more information about the Customizer API, please see its official documentation in the Theme Developer Handbook.

The Customizer is actively developed, with work happening on core trac, various GitHub repos, and in the #core-customize channel on WordPress Slack. Weekly meetings for the 4.7 cycle are held on Mondays at 17:00UTC.New contributors are always welcome, whether you bring code, design help, testing, or anything else. Below is a summary of our larger projects past and future projects, which were all accompanied by countless smaller changes.

Projects for Future Releases

  • A new experience for themes in the customizer#37661 – ready for trunk commit
  • Expose UI for drafts, scheduled changes, and revisions of customize changesets
  • Improve loading of the Customizer from the front-end (on hold, see #28602, #28661)
  • Introduce inline editing/inline controls within the preview
  • Explore content-editing/front-end-editing integration (on hold, pending live preview feature project)
  • Improve performance wherever possible (ongoing goal)

For more details, see the proposed roadmap.

4.7 4.6 4.5
  • Performance Improvements
4.3 4.2
4.1 4.0 3.9
  • Customizer Introduced in Core

Recent posts on the make/core blog

View all posts tagged customize.

Recent posts on the make/test blog

View all posts tagged customize.

203 open tickets in the Customize component

203 open tickets defect (bug) enhancement feature request task (blessed)
4.7.3 18 1 0 0
4.8 11 24 3 0
Awaiting Review 34 18 3 0
Future Release 35 53 1 2

203 open tickets. Last 7 days: +1 ticket

4 tickets that have no replies

View list on Trac

  • #38957  Customize Menus: Menu locations should be able to opt-out of menu item types that can be added to associated menus
  • #39275  Improve for changesets. javascript
  • #39713  Customize: Changeset post_date does not bump when an auto-draft is updated
  • #39913  Customize: Disable auto-trashing of published changesets in anticipation of revisions

38 tickets slated for 4.8

View list in Trac

  • #18584  Nav menus need more hooks for extensibility (on admin page & in customizer) javascript
  • #21627  Filter for custom-background CSS selector
  • #28536  Add browser history and deep linking for navigation in Customizer preview ui javascript
  • #30738  JS content templates for base WP_Customize_Control javascript rest-api
  • #32296  Allow the customizer to be made wider ui javascript
  • #32816  No or inadequate Custom Link URL validation ui javascript
  • #33085  Customizer: controls description inside labels are not real labels nor descriptions ui accessibility
  • #34843  Customizer: allow themes in the Customizer to be disabled by plugins
  • #35832  Paste action in text field/area context menu in theme customizer leaves Save&Publish button disabled (Firefox) ui javascript administration
  • #36191  Support responsive images in WP_Customize_Media_Control ui administration
  • #37471  Customizer: Widgets: If your theme only has one widget area, we should open it automatically ui administration
  • #37661  A New Experience for Discovering, Installing, and Previewing Themes in the Customizer ui accessibility javascript
  • #37964  Allow customizer controls to be encapsulated by accepting pre-instantiated settings javascript
  • #38072  Eliminate placeholder nav menu items in favor of auto-drafts in Customizer
  • #38077  Facilitating embedding customizer controls outside of sections
  • #38329  Create positioning control for Custom Logos
  • #38624  Allow starter content to apply after a site has already been set up and is no longer “fresh”
  • #38666  Reassure users when the customizer is doing a full reload ui
  • #38707  Customizer: Additional CSS highlight, revisions, selection, per-page, pop-out
  • #38794  Customize: Allow panels and sections to have notifications just like controls can
  • #38796  Customize media control button labels should automatically reflect the specified mime type
  • #38845  Implement HTML5 input validity constraints in customizer settings
  • #38900  Customize: Add REST API endpoints for changesets rest-api
  • #38953  Customize Menus: clicking outside of the available menu items panel does not close the panel
  • #38954  Customizer: Increase preview refreshBuffer (perhaps with decay) when making rapid changes such as via text inputs
  • #39099  Customize: Defer triggering selective refresh for all settings until after synced
  • #39218  Customize: Harden validation of CSS syntax validity by utilizing tokenizer
  • #39221  Customize: Prevent setting previewing logic when settings will be saved
  • #39275  Improve for changesets. javascript
  • #39389  Customize: Make sure selective refreshed partial placement is scrolled into view ui
  • #39634  Customize: Add REST API endpoints for panels, sections, controls, settings, and partials rest-api
  • #39662  Color picker accessibility improvements accessibility javascript
  • #39671  Customize: Further improve inline documentation docs
  • #39681  Add RGBA to Customizer color picker ui
  • #39752  Customize: add a post editing flow ui
  • #39778  Introduce helper function to validate UUID V4
  • #39892  Default value in Additional CSS ui
  • #39896  Customizer: Allow users to Draft changes before Publishing ui

203 open tickets

Open bugs: 98. View list on Trac

Help maintain this component

Component maintainers:

  • westonruter
  • celloexpressions
  • voldemortensen
  • valendesigns

Many contributors help maintain one or more components. These maintainers are vital to keeping WordPress development running as smoothly as possible. They triage new tickets, look after existing ones, spearhead or mentor tasks, pitch new ideas, curate roadmaps, and provide feedback to other contributors. Longtime maintainers with a deep understanding of particular areas of core are always seeking to mentor others to impart their knowledge.

Want to help? Start following this component! Adjust your notifications here. Feel free to dig into any ticket.

Contributors following this component: