---
title: "File indexer"
manual: "TYPO3 Search Algolia"
version: "2.0"
permalink: "https://docs.typo3.org/permalink/meine-krankenkasse/typo3-search-algolia:indexers-file@2.0"
source: "Indexers/FileIndexer.rst"
rendered: "2026-09-30T12:15:07+00:00"
---

# File indexer {#indexers-file}

The file indexer indexes files from the file collections selected in the
indexing service. For PDF files it also extracts the text content.

## Excluding a file {#indexers-file-exclude}

The extension adds an **Include in Search** option to the file
metadata, on a new **Behaviour** tab. It is enabled by default.
Disable it to keep a file out of the index.

![File metadata, Behaviour tab with the Include in Search toggle](../Images/FileIndexer-001.png)

## Context menu {#indexers-file-context-menu}

A single file can be queued directly with the context menu entry
**Add to the Algolia search queue** in the **Filelist** module.

## Fields {#indexers-file-fields}

In addition to the [standard fields](https://docs.typo3.org/permalink/meine-krankenkasse/typo3-search-algolia:indexers-standard-fields@2.0), the
file indexer sends:

| Field | Description |
| --- | --- |
| `extension` | The file extension. |
| `mimeType` | The MIME type of the file. |
| `name` | The file name. |
| `size` | The file size in bytes. |
| `url` | The public URL of the file, without the leading slash for files in a local storage. |
| `content` | The extracted text, only for PDF files. |

The mapped metadata fields and the allowed file extensions default to:

**Default configuration of the file indexer**

```typoscript
module.tx_typo3searchalgolia.indexer.sys_file_metadata {
    fields {
        title = title
        description = description
        alternative = alternative
        creator = author
    }

    # Comma-separated list of allowed file extensions
    extensions = pdf
}
```

Indexed file content becomes searchable. The protection of non-public
storages is not evaluated. Their files are indexed like public ones. Keep
sensitive documents out of the indexed file collections, or exclude them
individually.