Skip to main content

Custom Categories

The built-in categories cover most inboxes, but yours is unique. In Settings → AI Categories you can create your own categories, adjust the built-in ones, and train the AI to match how you think about email.

Pro+ feature

Creating custom categories and editing the built-in (system) ones requires a Pro, Business, Enterprise, or Lifetime plan. Everyone can view their definitions and accuracy metrics. For current plans, see the in-app pricing page.

The manager is organized into tabs:

TabWhat it does
DefinitionsYour categories — built-in and custom
DiscoverAI scans your inbox and suggests brand-new categories
OptimizationsSuggestions to improve accuracy, learned from your corrections
HistoryYour past classification corrections
MetricsHow accurate the classifications have been

Definitions​

Each category is shown as a row with its icon, name, and description. Badges tell you what kind it is:

  • System — a built-in MailPrism category.
  • Customized — a built-in category you've edited.
  • Disabled — turned off and not used for classification.

From here you can Edit any category, Reset a customized one back to its built-in defaults, or Delete a category you created. (Built-in categories can be edited or reset, but not deleted.)

Creating a category​

Choose Add Category and fill in the form. A category has these parts:

Basic information​

FieldWhat it's for
Classification typeWhether this defines a category, an urgency level, or a sentiment
Display nameThe human-friendly name (e.g. Important Client)
Category keyA short machine name, auto-generated from the display name
Icon & ColorHow it looks in the app
DescriptionA short line shown in the UI

AI definition​

This is what actually teaches the AI when to apply the category.

FieldWhat it's for
Definition promptA clear description of when an email belongs in this category. Be specific.
KeywordsComma-separated words that hint at this category (e.g. urgent, deadline, priority)
Sender patternsComma-separated email patterns (e.g. @important-client.com, ceo@)

Learning examples​

FieldWhat it's for
Positive examplesSubjects that should match (one per line)
Negative examplesSubjects that should not match (one per line)

Behavior settings​

SettingWhat it does
Confidence thresholdThe minimum AI confidence (50–95%) required before this category is applied
PriorityHigher-priority categories are evaluated first (1–100)
EnabledWhether the category is used when classifying email
Write the definition like you'd brief a person

The definition prompt is the most important field. Describe the intent — "emails from clients about active projects that need a timely reply" — not just keywords. Keywords, sender patterns, and examples sharpen it.

Once saved, your custom category behaves like any other: it can drive rule conditions and appears in your metrics.

Discover: suggested categories​

The Discover tab asks the AI to look at a sample of your recent inbox and propose new categories you don't have yet. Each suggestion comes with evidence — example emails, the patterns it noticed, and the domains involved — so you can judge it before accepting.

Usage limits apply

Discover runs analyze a batch of emails and are subject to monthly run limits and a cooldown between runs (shown in the tab). Limits depend on your plan.

Optimizations: learning from corrections​

When you correct a classification — for example, recategorizing an email — MailPrism remembers it. The Optimizations tab scans your correction history for repeating patterns and suggests concrete improvements, such as adding a keyword or sender pattern to a category.

For each suggestion you can Apply it (the change is made to the category) or Dismiss it. Use Find Patterns / Refresh to re-scan.

A few corrections are needed first

The system needs at least a handful of similar corrections before a reliable pattern emerges — so suggestions appear once you've given it something to learn from.

History​

The History tab lists your past corrections. This is the raw material the Optimizations tab learns from, and it's where corrections can be reviewed.

Metrics​

The Metrics tab shows how the classifications are performing:

  • Accuracy rate, emails classified, average confidence, and corrections this month at a glance.
  • A confusion view showing which categories get mixed up with which.
  • A weekly accuracy trend.
  • Accuracy by category, with an up/down trend arrow per category.

The more you correct, the better these numbers get — your feedback feeds directly back into the AI's accuracy.

→ Next: Smart rules · Classification signals