> Source: https://builder-docs.ema.ai/agent-reference/core/text-categorizer
> Title: Text Categorizer Agent

# Text Categorizer Agent

> **Note:** The original version of this agent (v0) is deprecated. For new workflows, use the [Categorizer](/legacy-docs/agent-reference/core/categorizer) agent instead, which accepts text and any other input type via named inputs. Existing workflows using Text Categorizer continue to work.

The Text Categorizer agent classifies plain text into user-defined categories using AI. It is a streamlined categorization agent for when your input is already in text form and you need single-category classification.

## Use Cases

-   You have plain text input that needs to be classified into one of several categories.
-   Your text has already been converted from another format (e.g., via Convert to Text) and needs classification.
-   You want simple text classification without the overhead of configuring named inputs.

## Inputs

Input

Type

Description

`text`

Text

The text to classify. Required -- the agent returns the fallback category if this is empty.

_Additional inputs_

Various (optional)

You can wire additional context from other agents as supplemental inputs. The agent considers these alongside the primary text.

## Outputs

Output

Type

Description

`category`

Category

The assigned category name.

Each category produces a branch edge on the GWE canvas.

## Configurations

Parameter

Description

Default

**Categories**

List of categories with names and descriptions (up to 1,000 characters each).

Required

**Fallback category**

Category assigned when the text is empty or no category matches. Defaults to "Fallback."

Required

**Instructions**

Additional classification guidance for the LLM.

None

**Qualification criteria**

Deterministic rules per category. Requires a [JSON Extractor](/legacy-docs/agent-reference/core/json-extractor) upstream to supply structured data.

None

**Process entire document**

When supplemental document inputs are wired, controls whether the full content is sent to the LLM.

Off

## How to Use This Agent

```
document_trigger -> convert_to_text -> text_categorizer
 -> [urgent] -> human_collaboration
 -> [routine] -> knowledge_search -> respond
 -> [spam] -> abstain_from_answering
```

## Text Categorizer vs. Categorizer

The [Categorizer](/legacy-docs/agent-reference/core/categorizer) (v1) supersedes the Text Categorizer (v0). Key differences:

Feature

Text Categorizer

Categorizer

Primary input

Plain text (required)

Any type via named inputs

Multiple input types

Limited supplemental inputs

Full named inputs support

Custom instructions

Basic instructions field

Rich categorization instructions

Status

Deprecated (v0)

Current (v1)

## Related Agents

-   [Categorizer](/legacy-docs/agent-reference/core/categorizer) -- the recommended replacement. More flexible, accepts any input type.
-   [Document Categorizer](/legacy-docs/agent-reference/core/document-categorizer) -- for classifying document objects directly (also deprecated).
-   [Categorize Conversations and Route](/legacy-docs/agent-reference/core/categorize-conversations-and-route) -- for classifying chat conversations.