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

# facet:dropdown

export const LwTemplate = ({title = "Key questions to get you started", icon = "sparkles", cta = "Powered by Agent Studio", linkHref = "https://lucidworks.com/demo/?utm_source=docs&utm_medium=referral&utm_campaign=docs_cta_ai"}) => {
  const [isLoaded, setIsLoaded] = useState(false);
  useEffect(() => {
    const timer = setTimeout(() => {
      setIsLoaded(true);
    }, 500);
    return () => clearTimeout(timer);
  }, []);
  return <div className="lw-template-container">
      <Card title={title} icon={icon}>
        {isLoaded && <span dangerouslySetInnerHTML={{
    __html: `<lw-template id="a029c1a9-28be-427e-b0e1-5d918920246a"></lw-template
            >`
  }} />}
        <Link href={linkHref} className="agent-studio-link text-left text-gray-600 gap-2 dark:text-gray-400 text-sm font-medium flex flex-row items-center hover:text-primary dark:hover:text-primary-light group-hover:text-primary group-hover:dark:text-primary-light">Powered by Lucidworks Agent Studio</Link>
      </Card>
    </div>;
};

[localhost link]: http://localhost:3000/docs/4/app-studio/reference/tags/lightning.directive.facetDropdown

[mintlify link]: https://doc.lucidworks.com/docs/4/app-studio/reference/tags/lightning.directive.facetDropdown

[old doc.lw link]: https://doc.lucidworks.com/app-studio/4.2/1146

<LwTemplate />

## Description

Display a facet as a select dropdown, allowing the user to apply one or
more filters by selection options from the dropdown. To specify the
facet that should be rendered, either pass in a facet object directly or
specify a facet-name and a response from where to retrieve that named
facet.

## Usage

as element:

```xml wrap  theme={"dark"}
<facet:dropdown
       facet="{string}"
       response="{string}"
       facet-name="{string}"
       [select="{string}"]
       display-label="{string}"
       [search-enabled="{boolean}"]>
</facet:dropdown>
```

#### Parameters

| Param                        | Type        | Details                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ---------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| facet                        | **string**  | A facet object to display                                                                                                                                                                                                                                                                                                                                                                                                                   |
| response                     | **string**  | The name of the response to use.                                                                                                                                                                                                                                                                                                                                                                                                            |
| facet-name                   | **string**  | Facet name to use from the response object                                                                                                                                                                                                                                                                                                                                                                                                  |
| select  *(optional)*         | **string**  | How to render each facet filter  <br />Valid values:<br />  <br />● **multiselect**  Supports selecting multiple filters that get combined with an 'OR'. <br />● **toggle**  Only allows one filter to be selected at a time but shows unselected filters and counts <br />● **multiselect-instant**  Supports selecting multiple filters that get combined with an 'OR', filters will be applied automatically.                            |
| display-label                | **string**  | Initial display value for dropdown                                                                                                                                                                                                                                                                                                                                                                                                          |
| search-enabled  *(optional)* | **boolean** | Whether to enable search on the facet. If no query or platform is defined on the facet or facet-list it will enable the user to search through the filters that have been returned in the response. If a platform and query is defined on the facet or facet-list then it will search for filters in the search index. (Requires a tokenized field, if not using a tokenized field, if not using a tokenized field please see facet-field). |