Title: WP_Customize_Code_Editor_Control
Published: November 20, 2017
Last modified: August 20, 2026

---

# class WP_Customize_Code_Editor_Control {}

## In this article

 * [Description](https://developer.wordpress.org/reference/classes/wp_customize_code_editor_control/?output_format=md#description)
    - [See also](https://developer.wordpress.org/reference/classes/wp_customize_code_editor_control/?output_format=md#see-also)
 * [Methods](https://developer.wordpress.org/reference/classes/wp_customize_code_editor_control/?output_format=md#methods)
 * [Source](https://developer.wordpress.org/reference/classes/wp_customize_code_editor_control/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/classes/wp_customize_code_editor_control/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/classes/wp_customize_code_editor_control/?output_format=md#changelog)

[ Back to top](https://developer.wordpress.org/reference/classes/wp_customize_code_editor_control/?output_format=md#wp--skip-link--target)

Customize Code Editor Control class.

## 󠀁[Description](https://developer.wordpress.org/reference/classes/wp_customize_code_editor_control/?output_format=md#description)󠁿

### 󠀁[See also](https://developer.wordpress.org/reference/classes/wp_customize_code_editor_control/?output_format=md#see-also)󠁿

 * [WP_Customize_Control](https://developer.wordpress.org/reference/classes/wp_customize_control/)

## 󠀁[Methods](https://developer.wordpress.org/reference/classes/wp_customize_code_editor_control/?output_format=md#methods)󠁿

| Name | Description | 
| [WP_Customize_Code_Editor_Control::content_template](https://developer.wordpress.org/reference/classes/wp_customize_code_editor_control/content_template/) | Render a JS template for control display. | 
| [WP_Customize_Code_Editor_Control::enqueue](https://developer.wordpress.org/reference/classes/wp_customize_code_editor_control/enqueue/) | Enqueue control related scripts/styles. | 
| [WP_Customize_Code_Editor_Control::json](https://developer.wordpress.org/reference/classes/wp_customize_code_editor_control/json/) | Refresh the parameters passed to the JavaScript via JSON. | 
| [WP_Customize_Code_Editor_Control::render_content](https://developer.wordpress.org/reference/classes/wp_customize_code_editor_control/render_content/) | Don’t render the control content from PHP, as it’s rendered via JS on load. |

## 󠀁[Source](https://developer.wordpress.org/reference/classes/wp_customize_code_editor_control/?output_format=md#source)󠁿

    ```php
    class WP_Customize_Code_Editor_Control extends WP_Customize_Control {

    	/**
    	 * Customize control type.
    	 *
    	 * @since 4.9.0
    	 * @var string
    	 */
    	public $type = 'code_editor';

    	/**
    	 * Type of code that is being edited.
    	 *
    	 * @since 4.9.0
    	 * @var string
    	 */
    	public $code_type = '';

    	/**
    	 * Code editor settings.
    	 *
    	 * @see wp_enqueue_code_editor()
    	 * @since 4.9.0
    	 * @var array|false
    	 */
    	public $editor_settings = array();

    	/**
    	 * Enqueue control related scripts/styles.
    	 *
    	 * @since 4.9.0
    	 */
    	public function enqueue() {
    		$this->editor_settings = wp_enqueue_code_editor(
    			array_merge(
    				array(
    					'type'       => $this->code_type,
    					'codemirror' => array(
    						'indentUnit' => 2,
    						'tabSize'    => 2,
    					),
    				),
    				$this->editor_settings
    			)
    		);
    	}

    	/**
    	 * Refresh the parameters passed to the JavaScript via JSON.
    	 *
    	 * @since 4.9.0
    	 *
    	 * @see WP_Customize_Control::json()
    	 *
    	 * @return array Array of parameters passed to the JavaScript.
    	 */
    	public function json() {
    		$json                    = parent::json();
    		$json['editor_settings'] = $this->editor_settings;
    		$json['input_attrs']     = $this->input_attrs;
    		return $json;
    	}

    	/**
    	 * Don't render the control content from PHP, as it's rendered via JS on load.
    	 *
    	 * @since 4.9.0
    	 */
    	public function render_content() {}

    	/**
    	 * Render a JS template for control display.
    	 *
    	 * @since 4.9.0
    	 */
    	public function content_template() {
    		?>
    		<# var elementIdPrefix = 'el' + String( Math.random() ); #>
    		<# if ( data.label ) { #>
    			<label for="{{ elementIdPrefix }}_editor" class="customize-control-title">
    				{{ data.label }}
    			</label>
    		<# } #>
    		<# if ( data.description ) { #>
    			<span class="description customize-control-description">{{{ data.description }}}</span>
    		<# } #>
    		<div class="customize-control-notifications-container"></div>
    		<textarea id="{{ elementIdPrefix }}_editor"
    			<# _.each( _.extend( { 'class': 'code' }, data.input_attrs ), function( value, key ) { #>
    				{{{ key }}}="{{ value }}"
    			<# }); #>
    			></textarea>
    		<?php
    	}
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/customize/class-wp-customize-code-editor-control.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/7.1/src/wp-includes/customize/class-wp-customize-code-editor-control.php#L17)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.1/src/wp-includes/customize/class-wp-customize-code-editor-control.php#L17-L111)

## 󠀁[Related](https://developer.wordpress.org/reference/classes/wp_customize_code_editor_control/?output_format=md#related)󠁿

| Uses | Description | 
| [WP_Customize_Control](https://developer.wordpress.org/reference/classes/wp_customize_control/)`wp-includes/class-wp-customize-control.php` |

Customize Control class.

  |

## 󠀁[Changelog](https://developer.wordpress.org/reference/classes/wp_customize_code_editor_control/?output_format=md#changelog)󠁿

| Version | Description | 
| [4.9.0](https://developer.wordpress.org/reference/since/4.9.0/) | Introduced. |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fclasses%2Fwp_customize_code_editor_control%2F)
before being able to contribute a note or feedback.