Skip to main content

Custom Categories

The built-in categories cover most inboxes, but yours is unique. In Settings → AI Classifications 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