A structured, beginner-friendly course designed for anyone new to budgeting apps to understand Actual's two budgeting workflows and choose the one that fits their needs.
9 lessons5-8 min lessonsConcept-first teachingNo prior knowledge needed
Based on the official Actual docs so the tutorial stays close to the original source.
Lesson 01 of 09⏱ 5 min
Welcome — Start Simple
Actual Budget is a private, open-source, local-first finance app. This lesson explains what it is, why it's worth your time, and exactly how this course is structured so you always know where you are.
🎯 By the end of this lesson you will…
Know what Actual Budget is and what problem it solves
Understand the idea of an Actual budget file
Know the difference between the Desktop Application and a Self-Hosted / Cloud Server
Have a clear map for the rest of the course
Concept
What makes Actual Budget different?
Most budgeting apps are cloud services - your bank details and transaction history live on a company's servers. Actual is different because it is local-first, open-source, and does not require a mandatory hosted service. You can keep your budget on your own device, or run a server you control when you need sync and multi-device access.
Actual is free and open-source. You can run it as a desktop app on your own computer for the quickest start, on a home server, or through a simple provider like PikaPods for a few dollars a month. When you use a server, the web interface works in your browser and on your phone, and sync becomes easier.
In Actual this looks like…
When you first open Actual, you create a "budget file." Everything - your accounts, transactions, categories, and reports - lives in that file. It can stay local on your device, or sync across devices when you use a server. If you ever want to stop using Actual, you export your data and you own it completely.
Installation
Installation: choose one of two paths
Actual has two parts: the client, which is the app you use, and the server, which adds sync, Bank Sync, browser access, and API access. The Desktop Application is the easiest way to start; a self-hosted or cloud server is better when you want Actual available across devices.
Desktop Application (with Optional Local Server)
Easiest starting point for most beginners: download the desktop app for Windows or Mac, create a budget, and start without Docker, hosting, or cloud setup.
Good for learning Actual and getting started quickly
Works offline and supports budget file export/import
Can optionally run a local server to enable Bank Sync.
Limit: you cannot access the app remotely or from your phone
Self-Hosted / Cloud Server
Best long-term setup for reliable remote web access from your phone, browser, or anywhere. You can self-host it, or use a hosted option such as PikaPods.
Practical takeaway: start with the desktop app if you want the easiest setup. Learn Actual locally first, then move your budget later to a self-hosted or cloud server by exporting and importing your budget file. Choose a server when you need reliable access from multiple devices, Bank Sync where supported, or API access. If you do not want to use the command line, PikaPods is the simplest hosted option.
Concept
What does a budgeting app actually do for you?
A budgeting app does not magically fix everything, but it gives you clarity. It helps you answer two important questions: where did my money go, and can I afford this with confidence?
In Actual, you do this through accounts, transactions, categories, and your monthly budget. Do not worry if those words are new; each one has its own lesson in this course.
In Actual this looks like…
You add your accounts, record or import transactions, then assign each transaction to a category like Groceries or Rent. After that, the budget page and reports start showing the real picture of your spending.
Your Path
How this course is structured
This is a short 9-lesson course. The goal is not to memorize everything; it is to build your budget step by step without big jumps.
01–02
Foundation — What Actual is, the two budget modes, and which workflow fits you.
03–05
Core Setup — Build your budget, add accounts, and understand credit cards.
06–07
Daily Use — Handle transactions and use rules to reduce manual work.
08–09
Insights & Improvement — Read reports, then use tips and FAQ to keep improving.
Our recommendation
Read lessons 01 and 02 first to understand the idea. Then go to lesson 03 and start building your actual budget. Do not try to configure every feature at the beginning; you will learn what you need at the right time.
First look
Where Settings lives
You do not need to change anything right now. Just know that Settings is where you will return later to change budgeting mode, date and number formats, and other preferences.
📍Settings — access it from the arrow next to the budget name or from More → Settings in the sidebar.
Official Docs
Read later
Starting Fresh — setting up a new file, accounts, and first categories
Settings — general preferences and budgeting method
Up next - Lesson 02
Two Budgeting Modes: Which One to Start With
Lesson 02 of 09⏱ 7 min
Two Budgeting Modes — Choose Yours
Actual offers two valid budgeting workflows. Envelope is Actual's default and recommended cash-allocation method, while Tracking is a lighter traditional forecast workflow for income and expense targets. Choose the workflow that fits your situation - Lesson 03 will automatically adapt.
🎯 By the end of this lesson you will…
Understand what Tracking Budget mode is and how it works
Understand what Envelope (zero-sum) mode is and how it works
Choose the mode that fits your need for control or awareness
Know how to activate your chosen mode in Settings
📊
Tracking Budget
Lower-maintenance planning and awareness
Set monthly targets for expected income and expected expenses, then compare reality against the plan. This workflow does not require you to account for every available dollar or fund every overspend from another category.
✓ Good when you already have a comfortable cash buffer
✓ Shows variance from target; does not reserve available cash
✓ Funds do not automatically roll over month to month
✓ Your chosen mode — lighter planning and awareness
📦
Envelope Budget (Zero-Sum)
Actual default and recommended cash-control method
Budget only money you actually have. When income arrives it becomes Available Funds, then you assign it to expense and saving categories or hold it for next month.
✓ Shows whether you can afford spending before it happens
✓ Every dollar is assigned or intentionally held for next month
✓ Overspending requires funding or affects next month's To Budget
✓ Your chosen mode — Actual default
Side by Side
Full Comparison
Topic
📊 Tracking Budget
📦 Envelope Budget
Planning basis
Forecast: expected income and expected expense targets
Available cash: money you actually have now
Income
You budget expected income for the month
Income becomes Available Funds only when received
Expenses and savings
You set targets for what you expect to spend or save
You assign available money to expense and saving categories
Overspending
Variance from target. Increasing the amount updates the forecast and lowers Projected Savings; it does not move real cash
Funding decision. Move money from another category, or let overspending reduce next month's To Budget
Rollover
Funds do not automatically roll over month to month
Category balances roll forward, and Hold for Next Month can reserve money you do not want to use now
Best for
People with a comfortable cash buffer who want spending awareness and income/expense targets with lower maintenance
People who need cash control and a clear answer to: can I afford this spending?
📦
You've chosen Envelope Budget. This is Actual's default and recommended method for controlling available cash. Head to Lesson 03 to see how it works.
Action Required
How to enable Tracking Budget mode in the app
Actual starts in Envelope mode by default. If you choose Tracking as your income-and-expense forecast workflow, change this setting before building the budget. You can change modes later, but do not use switching as the main plan because historical budget values do not always carry the same meaning between modes.
📍Settings → click "Switch to tracking budgeting." Do this before entering budget numbers so you start with the right workflow.
1
Open Settings
Click the arrow next to the budget name, or go to More → Settings in the sidebar.
2
Click "Switch to tracking budgeting"
It's near the top of the Budget section in Settings.
✓
Done — the budget view updates immediately
The columns change from "To Budget / Available" to "Budgeted / Spent / Balance."
This is where you learn how the budget page works in each workflow. Use the toggle below to compare, but choose one mode in the app based on your needs.
🎯 By the end of this lesson you will…
Understand how categories organize your budget
Know how Envelope Budgeting uses To Budget
Know how Tracking Budgeting uses monthly targets
Understand what overspending means in each mode
Design a simple starting category structure
Concept
Categories: the buckets your money flows into
Every budget-impacting non-transfer transaction should be assigned to a category. Categories are how Actual knows what your money was spent on - without them, you have a list of transactions with less meaning. This applies to both modes.
Actual lets you group categories - "Groceries" and "Eating Out" can both sit inside a "Food" group. This keeps the budget page readable and lets you see group-level totals at a glance.
In Actual this looks like…
On the Budget page, the left column is a list of your category groups, each expandable. You set a "Budgeted" amount next to each category. As transactions come in and are categorized, the columns update automatically.
The core of Envelope Budgeting
"To Budget": decide what to do with available money
In Envelope Budget, you do not budget projected income. When income actually arrives, it becomes Available Funds. Then you decide: assign it to expense and saving categories this month, or hold part of it for next month with Hold for Next Month.
Step by step
Click the Budgeted column next to each expense or saving category and enter an amount. Start with essentials like rent, food, and bills. If money remains that you do not want to use this month, you can hold it for next month. The practical goal is for To Budget to reach zero because every dollar has a clear decision.
Budget — March 2025 (Envelope Mode) · To Budget: $0 ✓
CategoryBudgetedSpentBalance
🏠 Housing
Rent$1,500$1,500$0
Electricity$120$98$22
🍽️ Food
Groceries$500$412$88
Eating Out$200$243−$43 ⚠
🟢 Savings
Emergency Fund$300$0$300
Concept
The monthly summary: Envelope's scoreboard
At the top of the Envelope Budget page, the summary bar shows what you actually have for this month: Available Funds, anything overspent from last month, what you have Budgeted for this month, and what you chose to Hold for next month. Those numbers roll up into To Budget or Overbudget.
+Available Funds+$1,200what you have to allocate this month
−Overspent Last Month-$43reduces what you can allocate now
−Budgeted for This Month-$900what you assigned to categories this month
−For Next Month-$200money you intentionally held for next month
=
Result: +$57 Remaining To Budget
Above zero = remaining To Budget | Below zero = Overbudget
Example: 1,200 - 43 - 900 - 200 = 57
💡
To hold money for next month, click the To Budget amount and choose Hold for next month. Press Enter to hold all available money, or enter a custom amount. This is optional: you can leave To Budget alone, but held money leaves this month and appears in next month's To Budget.
When a category goes red in Envelope mode
Overspent a category? Cover it now or accept the impact later
This is the heart and power of Envelope mode. When a category is overspent, you have two clear options: move money from another category to cover it, or let the overspending reduce next month's To Budget. This makes the impact visible before it surprises you later.
Eating Out budgeted: $200 Spent: $243 | Balance:−$43
→
Click the red balance "Transfer from category"
→
Take $43 from Entertainment or Clothing, or Savings
→
Eating Out: $0 ✓ Conscious trade-off made
💡
Why is this powerful?Because you're consciously deciding: is eating out worth sacrificing entertainment? That question is what changes spending habits over the long term.
Envelope advantage
Surpluses roll over — building a cushion over time
If you spend less than budgeted in a category, the surplus rolls forward automatically to next month and adds to that category's balance. Over months, categories like "Car Maintenance" build up enough to cover big repairs without any crisis.
✅
The monthly Envelope rhythm:When money arrives, assign available funds to categories or use Hold for Next Month until To Budget reaches zero. Weekly, import and categorize transactions. If a category overspends, fund it from another category or accept its impact on next month. When a new month starts, create a new budget or copy last month's budget and adjust what you learned. At month end, review Reports.
Concept
Categories: the buckets your money flows into
Every budget-impacting non-transfer transaction should be assigned to a category. Categories turn a raw list of transactions into meaningful information. You can group categories (e.g. "Food", "Housing") for better organisation.
💡
Start with 10–15 broad categories. After one month of real data you'll know which need splitting.
The core of Tracking Budgeting
Set monthly targets: your forecast for the month
For each income category (like "Salary"), enter what you expect to receive. For each expense category, enter your spending target. These are forecasts, not contracts. Being wrong is fine - the goal is a baseline you can refine.
How to find good starting numbers:Open 2–3 months of bank statements and estimate your average per category. If unsure, budget generously.
Budget — March 2025 (Tracking Mode)
CategoryBudgetedSpentBalance
🏠 Housing
Rent$1,500$1,500$0
Electricity$120$98$22
🍽️ Food
Groceries$500$412$88
Eating Out$200$243−$43
🟢 Savings
Emergency Fund$300$0$300
Concept
The monthly summary: your budget's scoreboard
At the top of the Tracking Budget page sits a summary bar comparing your budgeted amounts (the plan) against your actual amounts (reality).
Budgeted Income
$4,200
What you planned to receive vs what actually arrived
Budgeted Expenses
$3,650
What you planned to spend vs what you actually spent
Projected Savings
$550
Income − Expenses. Your planned surplus.
Practical
When a category goes red in Tracking mode
Red means variance from the target you planned, not a cash envelope that must be refilled. You can leave it as a review signal, or adjust the target if the original forecast was unrealistic.
Eating Out budgeted: $200 Spent: $243 | Balance:−$43
→
Review the $43 variance
→
Leave as signal or update the target
→
If you raise the target Projected Savings drops
✅
Changing the number in Tracking mode updates the forecast only.Projected Savings will decrease, but no real cash is reserved or moved from another category. If you need to know whether money is available before spending, that is Envelope mode's job.
Habit
The monthly Tracking mode rhythm
1
Start of month: copy last month's budget
Click the copy icon at the top of the budget columns. Adjust anything you know will be different.
2
Weekly: import and categorize transactions
Set aside 10 minutes. Rules will automate most of this after a few weeks.
3
As needed: review red variances
Decide whether the target was unrealistic and should be updated, or whether spending needs to come down for the rest of this month or next month.
4
Month end: review Reports
The Spending report shows which categories consistently run over. Use this data to set better targets next month.
Practical
Designing your categories — a starting framework
The right categories are personal, but here's a framework that works for most people. Start broad and refine. Fewer categories is better to start - you can always split later.
🔴 Fixed Essentials
Bills that are the same every month and non-negotiable.
Rent or Mortgage
Insurance (health, car, home)
Internet & Phone
Electricity / Gas / Water
🟡 Variable Daily Spending
Spending that fluctuates but happens every month.
Groceries
Eating Out / Restaurants
Fuel / Transport
Personal Care & Clothing
🔵 Subscriptions
Recurring charges you may not notice day-to-day.
Streaming (Netflix, Spotify)
Software / Apps
Gym / Memberships
🟢 Savings Goals
Money you're deliberately setting aside.
Emergency Fund
Vacation
Car / Home Repair Fund
💡
Don't spend more than 10 minutes on categories before you have real transaction data. Set up something reasonable now, then refine it after your first import.
💡
Returns and reimbursements: If a store refunds a purchase, categorize the refund back to the original spending category instead of treating it as new income. For reimbursements from another person, check the official docs for the right workflow depending on whether you fronted the money.
Accounts — Adding and Managing Where Your Money Lives
Actual needs to know about the accounts you spend from, and you can also add other accounts for net worth. This lesson focuses on where money lives: On Budget vs Off Budget accounts, common account types, how to add them, and how to record transfers between your own accounts.
🎯 By the end of this lesson you will…
Know the difference between On Budget and Off Budget accounts
Know how to add all your accounts with the right settings
Choose the right account type: checking, savings, cash, credit card, or tracking
Understand transfers between your own accounts and when they need a category
Concept
On Budget vs Off Budget: choose the right account role
Actual makes a distinction between accounts that affect your monthly budget and accounts that are only tracked for net worth. Before adding any account, ask: should spending from this account affect my budget, or do I only want to track its value?
That decision determines whether the account should be On Budget or Off Budget. Everyday spending accounts are usually On Budget, while investments, loans, and large assets are usually Off Budget because they are for tracking only.
✅ On Budget — affects your monthly budget
Use this for accounts you spend from or use to pay expenses. Transactions in these accounts are categorized and appear in your budget and reports.
Checking / current account
Savings used for near-term spending
Cash wallet
Active credit card
📊 Off Budget — tracking and net worth only
Use this for accounts or assets you want to include in net worth, but not for day-to-day category spending.
Investments / brokerage
Retirement or long-term savings
Loans and mortgage balances
Property or car value
🚫
You cannot change an Off Budget account to On Budget later. Always double-check this setting. Use On Budget for any active credit card; only consider Off Budget if there will be no new purchases and the card will be closed after payoff.
Action
Adding your accounts
When you first open Actual, a large Add Account button is shown in the centre of the screen. Clicking it starts a simple wizard. You can add more accounts at any time using + Add account at the bottom of the sidebar.
For each account, enter the current balance shown in your bank's app. Start from the beginning of the current month, or another recent date, instead of going far back in history. That balance becomes the opening transaction in Actual.
📍The Add Account button — shown prominently when you first open Actual, or available in the sidebar at any time.
📍The account creation dialog — choose a name, account type, whether it's On or Off Budget, and enter the current balance from your bank's app.
📍A completed account form — clear name, correct type, On Budget selected for a checking account.
📍Once created, accounts appear in the left sidebar. On Budget accounts show at the top; Off Budget at the bottom.
Concept
Transfers: moving money between your own accounts
When you move money between two accounts you own - checking to savings, or paying a credit card - use a Transfer instead of a normal transaction. If both accounts are On Budget, it does not need a category because the money stays inside your budget. If one side is Off Budget, the On Budget side needs a category.
In Actual this looks like…
In the Payee field, click Make Transfer and choose the destination account. Actual automatically creates matching entries in both accounts - a debit in one, a credit in the other. They're linked: editing one updates the other.
📍Click "Make Transfer" in the payee dropdown to see your accounts and choose the destination.
📍A completed transfer — both entries are linked. Updating the note in one automatically updates the other.
Transfers
When do I categorize a transfer?
A transfer means moving money between your own accounts. The category rule depends on the account types: are both accounts On Budget, or is one of them Off Budget?
Transfer
Category?
Why
On Budget → On Budget
No category
Money stays inside the budget; only the account changes.
On Budget → Off Budget
Yes — On Budget side
Money leaves the budget, so categorize the purpose.
Off Budget → On Budget
Yes — On Budget side
Money enters the budget, so categorize the source/context.
Off Budget → Off Budget
No budget category
Both accounts are outside the budget; no category is affected.
Transfers — transfers between accounts and transfer categories
Up next - Lesson 05
Credit Cards: The Part Everyone Gets Wrong
Lesson 05 of 09⏱ 6 min
Credit Cards: The Part Everyone Gets Wrong
More questions are asked about credit cards in Actual than any other topic. This lesson explains the underlying concept first, then walks through a complete worked example so there are no surprises.
🎯 By the end of this lesson you will…
Understand how Actual treats credit cards (the core concept)
Know what happens to your budget when you swipe the card
Know how to record credit card payments correctly
Understand what to do if you carry a balance
Core Concept
The mental model: credit cards hold negative dollars
In Actual, a credit card is just another account - but it holds negative money. When you create the account, its balance is negative (what you currently owe). As you make purchases, the balance gets more negative. When you pay the card, positive dollars from your checking account cancel out the negative ones.
The most important thing to understand: your budget categories are updated at the moment of purchase, not when you pay the bill. When you buy $50 of groceries on your Visa, your Groceries category decreases by $50 immediately. Paying the card later is just accounting - moving money between accounts.
Why this is better than how you might be thinking about it
Some people think of credit card spending as "not real money yet" until the bill arrives. Actual disagrees - and rightly so. You've committed to that $50 the moment you bought the groceries. Recording it immediately means your budget always reflects reality, not a month-old picture.
Worked Example
Tracing a purchase end to end
Let's trace exactly what happens when you spend $50 on groceries with your credit card, then pay the card at month end.
Step 1: You buy $50 of groceries on your Visa
Groceries category −$50 immediately
+
Visa account −$50 more owed
Your Groceries budget reduced by $50 right now. The Visa account records that you owe $50 more.
Step 2: At month end, you pay $50 to Visa from Checking
Checking −$50
+
Visa +$50 less owed
=
Budget categories unchanged ✓
This is a Transfer - no category needed. Your budget was already updated at purchase time. Paying the card is just two accounts settling up.
Step by Step
Paying in full each month — the full workflow
1
Add your credit card as an On Budget account
Use On Budget for any active card. Only consider Off Budget if there will be no new purchases and the card will be closed after payoff. Enter the current balance you owe as a negative number.
2
Make purchases — categorize each one when it appears
Each purchase is recorded against the relevant category. In Envelope mode it affects the category's available balance; in Tracking mode it appears as actual spending against the planned target.
3
When your statement arrives, reconcile the card account
Click the 🔒 lock icon → enter the statement balance → confirm each transaction. This catches anything that might be missing.
4
Record the payment as a Transfer
In your Checking account, add a transaction. Set Payee to "Transfer to [Card Name]" and enter the statement amount. No category needed.
📍End-of-month budget — every card purchase has been categorized. No category is overspent, so the full statement can be paid.
📍After the Transfer payment — the card balance moves back towards zero. Budget categories unchanged.
📍The budget after payment — identical to before the payment. This confirms the concept: spending was recorded at purchase time, not at payment time.
✅
The golden rule: Do not rely on the card balance alone. Watch how card purchases affect your categories: in Envelope mode, make sure the category is funded; in Tracking mode, monitor actual spending against the target.
Edge Case
If you carry a balance (paying minimum payments)
If you can't pay the full statement balance one month, you are carrying debt. This is a more detailed workflow than this lesson, but the big idea in Actual is to separate old debt from newly funded purchases.
Create a "Credit Card Debt" category group, with one debt category per card.
Set those debt categories to Rollover Overspending so the negative card balance is not counted twice.
Categorize the starting balance, interest/fees, and any purchases you will not pay on the next statement to that card's debt category.
Record the actual payment as a Transfer from Checking to the card, and always pay at least the statement minimum.
💡
Because carrying debt has its own monthly steps and payment calculation, follow Actual's original guide: Carrying Debt.
Paying in Full — official example for paying the statement monthly
Carrying Debt — detailed workflow when you cannot pay the full statement
Up next - Lesson 06
Transactions: Getting Data Into Actual
Lesson 06 of 09⏱ 10 min
Transactions: Getting Data Into Actual
Actual is only as useful as the transaction data inside it. This lesson covers how transactions get in, what each row means, splits, payees, tags, filters, duplicates, and reconciliation so your data stays trustworthy.
🎯 By the end of this lesson you will…
Know the main ways to get transactions into Actual
Understand Bank Sync and when to use it
Be able to import a CSV file from your bank
Know how to handle split transactions, duplicates, and reconciliation
Concept
The main ways to get transactions in
Choose based on your bank's capabilities and how much automation you want. Most people end up using File Import as a weekly habit, or Bank Sync if their bank is supported.
🔗 Bank Sync
Connect through a supported provider, then click Bank Sync when you want to fetch new transactions.
Download from your bank, import manually. 5 minutes once a week.
OFX ⭐QFX ⭐CSVQIFCAMT
⭐ OFX/QFX recommended
✏️ Manual Entry
Type each transaction. Useful for cash spending or when other options aren't available.
Account → Add New
💡
Why is OFX better than CSV? OFX files include a unique bank-assigned ID for every transaction. Actual uses this ID to automatically detect duplicates — meaning you can safely import the same time period twice without getting duplicate entries. CSV files don't have this, so duplicate detection is less reliable.
Optional
Connecting Your Bank: Bank Sync
Bank Sync is optional. If your bank and regional provider are supported, you can connect the account and click Bank Sync to fetch new transactions. It does not remove the need to review: you still categorize transactions, check Rules, and reconcile accounts.
When it fits
You use the desktop app with its local server, or an actual-server setup
Your bank is supported through SimpleFIN, Pluggy.ai, or GoCardless for existing users
You want a faster weekly routine than downloading files manually
What to watch
Start with a recent opening balance; avoid unnecessary old history
Bank sync credentials are stored on the local server or the server you use
Sync is not fully automatic; you click Bank Sync when needed
💡
For a calmer start, create the account with a correct balance on a recent date, then enable Bank Sync. Reconciliation is easier when only new transactions arrive after your start point.
Step by Step
Importing a CSV file from your bank
1
Log into your bank and download a transaction file
Look under "Transaction History," "Download Statement," or similar. Choose OFX if available; CSV otherwise. Select a date range from the start of this month.
2
In Actual: open the account → click Import → select the file
3
Map CSV columns to Actual's fields
Tell Actual which column in your CSV is the Date, which is the Payee name, and which is the Amount. The live preview shows how Actual will interpret each row.
4
Fix date format if dates look wrong
Try different format options (DD/MM/YYYY vs MM/DD/YYYY). If expenses show as positive numbers, toggle "Flip amount."
5
Click Import
Actual automatically avoids duplicating transactions it has already seen.
📍The CSV import screen — map each column to the right field. The preview shows how Actual will interpret the data before you commit.
Concept
Transaction anatomy: what each row means
Once transactions are inside Actual, your main job is review and cleanup. You do not need to edit everything, but you should understand the key fields so you can categorize, search, and reconcile confidently.
Core fields
Date — when the transaction happened
Account — where the money moved
Payee — merchant, person, or transfer account
Amount — inflow or outflow
Organization fields
Category — where spending appears in the budget
Notes — extra detail or #tags
Cleared — has it appeared at the bank?
Imported Payee — original bank-provided name
💡
Your simple routine: review new transactions, clean the payee when needed, choose the category, then let Rules learn from your decisions.
Concept
Split Transactions: one transaction, multiple categories
Sometimes one bank transaction contains multiple kinds of spending. Example: one supermarket trip includes groceries, household supplies, and a gift. Instead of creating separate transactions, split the transaction into child lines, each with its own category and amount.
📍Split Transaction controls — add split lines, distribute the remainder, or unsplit when needed.
1
Open the transaction's Category and choose Split Transaction
A child row appears under the original transaction.
2
Add split lines as needed
Give each part its own category and amount.
3
Make sure the total equals the original transaction
The child rows must add up to the parent transaction amount.
⚠️
Be careful with bulk editing split transactions. If you need to change one, open the split so you can see each child line clearly.
Practical
Payees, tags, and bulk editing
Three features that make managing transactions much faster once you have real data coming in.
Payees — cleaning up ugly bank names
Banks give payees names like TARGET DEBIT CRD ACH TRAN CO ID:XXX15170. From More → Payees, you can rename them, merge duplicates, and set default categories. Actual also learns from your renaming and creates Rules automatically - so you only clean up each payee once.
📍More → Payees: search for all variations of a payee name to merge them into one clean entry.
📍After merging — all variations become one payee. Click the name to rename it to something clean like "Morrisons."
Tags — cross-category labels
Add #hashtags to any transaction's Notes field to group transactions that cross categories. Useful for tracking the real cost of a holiday (flights in Transport, hotels in Accommodation, meals in Eating Out - all tagged #spain2025).
📍Type # in the Notes field to add a tag — you'll see autocomplete for existing tags.
📍The Tags management page (sidebar) — assign colours to tags and view all transactions for any tag.
Bulk editing — update many transactions at once
Check the box on the left of multiple transactions, then use the toolbar to change category, payee, notes, account, or delete them all at once. Use Filters first to narrow down to exactly what you want to change.
⚠️
Bulk editing doesn't work well with split transactions. Avoid selecting split transactions when using bulk actions.
Practical
Filtering transactions
The Filter button above any transaction list lets you narrow what you see using multiple stacked conditions. This is far more powerful than text search - you can combine date ranges, categories, amounts, payees, and tags.
📍The Filter dropdown — choose from date, category, payee, amount, account, notes, and tags. Combine as many as you need.
📍Multiple stacked filters — here filtering by a #tag + category + year to find the total cost of running a specific car in 2024.
📍Save filters you use regularly — click "Unsaved filter" → "Save new filter" to give it a name.
Concept
Handling duplicates
If you enter a transaction manually and then later import the same one from your bank, you'll have a duplicate. Actual gives you a way to merge them cleanly.
In Actual this looks like…
Select both duplicate transactions, then press G or use the dropdown → Merge. Actual keeps the more reliable version (bank-synced wins over imported, imported wins over manual) and copies any missing information (category, notes) from the dropped one to the kept one.
📍Select two matching transactions and press G — Actual merges them into one, keeping the most reliable version.
Routine
Reconciliation: verifying your records against your bank
Reconciliation is the habit of comparing Actual's transaction list to your official bank statement and confirming they match. It catches missing transactions, accidental duplicates, and amounts you may have mistyped.
In Actual this looks like…
Click the 🔒 lock icon in the top-right of any account. Enter your current bank balance, then click Reconcile. Actual shows you a "Difference" number. Go through transactions ticking the ones that appear on your statement (grey circle = unconfirmed, green = confirmed). When Difference reaches $0, click Lock transactions to lock the matched transactions.
📍Click the green balance in the account header to see Cleared vs Uncleared totals — helps you know where the discrepancy is before you start reconciling.
💡
You don't need to reconcile every day. Once a month is fine for most people — just make sure you do it at least monthly if you import transactions manually.
Reconciliation — matching accounts and locking transactions
Transfers — important when importing both sides of a transfer
Up next - Lesson 07
Rules & Automation: Let Actual Do the Work For You
Lesson 07 of 09⏱ 7 min
Rules & Automation: Let Actual Do the Work For You
Once your transactions are coming in and getting cleaned up correctly, use Rules and Schedules to reduce repetitive work. Rules clean and categorize imported transactions, while Schedules help you see recurring and expected transactions before they happen.
🎯 By the end of this lesson you will…
Understand what rules are and how they work
Know how Actual creates rules automatically from your behaviour
Know how to view, edit, and create rules manually
Understand rule stages and how Schedules support automation
Concept
What a rule is: an "if → then" instruction
Every time a transaction is imported, Actual runs it through all your rules in order. A rule has two parts: conditions (when to fire) and actions (what to change). If all conditions match, all actions are applied.
The most common use is cleaning up ugly payee names and setting categories automatically. For example:
If all these conditions are true…
Imported payeecontains"amazon"
Then apply these actions…
Set Payee→Amazon
Set Category→Shopping
This turns AMAZON.COM*5C7QC7MH0 AM 10/26 into "Amazon / Shopping" every single time - automatically.
The Good News
Actual writes most rules for you automatically
You don't need to build your rule library from scratch. Actual watches your behaviour and creates rules based on what you do:
A
When you rename a payee
Actual asks: "Apply this rename automatically in future?" Click yes and it creates a pre-stage rule. That ugly bank name will never appear again.
B
When you categorize a transaction
After you assign the same payee to a category a couple of times, Actual creates a rule to apply that category automatically going forward. After a few weeks of use, most transactions categorize themselves on import.
✨
The payoff: After a month or two of regular use, importing a week's worth of transactions takes about 2 minutes — Actual cleans up the names, assigns categories, and you just review and confirm. This is what makes the system sustainable long-term.
Reference
Condition types and available fields
Condition
What it matches
Example
is
Exact match (case-insensitive)
Payee is "Kroger"
contains
Partial text match
Payee contains "uber"
one of
Matches any item in a list
Payee one of [Netflix, Hulu]
matches
Regular expression (advanced)
Complex patterns
> / <
Amount comparisons
Amount > $500
Conditions can check: imported payee, payee, account, category, date, notes, amount (inflow or outflow). All string matching is case-insensitive.
Actions can set: payee, category, notes, account, date, amount, cleared status. They can also append or prepend text to notes.
Practical
Rule stages: controlling the order
Rules run in three stages. Knowing this prevents confusion when multiple rules affect the same transaction.
pre
Pre-stage runs first, always. Actual automatically puts payee-renaming rules here. This ensures payee names are cleaned up before any categorization rules run.
default
Default-stage is where most rules live. Within this stage, more specific rules (using is) automatically rank after broader ones (using contains), so the specific rule always wins.
post
Post-stage runs last, always. Use this for rules that must override everything else. Most users never need this.
Action
Viewing and managing your rules
1
Go to More → Rules in the sidebar
See all your rules, including the ones Actual created automatically for you.
2
Click "edit" on any rule to view it in detail
The editor shows a live list of existing transactions that match your conditions — excellent feedback before saving.
3
Select transactions and click "Apply actions" to backfill
Retroactively apply a rule to past transactions — great for re-categorizing a batch of old records in one click.
💡
The rule editor is also a powerful bulk editor. Create a temporary rule with conditions that match what you want to change, apply actions to selected transactions, then delete the rule. Much faster than editing transactions one by one.
Planning
Schedules: recurring and expected transactions
Schedules help you see upcoming transactions before they happen: salary, rent, subscriptions, loan payments, or credit card autopay. They can be recurring or one-time, and can be entered automatically or left for manual approval.
📍Schedules overview — recurring or expected transactions appear here so you can see what is coming before it happens.
Use them for
Recurring income like salary
Bills, subscriptions, and loan payments
Credit card autopay
Approximate variable bills like utilities
Why they help
Show upcoming items in the account before payment date
Reduce manual entry for recurring transactions
Can be linked with Rules for categories and notes
Help you avoid surprise bills
💡
Start with only three or four schedules: salary, rent, key subscriptions, and card autopay if you use it. Add more when you notice a recurring pattern.
Official Docs
Read later
Rules — conditions, fields, stages, and automatic rules
Rules Examples — custom rules and Bank Sync transfer examples
Reports: Understanding What Your Data Is Telling You
Lesson 08 of 09⏱ 6 min
Reports: What Your Data Is Telling You
Reports turn your categorized transactions into honest insights about your financial life. After a month or two of real data, this becomes the most valuable part of Actual.
🎯 By the end of this lesson you will…
Know which reports and cards Actual provides
Know when to use Cash Flow, Net Worth, and Spending Analysis
Know when Calendar cards and Custom Reports are useful
Understand the experimental reports at a high level
Concept
The Reports dashboard: your financial mirror
The Reports section is separate from the budget page. Where the budget page tells you what you planned to spend, Reports tell you what actually happened. After even a month of use, the reports reveal things about your spending that will surprise you.
📍The Reports Dashboard — multiple widgets give you a complete financial overview. The dashboard is fully customizable; you can add, remove, and resize widgets.
💡
Small addition: besides the graphs and reports below, the Reports dashboard can also include Summary cards for a quick number and Text widgets for notes or reminders on the dashboard.
Report 1
Cash Flow: "Did I save money this month?"
Cash Flow only looks at On Budget accounts, showing their balance over time along with separate income and expense visualizations. It gives you a picture of how income and spending affected your available money.
📍Cash Flow — focuses on budgeted accounts, meaning money available for your budget.
How to use this report
In Tracking mode, compare cash flow against your Projected Savings. If Projected Savings said $550 but cash flow shows $200 growth, somewhere $350 went uncategorized or was undercounted. This nudges you to investigate.
Report 2
Net Worth: "Am I building wealth?"
Net worth is everything you own minus everything you owe - cash, investments, property equity, minus debts, mortgages, and loans. It's the single most important number in your financial life, and it should trend upward over time.
📍Net Worth over time — includes all accounts (On Budget and Off Budget). Add your mortgage and investment accounts as Off Budget accounts to see the full picture.
Report 3
Spending Analysis: expense trends over time
Spending Analysis tracks and compares your expenses over a selected period. Use it to see trends, fluctuations, and areas of high spending or savings - not just the single biggest category you spent on.
📍Spending Analysis — compare expenses across a selected period to spot trends, fluctuations, and areas of high spending or savings.
How to use this report for better budgeting
After 2–3 months, use this report to ask: which expenses are rising, fluctuating, or showing a savings opportunity? Use that insight to refine Tracking mode targets or adjust Envelope mode category funding.
Calendar card
Calendar card: income and expenses by day
The Calendar card displays daily income and expenses in a calendar format for a selected period. Use it to spot payday, rent, subscriptions, or any days that are unusually heavy on the budget.
📍Calendar card — a quick daily view of income and expenses.
Action
Custom Reports: when the question is specific
Custom Reports let you analyze transactions as a table or chart: Bar, Line, Area, Donut, or Table. You can analyze Payments, Deposits, or Net, split results by category, group, payee, account, or month, and save the report back to the Reports page.
📍Custom report examples — bar, line, area, donut, and table views. Build once, save to the dashboard.
💡
Tip: Combine custom reports with tags for powerful specific analysis. Tag all holiday spending with #holiday2025, then build a custom report filtered to that tag — instant holiday budget summary across all categories and accounts.
Experimental
Experimental Reports: advanced reports for later
These reports are experimental, so they may have bugs, missing functionality, or change later. Do not start here in your first month; read about them when your data is more mature and you want deeper analysis.
Crossover Point report
A financial-planning report inspired by Your Money or Your Life. It estimates when passive investment income may cover projected expenses using expense categories, income or investment accounts, a safe withdrawal rate, and an expense projection method.
Budget Analysis report
Tracks Budget page numbers over time: Budgeted, Spent, Overspending Adjustment, and cumulative Balance. It includes budget categories only, not transfers or Off Budget accounts.
Official Docs
Read later
Cash Flow graph — budgeted accounts and available-money movement
You've completed the core course. This final lesson covers power user shortcuts, answers the most common questions, and gives you a clear framework for choosing the budgeting workflow that fits you long term.
🎯 By the end of this lesson you will…
Know a simple weekly habit to keep your numbers trustworthy
Have answers to the most common beginner questions
Have a clear framework for choosing between Tracking and Envelope
Know where to go when you have questions beyond this course
Keep Simple
Keep Actual Simple: Your Weekly Rhythm
The goal is not to build a perfect system. The goal is to keep your numbers trustworthy enough to make better spending decisions. A simple weekly habit is better than a complex setup you stop using.
Do
Weekly habit
Avoid
Beginner traps
Creating too many categories on day one.
Using Tracking mode when you actually need cash control.
Categorizing credit card payments when both accounts are On Budget.
Ignoring uncategorized transactions for too long.
Judging reports before you have a full month of data.
💡
Simple rule: if you open Actual once a week and clean up uncategorized transactions, transfers, and overspending, the budget stays useful without becoming a daily burden.
Decision Framework
Which budgeting workflow fits you long term?
Do not treat Tracking and Envelope as two steps in one graduation path. Both are valid, but they answer different questions: do you want to compare plan vs reality, or control available cash before spending?
📊 Tracking fits if…
You have a comfortable cash buffer and are not worried about running out of cash before month end
You want income and expense targets, then a clear plan-vs-reality comparison
You prefer lower maintenance and do not want to continually assign every available dollar
You are comfortable treating red values as target variance, not a cash-funding decision
📦 Envelope fits if…
You need cash control and want to know whether you can afford spending before it happens
You want every dollar to have a clear decision: assigned now or held for next month
You want overspending to force a funding choice or reduce next month's To Budget
You are comfortable maintaining the budget during the month, not only reviewing it afterward
🧭
The practical decision: there is no required graduation path from Tracking to Envelope. Choose based on your need for control and the maintenance level you accept. You can change modes later, but do not rely on switching as the learning plan because historical budget values do not always carry the same meaning between modes.
Reference
Keyboard shortcuts and power features
This is not the full official shortcut list; it is the useful daily set. Open ? inside Actual whenever you need the complete list. On macOS, use Cmd+K for the Command Palette.
Where
Shortcut
What it does
General
Ctrl+K / Cmd+K
Open the Command Palette to search commands and jump to accounts
General
?
Open the Help Menu with docs, support, and the full shortcut list
General
Ctrl+P
Toggle the Privacy Filter to hide amounts on screen
General
Ctrl+Z / Ctrl+Shift+Z
Undo or redo changes in the current session
Account page
Ctrl+I
Import transactions into the current account
Account page
Ctrl+B
Initiate Bank Sync when the account is connected
Account page
T
Add a new transaction with the date picker open
Account page
F
Open Filter when none are selected, or show only selected transactions
Editing
Enter / Shift+Enter
While editing: save the value and move down or up
Editing
Tab / Shift+Tab
While editing: save the value and move right or left
Selected transactions
C
Set category for selected transactions
Selected transactions
L
Toggle cleared status for selected transactions
Selected transactions
S
Link or view schedule for the selected transaction
Selected transactions
G
Merge two selected transactions when their amounts are equal
Some bulk-action shortcuts require one or more transactions to be selected first. If a shortcut does nothing, select the transaction and try again.
⌘
macOS note: the docs list Cmd+K for Command Palette on macOS. Other shortcuts may depend on browser/app behavior, so use ? inside Actual to confirm what is available in your setup.
Optional but Important
Operational topics you will need later
These are not part of your daily routine, but they matter once Actual becomes your real financial system. Know they exist now, and come back when needed.
Backup & Restore
Before major updates or trying new features, export a backup from Settings. It is not a daily task, but it is an important safety net.
Syncing Across Devices
The desktop app runs locally without an external server, which is fine for getting started. But if you want phone access or multiple devices, a sync server is the better experience. Sync is not a full replacement for backups.
Multi-Currency
Actual does not currently support native multi-currency. If you have accounts in multiple currencies, read the docs before adding them so you choose the right workaround.
Advanced
Experimental Features: use carefully
Experimental features are optional tools that are still being developed. They may be incomplete, change later, or be removed. Do not make them the foundation of your beginner workflow.
1
Use Actual normally first
Settle accounts, categories, importing, Rules, and reconciliation before enabling experiments.
2
Make a backup before enabling
This matters especially before trying Budget Templates or Rule Action Templating.
3
Enable one feature at a time
Understand its effect on your budget before adding another one.
💡
Most useful later: Budget Templates for filling budget amounts, Rule Action Templating for advanced rules, and experimental reports for deeper analysis.
FAQ
Common questions answered
Q: Do I have to categorize every single transaction?
A: Yes - in both modes, every budget-impacting non-transfer transaction needs a category. Off Budget transactions are not categorized, and transfers between On Budget accounts do not need categories. Categories make reports useful and keep the budget working. The good news: Rules handle most categorization automatically after a few weeks.
Q: In Tracking mode, do unused budget amounts carry over to next month?
A: No. This is a fundamental difference from Envelope mode. In Tracking mode, each month starts fresh - you set new targets each month (or copy last month's with one click). In Envelope mode, leftover money in categories rolls forward automatically and builds up over time.
Q: Can I sync my bank?
A: Yes, if your setup and provider are supported. Actual supports SimpleFIN for North America, Pluggy.ai for Brazil, and GoCardless BankAccountData for existing EU/UK users. Bank Sync works with the desktop app through its bundled local server, or with an actual-server setup, and you click Bank Sync manually to fetch new transactions. Provider credentials are stored on the local server or the server you use.
Q: Is there a mobile app?
A: The dedicated mobile apps are no longer maintained. Use Actual in your phone's browser - the interface is responsive and works well. On iOS, tap Share → "Add to Home Screen" for a full-screen app experience. On Android, use "Add to Home Screen" from the browser menu.
Q: What if I overspend a category badly in Tracking mode?
A: Treat it as variance from the target. You can leave the red value as a reminder that the plan did not match reality, or increase the target if the original forecast was unrealistic. If you increase the target, Projected Savings decreases, but no cash is reserved or moved from another category.
Q: How do I update Actual after a new version is released?
A: It depends on how you run Actual. If you use the desktop app, update the app when a new release is available. PikaPods auto-updates around a week after each release. Docker users pull the new image. Fly.io has a specific update guide in the official docs at actualbudget.org/docs.
🎓
Course Complete
You now have everything you need to use Actual Budget confidently. The rest comes from building the weekly habit and letting the data accumulate.