---
title: "Quick start"
manual: "ke_search"
version: "main"
source: "QuickStart/Index.rst"
rendered: "2026-09-18T09:39:22+00:00"
---

# Quick start {#quick-start}

Follow the steps below to set up a simple fulltext search for your pages.
In order to use the faceting feature see "Faceting".

-   [Download and installation](#download-and-installation)
-   [Include TypoScript](#include-typoscript)
-   [Create pages](#create-pages)
-   [Configure Plugins](#configure-plugins)
-   [Create the indexer configuration](#create-the-indexer-configuration)
-   [Start Indexer](#start-indexer)

## Download and installation {#download-and-installation}

Install the extension ke_search via extension manager or via composer (recommended):

```bash
composer require tpwd/ke_search
```

You can find the current version (and older ones) at

[https://extensions.typo3.org/extension/ke_search](https://extensions.typo3.org/extension/ke_search)

## Include TypoScript {#include-typoscript}

### Site Sets {#site-sets}

<!-- TODO: no Markdown rendering for "versionadded" -->

If you are working with TYPO3 v12.4, use TypoScript sets (the traditional way).

The extension ships some TypoScript code which can be included in the site
configuration via [Site sets](https://docs.typo3.org/m/typo3/reference-coreapi/13.4/en-us/ApiOverview/SiteHandling/SiteSets.html#site-sets):

1.  Got to backend module **Site Management > Sites**.
1.  Edit the configuration of your site.
1.  On the first tab go to **Sets for this Site**.
1.  Include the set **Faceted Search (ke_search)**.

### TypoScript sets (the traditional way) {#typoscript-sets-the-traditional-way}

If you are not using [Site Sets](#configuration-site-set) you can
add the TypoScript via the TypoScript module (formerly known as "Include
static template"):

1.  Got to backend module **Site Management > TypoScript**.
1.  Select **Edit TypoScript record** --> **Edit the whole TypoScript record**.
1.  On the first tab go to **Include TypoScript sets**.
1.  Include the set **Faceted Search (ke_search)**.

## Create pages {#create-pages}

Create a new page called "Search" (or similar) and a sysfolder called "Search data" (or similar).

![Page tree with search page](../Images/QuickStart/page-structure.png)

## Configure Plugins {#configure-plugins}

You need to create two plugins: The searchbox and the resultlist.

![Faceted Search plugin in new content element wizard](../Images/QuickStart/plugins-1.png)

1.  Create a plugin **Faceted Search: Show searchbox and filters** on the page `Search`

    Fill in the field **Record Storage Page** in the Tab **Plugin** \> **General** with
    the folder that you created in step 2 (our example: `Search data`).

    ![Plugin tab on "searchbox and filters" plugin](../Images/QuickStart/plugins-3.png)

    > [!TIP]
    > **Hint**
    >
    > It is useful to give the plugin **Searchbox and Filters** a header (our example:
    > `Searchbox`, can also set to `hidden`):
    >
    > ![Headlines palette in plugin](../Images/QuickStart/plugins-2.png)
    >
    > That makes it easier to identify the correct content element in the next step.
1.  Create a plugin **Faceted Search: Show resultlist** on the page `Search`

    In the field **Load FlexForm config from this search box** fill in the Search-Plug-In that you created in
    the previous step (our example: `Searchbox`).

    ![Plugin tab](../Images/QuickStart/plugins-5.png)

    After this steps, you should have two plugins on your search page.

    ![Page module view with two Faceted Search plugins](../Images/QuickStart/plugins-4.png)

## Create the indexer configuration {#create-the-indexer-configuration}

Use the **List** module to create an indexer configuration on the page `Search data`.

![New record view](../Images/QuickStart/indexer-configuration-1.png)

-   Choose a title.
-   Set the **Type** to `Pages`.
-   Set the **Storage** to your folder `Search data`.
-   Choose the pages you wish to index. You can decide whether the indexing process runs on all pages recursively or
    if only one page will be indexed. You can combine both fields.

![Example for an indexer configuration](../Images/QuickStart/indexer-configuration-2.png)

## Start Indexer {#start-indexer}

Open the backend module **Web** \> **Faceted Search** and start the indexing process.

![Backend module view](../Images/QuickStart/start.png)

You're done!

Open the `Search` page in the frontend and start finding ...