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.9 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 Gutenberg)
  • Improve performance wherever possible (ongoing goal)

For more details, see the proposed roadmap.

Feature Plugins

These plugins container implement features that may be incorporated into core in the future, as was done previously with Widget Customizer and Menu Customizer:

Completed Milestone Highlights

  1. 4.8
  2. 4.7
  3. 4.6
  4. 4.5
  5. 4.4
    • Performance Improvements
  6. 4.3
  7. 4.2
  8. 4.1
  9. 4.0
  10. 3.9
  11. 3.4
    • 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.2 13 2 0 0
5.0 11 5 1 2
Awaiting Review 34 17 2 0
Future Release 39 65 4 2

197 open tickets. Last 7 days: +9 tickets

15 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
  • #41992  Multiple items in WP_Customize_Media_Control
  • #42163  Customize: Add support for previewing requests made via the Fetch API javascript
  • #42191  Customize: Selectively merge settings from autosave revisions
  • #42272  Customize: Use client-side templates for rendering base controls
  • #42341  Add sandbox attribute to Customizer preview iframe to prevent top-navigation
  • #42364  Customize: Remove deprecated nav menu classes
  • #42450  Customize: Ensure customize_autosaved requests only use revision of logged-in user
  • #42544  Background Image Cover on iOS not correctly displayed template
  • #42614  Customize: Changesets can still be previewed even after having been published
  • #42635  Customize: Add default value for customizeAction param for sections
  • #42674  Multisite issue: Customizer display message to add themes to blog to non super admins multisite

19 tickets slated for 5.0

View list in Trac

  • #31334  Customizer JS API should handle container removal from document and provide destroy callback javascript administration
  • #33085  Customizer: controls description inside labels are not real labels nor descriptions ui accessibility
  • #36441  Customizer: when setting header image, site icon and logo, do not force the user to crop the image if cropping is not required
  • #39099  Customize: Defer triggering selective refresh for all settings until after synced
  • #39254  When in Customizer Preview, starter content posts are not displayed in the loop administration template
  • #39461  default-preset option for custom background cannot be set by default
  • #40278  Customizer: Introduce theme uploading ui administration
  • #40807  Starter content: Allow for setting a "parent" for pages (and other hierarchical CPTs)
  • #40831  Customize: Further improve JS inline documentation docs
  • #41271  Customizer sanitize_callback gets called multiple times on setting change performance
  • #42163  Customize: Add support for previewing requests made via the Fetch API javascript
  • #42272  Customize: Use client-side templates for rendering base controls
  • #42329  Customizer: interacting with text fields in a "wide" widget shifts child panel position in Safari. ui javascript administration
  • #42341  Add sandbox attribute to Customizer preview iframe to prevent top-navigation
  • #42364  Customize: Remove deprecated nav menu classes
  • #42558  Reduce the number of capability checks performed by the Customizer performance
  • #42614  Customize: Changesets can still be previewed even after having been published
  • #42635  Customize: Add default value for customizeAction param for sections
  • #42644  Customize: Add rich text control for managing tagline and new footer credit theme support

197 open tickets

Open bugs: 97. View list on Trac

Help maintain this component

Component maintainers:

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: