Current File : /var/www/html/qendrasteps/wp-content/themes/tm-heli/core/kirki/docs/docs/controls/dashicons.md
---
layout: default
title: The "dashicons" control
slug: dashicons
subtitle: Learn how to create controls using Kirki
mainMaxWidth: 50rem;
bodyClasses: control page
returns: string
heroButtons:
- url: ../controls
class: white button round border-only
icon: fa fa-arrow-circle-o-left
label: Back to Controls
---
The `dashicons` control allows you to select an available icons from the WordPress [Dashicons iconfont](https://developer.wordpress.org/resource/dashicons/).
The returned value is a string and does not contain the `dashicons dashicons-` prefix, and allows you to handle the selected values as you see fit.
### Example
```php
<?php
Kirki::add_field( 'theme_config_id', array(
'type' => 'dashicons',
'settings' => 'my_setting',
'label' => __( 'Dashicons Control', 'textdomain' ),
'section' => 'section_id',
'default' => 'menu',
'priority' => 10,
) );
?>
```
### Usage
```php
<?php $icon = get_theme_mod( 'my_setting', 'menu' ); ?>
<span class="dashicons dashicons-<?php echo esc_attr( $icon ); ?>"></span>
```
Mini Shell