📖 Beginner's Masterclass

Learn Actual Budget
From Zero

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 lessons 5-8 min lessons Concept-first teaching No 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.

Download the desktop app from GitHub

  • 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.

Run Actual with PikaPods

  • Sync your budget between devices
  • Access Actual from browser or phone browser/PWA
  • Use Bank Sync where supported and configured
  • Use the Actual API and integrations
  • Connect the desktop app to your server
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.

Actual Budget Settings page
📍Settings — access it from the arrow next to the budget name or from More → Settings in the sidebar.
Official Docs

Read later

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
📦
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 basisForecast: expected income and expected expense targetsAvailable cash: money you actually have now
IncomeYou budget expected income for the monthIncome becomes Available Funds only when received
Expenses and savingsYou set targets for what you expect to spend or saveYou assign available money to expense and saving categories
OverspendingVariance from target. Increasing the amount updates the forecast and lowers Projected Savings; it does not move real cashFunding decision. Move money from another category, or let overspending reduce next month's To Budget
RolloverFunds do not automatically roll over month to monthCategory balances roll forward, and Hold for Next Month can reserve money you do not want to use now
Best forPeople with a comfortable cash buffer who want spending awareness and income/expense targets with lower maintenancePeople 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.
Official Docs

Read later

Up next - Lesson 03

Building Your Budget — Envelope Budget
Lesson 03 of 09 ⏱ 8 min

Building Your Budget — Envelope Budget

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,200 what you have to allocate this month
Overspent Last Month -$43 reduces what you can allocate now
Budgeted for This Month -$900 what you assigned to categories this month
For Next Month -$200 money 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.
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.
Official Docs

Read later

Up next - Lesson 04

Accounts: Adding and Managing Your Money
Lesson 04 of 09 ⏱ 6 min

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.

Add Account
📍The Add Account button — shown prominently when you first open Actual, or available in the sidebar at any time.
Create Account dialog
📍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.
Completed account form
📍A completed account form — clear name, correct type, On Budget selected for a checking account.
Accounts in sidebar
📍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.

Make Transfer in payee dropdown
📍Click "Make Transfer" in the payee dropdown to see your accounts and choose the destination.
Completed transfer
📍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.
Official Docs

Read later

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.

Budget with categorized card spending
📍End-of-month budget — every card purchase has been categorized. No category is overspent, so the full statement can be paid.
After paying the card
📍After the Transfer payment — the card balance moves back towards zero. Budget categories unchanged.
Budget after payment
📍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.

💡
Because carrying debt has its own monthly steps and payment calculation, follow Actual's original guide: Carrying Debt.
Official Docs

Read later

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.

SimpleFIN (US/CA) GoCardless (existing EU/UK) Pluggy.ai (BR)
📄 File Import

Download from your bank, import manually. 5 minutes once a week.

OFX ⭐ QFX ⭐ CSV QIF CAMT

⭐ 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.
CSV import screen
📍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 in Actual
📍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.

Searching payees
📍More → Payees: search for all variations of a payee name to merge them into one clean entry.
After merging payees
📍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).

Adding a tag
📍Type # in the Notes field to add a tag — you'll see autocomplete for existing tags.
Tag management page
📍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.

Filter dropdown
📍The Filter dropdown — choose from date, category, payee, amount, account, notes, and tags. Combine as many as you need.
Stacked filters
📍Multiple stacked filters — here filtering by a #tag + category + year to find the total cost of running a specific car in 2024.
Save filter
📍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.

Merge transactions
📍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.

Reconciliation account header
📍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.
Official Docs

Read later

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 PayeeAmazon
Set CategoryShopping

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

ConditionWhat it matchesExample
isExact match (case-insensitive)Payee is "Kroger"
containsPartial text matchPayee contains "uber"
one ofMatches any item in a listPayee one of [Netflix, Hulu]
matchesRegular expression (advanced)Complex patterns
> / <Amount comparisonsAmount > $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 in Actual
📍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

Up next - Lesson 08

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.

Reports Dashboard
📍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 graph
📍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 graph
📍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
📍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
📍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
📍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

Up next - Lesson 09

Tips, FAQ & Your Path Forward
Lesson 09 of 09 ⏱ 7 min

Tips, FAQ & Your Path Forward

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.

WhereShortcutWhat it does
GeneralCtrl+K / Cmd+KOpen the Command Palette to search commands and jump to accounts
General?Open the Help Menu with docs, support, and the full shortcut list
GeneralCtrl+PToggle the Privacy Filter to hide amounts on screen
GeneralCtrl+Z / Ctrl+Shift+ZUndo or redo changes in the current session
Account pageCtrl+IImport transactions into the current account
Account pageCtrl+BInitiate Bank Sync when the account is connected
Account pageTAdd a new transaction with the date picker open
Account pageFOpen Filter when none are selected, or show only selected transactions
EditingEnter / Shift+EnterWhile editing: save the value and move down or up
EditingTab / Shift+TabWhile editing: save the value and move right or left
Selected transactionsCSet category for selected transactions
Selected transactionsLToggle cleared status for selected transactions
Selected transactionsSLink or view schedule for the selected transaction
Selected transactionsGMerge two selected transactions when their amounts are equal

Full official reference: Keyboard Shortcuts.

💡
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.

📖 Full Docs 💬 Community Discord → Envelope Mode Guide
Official Resources

Where to go next