Product guide
Rules
Rules match a bank description to the account it belongs to: how to add them, the fields, and how they are used.
What a rule is
A rule says that a bank transaction whose description matches some text goes to one account, or is split across several. Rules belong to one book. Find them in the sidebar under Rules, or under Settings › Rules & automation.
The fields of a rule
- Keyword: the text to match, such as a merchant name.
- Match type: contains, starts with, exact or regex.
- Direction: money in, money out or either.
- Bank account: one account the rule is limited to, or any bank.
- Account: where a match goes, or the lines of a split.
- Priority: a number from 1 to 1000.
- Active or inactive. Turn a rule off without deleting it.
Add, import and test rules
- Add rule creates one. Bulk import adds many from a file after you review them.
- On Transactions, a categorized transaction offers Remember as a rule, so a choice you make once becomes a rule.
- Test a bank description on the Rules page to see which rule would match it before relying on it.
- Filter the list by status, direction, bank account or account. Each rule shows how often it has matched.
How rules are used
- Your rules run on new transactions when your bank syncs.
- A rule picks the category. The transaction still waits for you to finalize it in the review queue.
- An AI app reads your rules with list_rules and proposes a new one with preview_rule. Applying a previewed rule creates the rule only.