WP_Customize_Control::__construct( WP_Customize_Manager $manager, string $id, array $args = array() )


Supplied $args override class property defaults.

If $args['settings'] is not defined, use the $id as the setting ID.



(WP_Customize_Manager) (Required) Customizer bootstrap instance.


(string) (Required) Control ID.


(array) (Optional) Array of properties for the new Control object.

  • 'instance_number'
    (int) Order in which this instance was created in relation to other instances.
  • 'manager'
    (WP_Customize_Manager) Customizer bootstrap instance.
  • 'id'
    (string) Control ID.
  • 'settings'
    (array) All settings tied to the control. If undefined, $id will be used.
  • 'setting'
    (string) The primary setting for the control (if there is one). Default 'default'.
  • 'capability'
    (string) Capability required to use this control. Normally this is empty and the capability is derived from $settings.
  • 'priority'
    (int) Order priority to load the control. Default 10.
  • 'section'
    (string) Section the control belongs to.
  • 'label'
    (string) Label for the control.
  • 'description'
    (string) Description for the control.
  • 'choices'
    (array) List of choices for 'radio' or 'select' type controls, where values are the keys, and labels are the values.
  • 'input_attrs'
    (array) List of custom input attributes for control output, where attribute names are the keys and values are the values. Not used for 'checkbox', 'radio', 'select', 'textarea', or 'dropdown-pages' control types.
  • 'allow_addition'
    (bool) Show UI for adding new content, currently only used for the dropdown-pages control. Default false.
  • 'json'
    (array) Deprecated. Use WP_Customize_Control::json() instead.
  • 'type'
    (string) Control type. Core controls include 'text', 'checkbox', 'textarea', 'radio', 'select', and 'dropdown-pages'. Additional input types such as 'email', 'url', 'number', 'hidden', and 'date' are supported implicitly. Default 'text'.
  • 'active_callback'
    (callback) Active callback.

Default value: array()


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



Version Description
3.4.0 Introduced.
Scroll to Top