---
title: "Vector filters"
manual: "AI Assistant"
version: "2.0"
source: "UserGuide/VectorFilters.rst"
rendered: "2026-10-12T14:00:01+00:00"
---

# Vector filters {#vector-filters}

Retrieval steps can restrict vector results using indexed payload metadata.
Filters are configured as inline conditions in the retrieval step.

Each condition contains:

-   a payload field path, for example `meta.document_type`;
-   an operator: `Equals`, `In list` or `Exists`;
-   a value.

All conditions in a step are currently combined with `AND`.

## Examples {#examples}

Exact value:

```text
Field: meta.document_type
Operator: Equals
Value: faq
```

Multiple values:

```text
Field: meta.language
Operator: In list
Value: de, en
```

## TYPO3 frontend language {#typo3-frontend-language}

The TYPO3 resolver supports:

```text
###FE_LANG###
```

It resolves to the current frontend language code, such as `de` or `en`.
This is useful for language-aware retrieval:

```text
Field: meta.language
Operator: Equals
Value: ###FE_LANG###
```

The filter model remains framework-independent in `ai-core`. TYPO3-specific
runtime placeholders are resolved by the TYPO3 adapter before the connector is
called.
