WP_Customize_Manager::add_section( WP_Customize_Section|string $id, array $args = array() ): WP_Customize_Section

Adds a customize section.


Top ↑

See also

Top ↑


$id WP_Customize_Section|string Required
Customize Section object, or ID.
$args array Optional
Array of properties for the new Section object.
See WP_Customize_Section::__construct() for information on accepted arguments.
More Arguments from WP_Customize_Section::__construct( ... $args ) Array of properties for the new Section object.
  • priority int
    Priority of the section, defining the display order of panels and sections. Default 160.
  • panel string
    The panel this section belongs to (if any).
  • capability string
    Capability required for the section.
    Default 'edit_theme_options'
  • theme_supports string|string[]
    Theme features required to support the section.
  • title string
    Title of the section to show in UI.
  • description string
    Description to show in the UI.
  • type string
    Type of the section.
  • active_callback callable
    Active callback.
  • description_hidden bool
    Hide the description behind a help icon, instead of inline above the first control.
    Default false.

Default: array()

Top ↑


WP_Customize_Section The instance of the section that was added.

Top ↑


File: wp-includes/class-wp-customize-manager.php. View all references

public function add_section( $id, $args = array() ) {
	if ( $id instanceof WP_Customize_Section ) {
		$section = $id;
	} else {
		$section = new WP_Customize_Section( $this, $id, $args );

	$this->sections[ $section->id ] = $section;
	return $section;

Top ↑


Version Description
4.5.0 Return added WP_Customize_Section instance.
3.4.0 Introduced.

Top ↑

User Contributed Notes

You must log in before being able to contribute a note or feedback.