---
title: Icon Picker
icon: TbColorPicker
image: /images/user-guide/github/github-header.png
---

A dropdown-based icon picker that allows users to select an icon from a list. 

<ArticleTabs label1="Usage" label2="Props">

<ArticleTab>

<SandpackEditor content={`import { RecoilRoot } from "recoil";
import React, { useState } from "react";
import { IconPicker } from "@/ui/input/components/IconPicker";

export const MyComponent = () => {

   const [selectedIcon, setSelectedIcon] = useState("");
   const handleIconChange = ({ iconKey, Icon }) => {
     console.log("Selected Icon:", iconKey);
     setSelectedIcon(iconKey);
   };

  return (
    <RecoilRoot>
      <IconPicker
        disabled={false}
        onChange={handleIconChange}
        selectedIconKey={selectedIcon}
        variant="primary"
      />
    </RecoilRoot>
  );
};`} />


</ArticleTab>
<ArticleTab>

<ArticlePropsTable options={[
  ['disabled', 'boolean', 'Disables the icon picker if set to `true`', ''],
  ['onChange', 'function', 'The callback function triggered when the user selects an icon. It receives an object with `iconKey` and `Icon` properties', ''],
  ['selectedIconKey', 'string', 'The key of the initially selected icon', ''],
  ['onClickOutside', 'function', 'Callback function triggered when the user clicks outside the dropdown', ''],
  ['onClose', 'function', 'Callback function triggered when the dropdown is closed', ''],
  ['onOpen', 'function', 'Callback function triggered when the dropdown is opened', ''],
  ['variant', 'string', 'The visual style variant of the clickable icon. Options include: `primary`, `secondary`, and `tertiary`', 'secondary']
]} />


</ArticleTab>
</ArticleTabs>
