WordPress Customizer Custom Control

Learn how to create a custom control using the Kirki Customizer Framework.

Back to Controls

Custom controls allow you to add raw HTML in a control. Mostly used for informative controls, expanatory headers etc, but you can use it for whatever you want.

You can enter your custom HTML in the field’s default argument.


Kirki::add_field( 'theme_config_id', [
	'type'        => 'custom',
	'settings'    => 'my_setting',
	'label'       => esc_html__( 'This is the label', 'kirki' ),
	'section'     => 'section_id',
	'default'     => '<div style="padding: 30px;background-color: #333; color: #fff; border-radius: 50px;">' . esc_html__( 'You can enter custom markup in this control and use it however you want', 'kirki' ) . '</div>',
	'priority'    => 10,
] );

The content of the field is defined in the default argument. You can use valid HTML.


The custom control does not return any value. Its function is usually decorative and informational in the customizer.

Can't find what you're looking for? Check the github issues or edit this page to add what's missing.