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

Add a customize section.



(WP_Customize_Section|string) (Required) Customize Section object, or Section ID.


(array) (Optional) 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|array) 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 value: array()


(WP_Customize_Section) The instance of the section that was added.


File: wp-includes/class-wp-customize-manager.php

	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;


Version Description
WP-4.5.0 Return added WP_Customize_Section instance.
WP-3.4.0 Introduced.