What are assignment rules?
Assignment rules automate the categorization of your transactions. Instead of assigning each transaction manually, you define conditions — and Kontavio takes care of the rest.
Where do I find rules?
Navigate to Settings -> Assignment rules. Here you see all existing rules as cards and can create new ones.
Create a new rule
Define conditions
Every rule needs at least one condition. The following fields and operators are available:
Description:
- contains — Checks whether the transaction text contains a certain term (e.g. "AMAZON"). Not case-sensitive.
- equals — Exact text comparison
- starts with — Checks the beginning of the description
- regex — Regular expression for complex patterns (e.g.
AWS.*Servicesfor various AWS entries)
Amount:
- between — Defines an amount range (e.g. 10–50 EUR). Useful for typical subscription amounts.
- greater than / less than — Simple amount comparisons
Account:
- is — Restricts the rule to a specific bank account
Currency:
- is — Restricts the rule to a specific currency (e.g. only USD transactions)
If multiple conditions are defined, all must match (AND logic). A transaction is only assigned when every single condition is met.
Set actions
When the conditions match, the rule performs the following actions:
- Assign type — Sets the transaction type (Income, Expense, Owner Withdrawal, Internal Transfer)
- Assign category — Assigns a category from the category tree (e.g. "Software & Tools")
- Assign customer — Automatically links an existing customer
- Assign vendor — Automatically links an existing vendor
- Set scope — Marks the transaction as Business or Personal (overrides the account default)
Tip: Start with simple rules that have just one condition (e.g. "Description contains AWS"). Refine them with additional conditions as needed.
Create a rule from a transaction
In the transaction detail dialog you'll find the "Create rule" button. Kontavio automatically uses the description and category of the current transaction as a template. You only need to review and confirm the rule.
This is the fastest way to create new rules — especially when you spot a pattern while categorizing.
Preview and test
Before saving a rule, you can use the preview. It shows you how many existing transactions would match the conditions. This way you avoid unintended assignments.
Manage rules
Activate and deactivate
Each rule card has a toggle to switch it on and off. Deactivated rules are ignored on new transactions but remain stored.
Match counter
On every rule card you see how many transactions the rule has assigned so far. This helps gauge how effective a rule is.
Mind the order
Rules are processed in their priority order. The first matching rule wins — subsequent rules are no longer checked for that transaction. So sort your rules from specific to general.
Automatic application
Rules are applied automatically on:
- New imports: Every CSV import checks all active rules
- Bank sync: Automatically synced transactions go through the rules
- Background sync: Every 6 hours new transactions are checked against rules
Tip: Create specific rules (e.g. "AWS" -> Software & Tools) before general rules (e.g. amount > 1000 -> review). That prevents a broad rule from overriding more specific assignments.