> ## Documentation Index
> Fetch the complete documentation index at: https://docs.twenty.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Icon Picker

<Frame>
  <img src="https://mintcdn.com/twenty/JIRRbviz5phT8G2L/images/user-guide/github/github-header.png?fit=max&auto=format&n=JIRRbviz5phT8G2L&q=85&s=7b60b304ddd2fead6c55719cbdd7cd32" alt="Header" width="1440" height="680" data-path="images/user-guide/github/github-header.png" />
</Frame>

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

<Tabs>
  <Tab title="Usage">
    ```jsx theme={null}
    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 (
        <IconPicker
          disabled={false}
          onChange={handleIconChange}
          selectedIconKey={selectedIcon}
          variant="primary"
        />
      );
    };
    ```
  </Tab>

  <Tab title="Props">
    | Props           | Type     | Description                                                                                                               |
    | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------- |
    | 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`                   |
  </Tab>
</Tabs>