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'    => 'custom_setting',
	// 'label'       => esc_html__( 'This is the label', 'kirki' ), // optional
	'section'     => 'kirki_options',
		'default'         => '<h3 style="padding:15px 10px; background:#fff; margin:0;">' . __( 'Headline', 'kirki' ) . '</h3>',
	'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.

Last updated on: May 10th, 2020

Scroll to Top


Subscribe & be the first to be informed about
new features & updates!