---
title: "Configure Routing"
manual: "Apache Solr for TYPO3"
version: "12.1"
source: "Routing/ConfigureRouting.rst"
modified: "2026-09-16T15:14:12+00:00"
---

# Configure Routing

Currently only one route enhancer exists. It's purpose is to mask facets inside the query string or as part of the [path segment](FacetsInPathSegment.html#routing-facet-in-path).

The basement for routing is the enhancer `SolrFacetMaskAndCombineEnhancer`. Open your site configuration with an editor of your choice.

Locate the section of route enhancer `routeEnhancers`. If section available, add `routeEnhancers` to your configuration.

Use enhancer `SolrFacetMaskAndCombineEnhancer` as type of your route, and limit it to pages where the route should apply.

The extension key have to be set to `tx_solr`.

Solr specific configuration will placed inside of key `solr`.

> [!NOTE]
> To use the EXT:solr possibility to create speaking URLs for Solr facets, activate option enableRouteEnhancer in the
> Extension Configuration.

The following example shows a the basement of the enhancer configuration.

```yaml
routeEnhancers:
  products:
    type: SolrFacetMaskAndCombineEnhancer
    limitToPages:
      - 42
    extensionKey: tx_solr
    solr:
```

If you use something else as *tx_solr* for the plugin namespace (see [tx_solr.view](../Configuration/Reference/TxSolrView.html#conf-tx-solr-view)) you need additional configuration.

Change the *extensionKey* from *tx_solr* to your plugin namespace.

```yaml
routeEnhancers:
  products:
    type: SolrFacetMaskAndCombineEnhancer
    limitToPages:
      - 42
    extensionKey: search
```

The next step is to configure a path segment or to mask the facets inside of the query.