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.

197 open tickets in the Customize component

197 open tickets defect (bug) enhancement feature request task (blessed)
4.9 13 28 4 0
Awaiting Review 35 19 3 0
Future Release 36 55 2 2

197 open tickets. Last 7 days: -1 ticket

5 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
  • #39913  Customize: Disable auto-trashing of published changesets in anticipation of revisions
  • #40044  A little strange logic in get_header_video_url() function
  • #40831  Customize: Further improve JS inline documentation docs
  • #41336  Changeset saved with `publish` status and future date is not scheduled

45 tickets slated for 4.9

View list in Trac

  • #18584  Nav menus need more hooks for extensibility (on admin page & in customizer) javascript
  • #21492  Theme customizer > Static front page: missing error message when front page and posts pages are similar ui
  • #21666  Customizer reset/undo/revert ui
  • #21819  Use an image size for custom headers instead of duplicating an attachment
  • #28536  Add browser history and deep linking for navigation in Customizer preview ui javascript
  • #28721  Scheduled changes for the customizer
  • #30277  Split up Customizer JS into separate files and remove self-booting jQuery.ready call javascript
  • #30738  JS content templates for base WP_Customize_Control accessibility javascript rest-api
  • #30741  Build-out API for adding Customizer Panels, Sections, and Controls entirely with JS
  • #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
  • #35210  Add notification area to Customizer ui javascript
  • #35832  Paste action in text field/area context menu in theme customizer leaves Save&Publish button disabled (Firefox) ui javascript 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
  • #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
  • #39099  Customize: Defer triggering selective refresh for all settings until after synced
  • #39128  Customize: Preview fails to load when domain mapping in use (home/siteurl domain mismatch)
  • #39218  Customize: Harden validation of CSS syntax validity by utilizing tokenizer
  • #39221  Customize: Prevent setting previewing logic when settings will be saved
  • #39254  When in Customizer Preview, starter content posts are not displayed in the loop administration template
  • #39275  Improve for changesets. javascript
  • #39389  Customize: Make sure selective refreshed partial placement is scrolled into view ui
  • #39461  default-preset option for custom background cannot be set by default
  • #39634  Customize: Add REST API endpoints for panels, sections, controls, settings, and partials rest-api
  • #39662  Color picker accessibility improvements accessibility javascript
  • #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
  • #39910  Customizer: Add ability to drag & drop widgets and menu items ui accessibility
  • #39930  Adding documentation for wp.customize properties javascript docs
  • #40104  Customizer: Improve menu creation flow ui administration
  • #40199  Customize: collapse suggested and previously uploaded header images with accordions ui
  • #40527  Decouple WP_Customize_Manager
  • #40922  Use finer-grained capabilities with `customize_changeset` post type
  • #41063  color-picker.js documentation javascript docs

197 open tickets

Open bugs: 84. 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: