> ## 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.

# Configuring the Hierarchical Facet Service

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/search-platforms/solr/hierarchical-facet-service

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

[mintlify link]: https://doc.lucidworks.com/docs/4/app-studio/reference/search-platforms/solr/hierarchical-facet-service

To correctly display a taxonomy as a hierarchical facet you must configure the requisite Appkit service to retrieve the data structure that is configured in your Solr index.

<LwTemplate />

First you must create a service configuration:

```bash wrap  theme={"dark"}
/conf
    /services
        /hierarchical
            /hierarchical.conf
```

The file 'hierarchical.conf' should be configured similar to this example:

```yml wrap  theme={"dark"}
name: twigkit.search.solr.service.facet.GreedySolrHierarchicalFacetService
platform: platforms.solr
parents-suffix: _parent
```

`platform`\
This specifies the configured platform where the taxonomy has been indexed.

`parents-suffix`\
The suffix that, if appended to the facet’s fieldname, designates the field containing parent node data. The suffix will depend on how the taxonomy data has been indexed.

This service configuration is what is used when adding the hierarchical facet to your HTML page as in this example:

```xml wrap  theme={"dark"}
<search:facet facet-name="location" show="6" show-more="100" max-characters="35" collapsible="true">
    <facet:hierarchical title="location" facet-name="location" platform="myHierarchicalPlatform" query="myHierarchicalQuery"></facet:hierarchical>
</search:facet>
```
