The "custom" control

Learn how to create controls using Kirki

Back to Controls

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

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.

Edit this page