---
title: "Configure Routing"
manual: "Apache Solr for TYPO3"
version: "13.1"
permalink: "https://docs.typo3.org/permalink/apache-solr-for-typo3/solr:routing-configure@13.1"
source: "Routing/ConfigureRouting.rst"
modified: "2026-09-16T15:16:05+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](https://docs.typo3.org/permalink/apache-solr-for-typo3/solr:routing-facet-in-path@13.1).

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 has to be set to `tx_solr`.

Solr specific configuration will be placed inside the key `solr`.

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

The following example shows the basic enhancer configuration.

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

If you use something else than *tx_solr* for the plugin namespace (see [tx_solr.view](https://docs.typo3.org/permalink/apache-solr-for-typo3/solr:conf-tx-solr-view@13.1)) 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 the query.