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 19: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.

213 open tickets in the Customize component

213 open tickets defect (bug) enhancement feature request task (blessed)
5.0 15 4 1 2
Awaiting Review 51 21 2 0
Future Release 41 68 4 2
0 1 0 0
4.9.9 0 1 0 0

213 open tickets. Last 7 days: +3 tickets

19 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
  • #42364  Customize: Remove deprecated nav menu classes
  • #42544  Background Image Cover on iOS not correctly displayed template
  • #42635  Customize: Add default value for customizeAction param for sections
  • #42872  Customize: Improve display of theme tag filters on mobile
  • #43168  Customizer: Iris color picker handle above section title ui
  • #43464  Search Options in Customizer
  • #43625  When there are invalid items in a menu, the customizer enters an infinite loop of refreshing when trying to render wp_nav_menu. javascript administration
  • #43858  Website-Icon with filename "favicon.ico.png" causes problems
  • #44511  Widgets generated by wp_register_sidebar_widget can not be add via customizer
  • #44598  Main logo won't update when deleted and reuploaded with the same file name
  • #44665  Add a "Create New Menu" button to the menu widget ui

22 tickets slated for 5.0

View list in Trac

  • #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
  • #38168  custom-background class appear in body class attribute even if theme doesn't support it template
  • #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
  • #40020  Customizer fails to load in Safari due to X-Origin Header mismatch
  • #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
  • #44410  Properties in class missing type definition and description in DOC comments coding-standards
  • #44633  Commented out code in class-wp-customize-nav-menus.php docs

213 open tickets

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