Skip to main content

9 posts tagged with "Financial Reporting"

View all tags

Your Complete Guide to Balance Sheet Templates for Small Business Success

· 9 min read
Mike Thrift
Mike Thrift
Marketing Manager

Every successful business owner needs to understand their company's financial position. Whether you're running a startup, managing a growing small business, or planning for expansion, having a clear view of what you own, what you owe, and your overall net worth is essential for making smart business decisions.

A balance sheet template provides a structured way to organize this critical financial information. In this comprehensive guide, we'll walk you through everything you need to know about balance sheets and how to use them effectively to strengthen your business's financial foundation.

2025-09-15-balance-sheet-templates-for-small-business-success

What Is a Balance Sheet?

A balance sheet is a financial statement that provides a snapshot of your business's financial position at a specific point in time. Think of it as a financial photograph showing three key elements: your assets (what you own), your liabilities (what you owe), and your equity (your stake in the business).

Unlike an income statement that shows performance over a period of time, a balance sheet captures your financial standing at a single moment. This makes it an invaluable tool for understanding your current financial health and making informed decisions about your business's future.

The balance sheet follows a fundamental accounting equation that must always hold true:

Assets = Liabilities + Equity

This equation is the foundation of double-entry bookkeeping and ensures that your financial records remain accurate and balanced.

Understanding the Three Core Components

1. Assets: What Your Business Owns

Assets represent everything of value that your business owns or controls. They're the resources you use to generate revenue and operate your business. Assets are typically divided into two main categories:

Current Assets are resources that can be converted to cash within one year. These include:

  • Cash and cash equivalents: Money in your bank accounts and short-term investments that can be quickly accessed
  • Accounts receivable: Money owed to you by customers for goods or services already delivered
  • Inventory: Products or materials you have on hand for sale or use in production
  • Prepaid expenses: Payments you've made in advance for future benefits, such as insurance premiums or rent

Fixed Assets (also called non-current assets) are long-term resources that provide value over multiple years:

  • Property: Land and buildings owned by your business
  • Equipment: Machinery, computers, tools, and other equipment used in operations
  • Vehicles: Cars, trucks, or other transportation assets
  • Furniture and fixtures: Office furniture, shelving, and permanent installations
  • Intangible assets: Patents, trademarks, copyrights, and goodwill

When recording fixed assets, remember to account for depreciation—the gradual decrease in value over time as these assets are used in your business.

2. Liabilities: What Your Business Owes

Liabilities are your business's financial obligations—debts and payments you owe to others. Like assets, liabilities are categorized based on when they need to be paid:

Current Liabilities are obligations due within one year:

  • Accounts payable: Money you owe to suppliers and vendors for goods or services received
  • Short-term loans: Business loans or lines of credit due within 12 months
  • Credit card balances: Outstanding business credit card debt
  • Accrued expenses: Expenses that have been incurred but not yet paid, such as wages or utilities
  • Tax obligations: Sales tax collected, payroll taxes, and estimated income tax payments due

Long-Term Liabilities extend beyond one year:

  • Mortgages: Loans secured by property or real estate
  • Equipment loans: Financing for major equipment purchases
  • Long-term business loans: Multi-year financing arrangements
  • Deferred tax liabilities: Tax obligations that will be paid in future periods

Managing your liabilities effectively is crucial for maintaining healthy cash flow and building strong relationships with creditors and suppliers.

3. Equity: Your Ownership Stake

Equity represents the owner's interest in the business—essentially, what would remain if you sold all your assets and paid off all your liabilities. It's your business's net worth and includes:

  • Owner's equity or capital: The initial investment you made to start the business
  • Retained earnings: Profits that have been reinvested in the business rather than distributed to owners
  • Additional paid-in capital: Any additional investments made by owners or shareholders
  • Treasury stock: For corporations, shares that have been bought back from shareholders

Your equity grows when your business is profitable and shrinks when you take losses or make distributions. Monitoring equity over time helps you understand whether your business is building or losing value.

Why Balance Sheets Matter for Small Business Success

Track Growth and Progress

Regular balance sheets let you see how your business is evolving over time. By comparing balance sheets from different periods—monthly, quarterly, or annually—you can identify trends, spot opportunities, and catch potential problems early.

Are your assets growing faster than your liabilities? That's a sign of healthy expansion. Is your cash position declining while accounts receivable increases? You might need to improve your collection processes.

Secure Financing and Investment

When you approach banks for loans or pitch to investors, they'll want to see your balance sheet. This financial statement demonstrates your business's stability, creditworthiness, and growth potential. A strong balance sheet with healthy equity and manageable debt levels makes lenders and investors more confident in your ability to succeed.

Make Informed Business Decisions

Should you purchase new equipment or lease it? Can you afford to hire additional staff? Is now the right time to expand into a new location? Your balance sheet provides the financial context needed to answer these questions confidently.

By understanding your current asset position and debt obligations, you can make strategic decisions that support growth without overextending your resources.

Maintain Financial Health

Regular balance sheet review helps you maintain appropriate levels of working capital, manage debt effectively, and ensure you have adequate resources to meet your obligations. It's an early warning system for financial trouble and a guide for maintaining healthy financial ratios.

Simplify Tax Preparation

Having an accurate, up-to-date balance sheet makes tax season significantly less stressful. The information you need for various tax forms and schedules is readily available, organized, and verifiable. This saves time, reduces errors, and can help you identify legitimate tax deductions you might otherwise miss.

How to Create and Maintain Your Balance Sheet

Step 1: List All Your Assets

Start by cataloging everything your business owns. Review your bank statements, inventory records, and fixed asset registers. Include:

  • All bank account balances
  • Outstanding invoices (accounts receivable)
  • Current inventory value
  • Prepaid expenses
  • Value of equipment, vehicles, and property
  • Other investments or assets

Remember to use the current value for assets, accounting for depreciation on fixed assets.

Step 2: Document Your Liabilities

Next, list all amounts your business owes. Check:

  • Outstanding vendor bills (accounts payable)
  • Credit card balances
  • Loan balances
  • Unpaid payroll or taxes
  • Any other debts or obligations

Be thorough—missing liabilities will give you an overly optimistic view of your financial position.

Step 3: Calculate Your Equity

Determine your equity by adding:

  • Your initial investment in the business
  • Any additional capital contributions
  • Retained earnings (cumulative profits kept in the business)

Or use the accounting equation: Equity = Assets - Liabilities

Step 4: Verify the Balance

Confirm that your balance sheet balances using the fundamental equation:

Assets = Liabilities + Equity

If these don't match, review your entries to find any errors or omissions.

Step 5: Update Regularly

Set a schedule for updating your balance sheet—monthly for most small businesses, quarterly at minimum. Regular updates help you spot trends, maintain accuracy, and ensure you're making decisions based on current information rather than outdated data.

Best Practices for Balance Sheet Management

Do:

  • Keep detailed, organized records of all transactions throughout the year
  • Separate personal and business finances completely
  • Update your balance sheet on a consistent schedule
  • Categorize items accurately and consistently
  • Review changes from period to period to understand trends
  • Consider working with a professional bookkeeper or accountant as your business grows
  • Use accounting software to automate calculations and reduce errors

Don't:

  • Mix personal expenses with business finances
  • Forget to record small assets or liabilities—they add up
  • Let your balance sheet go months without updating
  • Guess at values—use actual figures from your records
  • Confuse your balance sheet with your income statement (they serve different purposes)
  • Ignore warning signs like declining cash or increasing debt
  • Overlook depreciation on fixed assets

Common Balance Sheet Mistakes to Avoid

Misclassifying Assets and Liabilities

Putting a long-term loan in current liabilities or listing inventory as a fixed asset throws off your financial ratios and gives an inaccurate picture of your liquidity.

Forgetting Depreciation

Fixed assets lose value over time. Failing to record depreciation means your balance sheet overstates your asset values and equity.

Including Personal Assets

Your personal car, home, or savings accounts shouldn't appear on your business balance sheet unless they're legitimately used for business purposes and properly documented.

Not Reconciling Regularly

Your balance sheet should match your actual bank balances, loan statements, and other financial records. Regular reconciliation catches errors before they become major problems.

Using Your Balance Sheet for Financial Analysis

Once you have an accurate balance sheet, you can calculate important financial ratios that reveal your business's health:

Current Ratio = Current Assets ÷ Current Liabilities

This shows your ability to pay short-term obligations. A ratio above 1.0 means you have more current assets than current liabilities.

Debt-to-Equity Ratio = Total Liabilities ÷ Equity

This indicates how much of your business is financed by debt versus owner investment. Lower ratios generally indicate less financial risk.

Working Capital = Current Assets - Current Liabilities

This shows the cash and liquid assets available for day-to-day operations. Positive working capital is essential for smooth business operations.

Taking Control of Your Financial Future

A well-maintained balance sheet is more than just a compliance requirement or a document for your accountant. It's a powerful tool that gives you clarity about your business's financial position and helps you make confident decisions about growth, investment, and strategy.

By understanding the three core components—assets, liabilities, and equity—and maintaining accurate records, you'll have the insights needed to steer your business toward long-term success. Whether you're seeking funding, planning for expansion, or simply want to understand your business better, your balance sheet is an indispensable guide.

Start by creating your first balance sheet today. Gather your financial records, organize them into the proper categories, and see where your business stands. Then commit to regular updates so you always have current, accurate information at your fingertips.

Your financial success starts with understanding your current position. With a solid balance sheet practice in place, you'll be equipped to navigate challenges, seize opportunities, and build the thriving business you envision.

Accrued Expenses in Beancount: A Practical Guide (with copy-paste ledger examples)

· 8 min read
Mike Thrift
Mike Thrift
Marketing Manager

Accrued expenses sound abstract until month-end closes start piling up. They are a cornerstone of proper accrual accounting, ensuring your financial reports reflect economic reality, not just when cash changes hands. Here’s a clear, Beancount-first walkthrough of what they are, why they matter, and exactly how to book, reverse, and report them in your plain-text ledger.

TL;DR ⚡

  • Accrued expenses are costs you’ve incurred this period but haven’t paid yet. They are recorded as a liability until the cash goes out.
  • In Beancount, this is simple: you debit an Expenses: account and credit a Liabilities:Accrued: account. Later, you clear the liability when you pay.
  • To report, you can see what you owe as of a specific date by running a bean-query with CLOSE ON and CLEAR to get a clean balance-sheet snapshot.

2025-08-24-accrued-expenses-in-beancount-a-practical-guide

What is an Accrued Expense?

An accrued expense is a cost that a business has incurred, but has not yet paid. It's recorded when the service is received or the cost is incurred, even if the invoice hasn't arrived or the payment isn't due yet. This practice follows the matching principle of accrual accounting, which dictates that expenses should be recorded in the same period as the revenues they helped generate.

Common examples include:

  • Wages earned by employees at the end of a month but paid in the next.
  • Utilities (electricity, water) you used in December but won't be billed for until January.
  • Interest on a loan that has accumulated over the month but has not yet been withdrawn from your account.

By recording these costs when they happen, you get a much truer picture of your company's financial performance for that period.

How Beancount Thinks About It (in 30 seconds)

Beancount is a plain-text, double-entry accounting system. Everything is a dated directive or transaction in a text file. The system is built on five core account types: Assets, Liabilities, Equity, Income, and Expenses.

Entries are always ordered by date. A key detail is that balance assertions are checked before same-day transactions are processed. This is important to remember when you place checks and reversing entries.

Finally, the bean-query language provides a powerful, SQL-like way to generate reports. With operators like OPEN ON, CLOSE ON, and CLEAR, you can create precise "as-of" views for financial statements.

Your Chart of Accounts (Suggested)

A clean, hierarchical chart of accounts is your best friend. For accrued expenses, the structure is straightforward. You'll need:

  • An expense account: e.g., Expenses:Utilities, Expenses:Payroll:Wages
  • A corresponding liability account: e.g., Liabilities:Accrued:Utilities, Liabilities:Accrued:Payroll
  • Your cash account: e.g., Assets:Bank:Checking

Beancount enforces the five top-level account types. Keeping your account names organized makes querying and reporting much easier down the road.

The Core Pattern (No Plugin, No Magic)

This is the most direct way to handle accruals in Beancount. It involves two steps: accruing the expense at month-end and clearing the liability when you pay.

Step 1: Accrue the Expense at Month-End

On the last day of the period, you record the expense and create the liability.

2025-02-28 * "Accrue February electricity" #accrual
Expenses:Utilities 120.00 USD
Liabilities:Accrued:Utilities

Step 2: Clear the Accrual When You Pay

When the bill comes and you pay it, you don't hit the expense account again. Instead, you debit the liability account to clear it out.

2025-03-05 * "Pay Feb electricity - City Power"
Liabilities:Accrued:Utilities 120.00 USD
Assets:Bank:Checking

This is the cleanest approach for small teams. It correctly places the expense in February and ensures you don't double-count it in March. Notice that in Beancount, leaving one amount blank lets the system balance the transaction for you automatically.

Alternative: Reversing Entry on Day 1

If you prefer the classic "auto-reverse" accounting style, you can post the opposite of your accrual entry on the first day of the next month. Then, you book the actual vendor bill to the expense account as you normally would.

Step 1: Accrue at Month-End (Same as before)

2025-02-28 * "Accrue February electricity" #accrual
Expenses:Utilities 120.00 USD
Liabilities:Accrued:Utilities

Step 2: Reverse on the First Day of the Next Month

2025-03-01 * "Reverse Feb electricity accrual" #reversal
Liabilities:Accrued:Utilities 120.00 USD
Expenses:Utilities

Step 3: Book the Payment as Usual

2025-03-05 * "City Power - February bill"
Expenses:Utilities 120.00 USD
Assets:Bank:Checking

Heads-up on checks: Remember that balance assertions evaluate before same-day transactions. If you want to check your Liabilities:Accrued:Utilities account balance, place the assertion on 2025-02-28 to confirm the accrual or on 2025-03-01 after the reversal transaction to confirm it's zero. Placing it before the reversal on 2025-03-01 will cause a false failure.

Six Common Accruals (Copy-Paste Patterns) 📋

Here are some ready-to-use examples for common business accruals.

1. Rent Not Yet Invoiced

2025-01-31 * "Accrue January rent" #accrual
Expenses:Rent 3000.00 USD
Liabilities:Accrued:Rent

2. Wages Earned but Unpaid

2025-03-31 * "Accrue March wages" #accrual
Expenses:Payroll:Wages 8500.00 USD
Liabilities:Accrued:Payroll

3. Vacation Pay (PTO) Earned

2025-03-31 * "Accrue PTO earned in March" #accrual
Expenses:Payroll:PTO 900.00 USD
Liabilities:Accrued:Payroll

4. Interest Accrued on a Loan

2025-02-29 * "Accrue monthly loan interest" #accrual
Expenses:Interest 210.00 USD
Liabilities:Accrued:Interest

5. Professional Fees (Audit/Legal)

2025-12-31 * "Accrue year-end audit fees" #accrual
Expenses:Professional:Audit 4200.00 USD
Liabilities:Accrued:Professional

6. Utilities Used but Not Billed

2025-04-30 * "Accrue April utilities" #accrual
Expenses:Utilities 95.00 USD
Liabilities:Accrued:Utilities

Reporting: "What do I owe as of a certain date?"

bean-query is your tool for getting answers. Here’s how you can get a proper balance sheet snapshot of your accrued expenses.

Get All Accrued Liability Balances at Period-End

This query gives you the balance of each accrued liability account as of March 31, 2025.

bean-query main.beancount '
SELECT account, UNITS(SUM(position)) AS balance
FROM OPEN ON 2025-01-01 CLOSE ON 2025-04-01 CLEAR
WHERE account ~ "^Liabilities:Accrued"
GROUP BY 1
ORDER BY 1;
'
  • OPEN ON sets starting balances at the period start.
  • CLOSE ON truncates transactions before this date (it's exclusive). That's why we use 2025-04-01 to get data up to and including 2025-03-31.
  • CLEAR zeroes out Income and Expenses, giving you a clean balance sheet view (Assets, Liabilities, Equity).

See a Register of All Accrual Postings

If you want to see the raw transaction history for your accrual accounts:

bean-query main.beancount '
SELECT date, payee, narration, position
WHERE account ~ "^Liabilities:Accrued"
ORDER BY date;
'

Get a Single Total for All Accruals

For a quick summary of the total amount you owe:

bean-query main.beancount '
SELECT UNITS(SUM(position)) AS total_accruals
FROM OPEN ON 2025-01-01 CLOSE ON 2025-04-01 CLEAR
WHERE account ~ "^Liabilities:Accrued";
'

Controls & "Gotchas" Specific to Beancount

  • Balance Assertions Timing: As mentioned, assertions check the balance at the start of the day. 2025-03-01 balance ... runs before any transactions on 2025-03-01. Plan accordingly.
  • Naming and Hierarchy: A tidy tree like Liabilities:Accrued:* is not just for looks. It makes your queries simpler and your reports instantly understandable.
  • Pad with Caution: The pad directive can fix opening balances, but avoid using it to "fix" recurring accruals. Making explicit entries provides a clear audit trail.
  • As-Of Reporting: For balance-sheet snapshots, always prefer OPEN ... CLOSE ... CLEAR in bean-query. This prevents income and expense accounts from polluting your liability totals.

Prepaid vs. Accrued (Quick Contrast)

It's easy to mix these up. They are mirror images:

  • Accrued Expense: Service consumed now, cash paid later. This creates a liability.
  • Prepaid Expense: Cash paid now, service consumed later. This creates an asset.

The accounting logic is the same in Beancount; only the accounts differ (Assets:Prepaid:* vs. Liabilities:Accrued:*).

Drop-in Template (Start of File)

Here are the open directives you'd need for the examples used in this post. Add these to the top of your ledger file once.

; --- Accounts (open once) ---
2025-01-01 open Assets:Bank:Checking
2025-01-01 open Expenses:Utilities
2025-01-01 open Expenses:Payroll:Wages
2025-01-01 open Expenses:Interest
2025-01-01 open Expenses:Professional:Audit
2025-01-01 open Liabilities:Accrued:Utilities
2025-01-01 open Liabilities:Accrued:Payroll
2025-01-01 open Liabilities:Accrued:Interest
2025-01-01 open Liabilities:Accrued:Professional

Final Notes

If you run your books on a cash basis, you won’t post accruals at all—expenses are simply recorded when they are paid. If you run on an accrual basis, using the patterns above is essential for matching costs to the period where you consumed the service.

The examples here provide general educational guidance. Always consult your CPA for industry-specific treatments, especially regarding bonuses, payroll taxes, and capitalization thresholds.

The Accounting Cycle, Beancount-Style

· 9 min read
Mike Thrift
Mike Thrift
Marketing Manager

Financial statements don't appear by magic. They are the final product of a structured, repeatable process known as the accounting cycle. While the principles are universal, the tools you use can dramatically change the experience. This guide walks you through the accounting cycle with a focus on Beancount, the powerful plain-text accounting tool.

We'll see how Beancount's text-first approach eliminates tedious steps, what you should automate, and which reports give you the clearest picture of your financial health. 🧑‍💻

2025-08-13-the-accounting-cycle-beancount-style


TL;DR: The Beancount Workflow

  • Capture & Journal: Record every transaction as a clean, double-entry posting in your .beancount text file.
  • Validate & Reconcile: Use balance assertions to confirm your ledger matches bank statements and run bean-check to catch errors.
  • Review: Generate an unadjusted trial balance for a quick sanity check.
  • Adjust: Post entries for accruals, deferrals, depreciation, and other period-end items.
  • Re-review: Check the adjusted trial balance to ensure everything is correct.
  • Publish & Close: Generate your Income Statement, Balance Sheet, and Cash Flow statement. Closing the books is optional in Beancount, as reports are date-aware.

This flow can be visualized like this:


Step 1: Capture and Record Transactions

This is the foundational step. Every financial event—a sale, a purchase, a bank fee—must be recorded. In Beancount, you do this by creating transactions in a simple text file, typically named main.beancount or organized into multiple files by year.

Each transaction must follow the rules of double-entry bookkeeping, meaning the sum of all postings must be zero. Beancount enforces this for you.

2025-08-10 * "Walmart" "Purchase of office supplies"
Expenses:Office:Supplies 45.67 USD
Assets:Bank:Checking -45.67 USD
  • Pro-Tip: Use tags like #project-phoenix or #client-acme to add dimensions to your data. This makes querying and reporting incredibly flexible later on.

Reconciliation Hygiene ✅

The most powerful feature for ensuring accuracy is the balance assertion. At the end of a statement period (e.g., end of the month), you declare what the balance of an account should be.

2025-08-31 balance Assets:Bank:Checking  12345.67 USD

If the sum of all transactions affecting Assets:Bank:Checking up to that date doesn't equal 12345.67 USD, Beancount will raise an error. This simple directive turns your ledger into a self-auditing document.

For those backfilling historical data, the pad directive can automatically create a balancing transaction to make your opening balances match your first assertion.


Step 2: "Post to the Ledger" (A Freebie!)

In traditional accounting systems, you first write entries in a "journal," and then a separate "posting" step copies those values to the "general ledger."

With Beancount, your .beancount file is both the journal and the ledger. When you write and save a transaction, you've already posted it. There is no separate step. This directness is a core advantage of plain-text accounting—what you see is what you get.


Step 3: Prepare an Unadjusted Trial Balance

Before you start making adjustments, you need a quick "does this all add up?" check. A trial balance is a simple report that lists every account and its total balance. The grand total of all debit balances must equal the grand total of all credit balances.

You can generate this with a simple query:

bean-query main.beancount \
"SELECT account, sum(position) GROUP BY 1 ORDER BY 1"

Or, for a more visual approach, open your ledger in Fava (the web interface for Beancount) and navigate to the "Trial Balance" report. Look for anything unusual—an asset account with a credit balance, or an expense account with a strange value.


Step 4: Book Adjusting Entries

Adjusting entries are crucial for accurate reporting under the accrual basis of accounting. They ensure that revenues are recognized when earned and expenses are recognized when incurred, regardless of when cash changes hands.

Common adjustments include:

  • Accruals: Recording revenue you've earned but haven't invoiced yet, or an expense you've incurred but haven't paid.
  • Deferrals: Handling prepayments. If a customer pays you for a year of service upfront, you book it as a liability (Liabilities:UnearnedRevenue) and recognize 1/12th of it as income each month.
  • Non-Cash Items: Recording things like depreciation of assets.
  • Corrections: Fixing errors or accounting for missed items from bank feeds, like a small interest payment.

Example: Accruing Revenue

You finished a project on August 31st but won't send the invoice until September. To recognize the income in the correct period (August), you make an adjusting entry:

2025-08-31 * "Accrue revenue for client project #1042"
Assets:AccountsReceivable 3000.00 USD
Income:Consulting -3000.00 USD

Example: Recording Depreciation

Your company has a depreciation schedule for its assets. At the end of the period, you book the expense:

2025-12-31 * "Annual depreciation on computer equipment"
Expenses:Depreciation 4800.00 USD
Assets:Fixed:AccumulatedDepreciation -4800.00 USD

Step 5: Run an Adjusted Trial Balance & Validate

Once your adjusting entries are in, run the trial balance report again. This is your Adjusted Trial Balance. It provides the final set of numbers that will be used to create the financial statements.

This is also the perfect time to run Beancount's built-in sanity check:

bean-check main.beancount

This command verifies all syntax, balancing rules, and assertions. If it runs without any output, your books are mechanically sound.


Step 6: Publish Financial Statements 📊

This is the payoff. Using the numbers from your adjusted trial balance, you can now generate the key financial reports. Fava is the easiest way to do this, as it provides interactive, drill-down reports out of the box.

  • Income Statement (Profit & Loss): Shows your revenues and expenses over a period, resulting in your net income or loss.
  • Balance Sheet: A snapshot of what you own (Assets) and what you owe (Liabilities), as well as your net worth (Equity), on a specific date.
  • Cash Flow Statement: Reconciles your starting cash with your ending cash by showing where money came from and where it went.

For custom reports, you can use Beancount Query Language (BQL). Here’s a query for a monthly income statement:

-- P&L for August 2025
SELECT account, sum(position)
WHERE account ~ '^(Income|Expenses)'
AND date >= 2025-08-01 AND date <= 2025-08-31
GROUP BY account ORDER BY account;

Step 7: Closing the Books (Optional)

In traditional accounting, the "closing" process involves creating journal entries to zero out all temporary accounts (Income and Expenses) and transfer the net income into an equity account called Retained Earnings. This formally resets the temporary accounts for the next year.

In Beancount, this step is usually unnecessary. Fava's reports are date-aware; if you ask for a 2025 P&L, it will only use 2025 data. The balances don't "spill over." Most users simply leave the balances as they are.

However, if you need to perform a formal close for compliance or shareholder reporting, you can do so with a simple year-end transaction that moves the total income and expense balances into Equity:Retained-Earnings.


A Practical Monthly Close Checklist

Here’s a repeatable checklist to close your books each month using Beancount.

  • Capture: Import all bank and credit card transactions. Manually enter any cash expenses or out-of-band items.
  • Reconcile: Add balance assertions for all bank accounts, credit cards, and loan accounts, matching them to your statements.
  • Review: Scan the unadjusted trial balance in Fava. Investigate any strange or unexpected balances. Check for stale unpaid invoices (Assets:AccountsReceivable) or bills (Liabilities:AccountsPayable).
  • Adjust: Book entries for accrued revenue/expenses, deferred revenue, and any necessary corrections.
  • Validate: Run bean-check. Review the final adjusted trial balance.
  • Publish: Generate the P&L and Balance Sheet. Send them to stakeholders or save them for your records.
  • Wrap-up: Optionally, perform a closing entry if your business requires it. Archive a copy of your .beancount files for the period.

Why Beancount Shines for the Accounting Cycle

  • Transparency and Auditability: Your ledger is a text file. You can use git to version control your financial history, review changes with diff, and collaborate with your accountant in a clear, unambiguous format.
  • Total Control: You define your chart of accounts. You aren't locked into a software vendor's structure. Your data is yours, forever, in an open format.
  • Unmatched Power: The combination of SQL-like queries (BQL) and a rich web interface (Fava) gives you unparalleled power to slice, dice, and understand your financial data.

Copy-Paste Snippets to Get Started

Simple Chart of Accounts:

option "title" "My Personal Ledger"
option "operating_currency" "USD"

;; --- Accounts ---
1970-01-01 open Assets:Bank:Checking
1970-01-01 open Assets:AccountsReceivable
1970-01-01 open Liabilities:CreditCard
1970-01-01 open Liabilities:UnearnedRevenue
1970-01-01 open Equity:Owner:Capital
1970-01-01 open Equity:Retained-Earnings
1970-01-01 open Income:Consulting
1970-01-01 open Expenses:Office:Supplies
1970-01-01 open Expenses:Software
1970-01-01 open Expenses:Depreciation

Useful BQL Query:

-- Find all customers with an outstanding balance
SELECT payee, sum(position)
WHERE account = 'Assets:AccountsReceivable'
GROUP BY payee
HAVING sum(position) > 0
ORDER BY sum(position) DESC;

By mapping the timeless accounting cycle to Beancount's modern, text-based tools, you gain a system that is robust, transparent, and built to last. Happy bookkeeping!

A Guide to Choosing the Right Tax Advisor

· 6 min read
Mengjia Kong
Mengjia Kong
IRS Enrolled Agent

Meticulous financial records are the foundation of financial clarity and stress-free tax seasons. For those dealing with more than just a simple W-2, preparing for tax filing, strategic planning, and ensuring compliance can be a significant challenge. This guide will help you determine when to hire a tax advisor and how to select the best expert to complement your financial management system.

Why You Might Need a Tax Advisor

2025-06-28-a-guide-to-choosing-the-right-tax-advisor

Even with diligent tracking, modern finances can quickly become complex. A professional can be invaluable in several key areas:

  • Mitigating Risks from Complex Situations Self-employment income, digital asset trading, international transactions, or equity in a private company can make your tax filings incredibly complicated. A professional advisor minimizes errors and reduces the risk of costly penalties.
  • Uncovering Tax-Saving Opportunities Expert insight is necessary to fully leverage deductions, tax deferrals, and tax-advantaged accounts like a Solo 401(k) or SEP IRA. An advisor can identify opportunities you might have missed.
  • Saving Valuable Time Your time is better spent building your business, writing code, or creating content than deciphering thousands of pages of tax code. Outsourcing complex tax matters allows you to focus on what you do best.

Common Types of Tax Advisors and When to Hire Them

RoleTypical ExpertiseWhen to Consider Hiring
CPA (Certified Public Accountant)Tax return preparation and planning, IRS representation, bookkeeping, business acquisitions, financial statement compliance, audit opinions.When forming or restructuring a business, requiring GAAP-compliant financials, or needing comprehensive business financial services.
Enrolled Agent (EA)Tax return preparation and planning, IRS representation. Specializes exclusively in tax matters.When you receive a notice from the IRS, need focused tax expertise, or want a cost-effective solution for personal or small business tax needs.
Tax AttorneyTax return preparation and planning, IRS representation, tax litigation, multi-state/international tax law, complex compliance issues.When facing potential tax litigation, designing complex equity compensation plans, navigating major asset acquisitions, or dealing with criminal tax matters.

Important Note: Only CPAs, Enrolled Agents, and Tax Attorneys can represent clients before the IRS. While anyone can prepare tax returns, these three credentials are the only ones that allow professionals to represent you in IRS proceedings. Tax attorneys have the additional privilege of representing clients in tax court litigation.

Pro Tip: If you frequently trade digital assets or have foreign transactions, seek an advisor with specific experience in cryptocurrency or international tax law.

Five Criteria for Evaluating and Selecting an Advisor

  1. Domain Expertise Verify that the advisor has experience with clients in your specific situation, whether it's freelancing, running a SaaS business, or managing Web3 investments.
  2. Communication Style Find an advisor who values organized, detailed financial records. Ask how they prefer to receive your financial data and what level of documentation they require. Their response will indicate their attention to detail and professionalism.
  3. Credentials and Standing Confirm that their CPA license, EA credential, or bar license is active and in good standing with the relevant regulatory body.
  4. Fee Structure
    • Flat Fee: Common for standard tax forms (e.g., Form 1040, 1065).
    • Hourly Rate: Suitable for one-off consultations or complex planning.
    • Hybrid Model: A flat fee for tax preparation combined with an hourly rate for strategic planning.
  5. Data Collaboration Workflow An ideal advisor wants clean, organized data. Ask about their process for receiving and integrating your financial records to ensure a smooth workflow.

The Power of a Well-Kept Ledger

The key to an efficient and productive relationship with a tax advisor is providing them with flawless, easily digestible financial data. This is where a systematic approach to bookkeeping shines. By treating your finances like a transparent, auditable dataset, you empower your advisor to work faster and more accurately.

This is where a plain-text accounting tool like Beancount becomes a superpower. It allows you to maintain a perfect, version-controlled ledger of every transaction. With Beancount available on mobile and tablet devices, you can do bookkeeping anywhere—whether you're at a coffee shop, traveling, or waiting between meetings. This mobility eliminates the need to hire a separate bookkeeper, saving you significant costs while maintaining complete control over your financial records.

Here's how to structure your data to make your advisor's job effortless:

  • Align Accounts with Tax Form Fields Structure your chart of accounts to mirror tax categories. Use precise account names like Income:US:Consulting or Expenses:Business:HomeOffice. This helps your CPA instantly map your data to the necessary forms, like Schedule C or Form 8829.

  • Leverage Metadata and Tags Tagging transactions provides crucial context. For instance, you can mark income sources to reconcile them with specific 1099 forms. A simple entry in a Beancount ledger might look like this:

2025-03-21 * "Stripe Payout for Project X"
Assets:Bank:Checking 5000.00 USD
Income:US:Consulting -5000.00 USD
tag: "1099k"

This tag instantly tells your advisor the nature of the income, saving time and preventing confusion.

  • Generate Instant, Accurate Reports A well-maintained ledger allows you to generate up-to-the-minute financial statements. Tools like Beancount can export clean income statements and balance sheets to HTML or CSV, so your advisor always has the latest data without needing to ask.

By adopting a system like this, you move from chaotic spreadsheets to a pristine, single source of truth for your financial life.

When to Seek Professional Help Immediately

  • You are planning to start a business and need to decide on entity type (sole proprietorship, partnership, LLC, C-Corp, S-Corp) or are changing your business entity.
  • You are granting or receiving equity, or planning to sell your company.
  • You hold foreign assets or have foreign sources of income.
  • You are planning a large-scale sale of cryptocurrency assets.
  • You have received an audit or tax notice from the IRS.

Conclusion

Mastering your financial data gives you control, while a great tax advisor helps you navigate the complex maze of regulations. By choosing the right professional and empowering them with clean, structured financial data, you can transform tax season from a source of stress into a seamless process. A system built on clarity and precision—as exemplified by tools like Beancount—is the key to a productive partnership and a confident financial future.

Beancount Journal Entries: How-To, Definitions, and Examples

· 4 min read
Mike Thrift
Mike Thrift
Marketing Manager

Every financial transaction your business makes needs to be recorded—and in the world of plain-text accounting, this starts with journal entries. If you're using Beancount, understanding journal entries is key to building accurate, auditable, and clean financial records.

This guide will walk you through:

2025-06-27-journal-entries

  • What a journal entry is
  • Why journal entries matter
  • How to write them in Beancount syntax
  • How to use them effectively
  • Examples of real-world transactions (client payments, purchases, loans, etc.)

🧾 What is a Journal Entry in Beancount?

In Beancount, a journal entry is a dated transaction written in a human-readable plain-text format. Each entry follows the principles of double-entry accounting—you record where money comes from (credit) and where it goes (debit), ensuring your books always balance.

Example:

2024-06-01 * "Client payment for invoice #123"
Assets:Bank:Checking 600.00 USD
Income:Sales
  • The * indicates a cleared transaction.
  • The description shows context for the entry.
  • Assets:Bank:Checking is debited.
  • Income:Sales is credited (value implied).

Every entry lives inside a .beancount file—just a text file you can version, back up, and even edit in Vim or VSCode.

📒 Why Journal Entries Matter

Journal entries are the atomic unit of your ledger.

They:

  • Feed into your General Ledger and Account Balances
  • Drive all reports: Income Statements, Balance Sheets, Cash Flows
  • Let you trace every dollar, line by line, to its source

With the right tools, you'll see these transactions rendered in a UI—categorized, searchable, and filterable. But it all starts with that simple plain-text entry.

📚 How Double-Entry Works in Beancount

Beancount enforces double-entry accounting. Every transaction must be balanced: total debits = total credits.

Quick rule:

  • Debit assets and expenses (you gain cash or incur a cost)
  • Credit income and liabilities (you earn money or take on debt)

Example – Office Supplies Purchase:

2024-06-02 * "Bought printer ink"
Expenses:OfficeSupplies 100.00 USD
Assets:Bank:Checking

🧠 Visualizing Entries

Once you save, on the left side navigation of https://beancount.io/ledger/0/income_statement/ you will see ...

  • Journal View: See transactions with search, tags, and filtering
  • Account Filter Dropdown: See running balances and per-account entries
  • Income Statement: Sum of your Income:* and Expenses:* accounts
  • Balance Sheet: Your assets minus liabilities

Fava helps turn your raw Beancount entries into actionable reports—with zero database setup.

💡 Common Journal Entry Examples

✅ You get paid by a client

2024-06-05 * "Payment for invoice #456"
Assets:Bank:Checking 1,200.00 USD
Income:Consulting

Optional: If you use Accounts Receivable:

2024-05-20 * "Invoice #456 sent"
Assets:AccountsReceivable 1,200.00 USD
Income:Consulting

2024-06-05 * "Payment for invoice #456"
Assets:Bank:Checking 1,200.00 USD
Assets:AccountsReceivable -1,200.00 USD

🖨️ You buy office supplies

2024-06-07 * "Staples run"
Expenses:OfficeSupplies 85.00 USD
Assets:Bank:Checking

🏦 You make a loan payment

Let’s say you pay $1,000, with $200 in interest and $800 toward principal:

2024-06-10 * "Loan repayment"
Liabilities:Loan -800.00 USD
Expenses:LoanInterest 200.00 USD
Assets:Bank:Checking -1,000.00 USD

🔒 Closing Entries at Year-End

To “close the books,” you typically transfer all Income and Expenses accounts into Equity.

2024-12-31 close Income:*
2024-12-31 close Expenses:*

Or, manually:

2024-12-31 * "Close books"
Equity:RetainedEarnings 45,000.00 USD
Income:Consulting -45,000.00 USD

🛠️ Adjusting Entries

If you're doing accrual accounting, you’ll want to add adjusting entries—for prepaid expenses, accrued revenue, etc.

Example: $100 monthly software subscription paid annually

2024-01-01 * "Annual software payment"
Assets:Prepaid 1,200.00 USD
Assets:Bank:Checking -1,200.00 USD

2024-01-31 * "Monthly amortization"
Expenses:Software 100.00 USD
Assets:Prepaid -100.00 USD

Automate with scripts or available Beancount tools.

🧰 Beancount: Lightweight, Auditable, Powerful

Beancount isn't just an accounting tool—it's an idea: transparent, plaintext financial truth. It's a modern ledgering system that's:

  • Easy to version-control (Git!)
  • Fully portable (no proprietary database)
  • Great for devs, freelancers, and small businesses

Ready to Start?

Start your Beancount file with:

option "title" "My Business Ledger"
option "operating_currency" "USD"

2024-01-01 open Assets:Bank:Checking USD
2024-01-01 open Income:Sales USD
2024-01-01 open Expenses:OfficeSupplies USD
2024-01-01 open Equity:OpeningBalances USD

2024-01-01 * "Initial balance"
Assets:Bank:Checking 10,000.00 USD
Equity:OpeningBalances

Then load your file with your preferred visualization tool to see the magic.

Want an easier start? Try templates, importers, or community tools like bean-extract.

With Beancount, your books are finally your own—simple, scriptable, and audit-proof.

Let me know if you’d like a downloadable PDF version or small business–specific variations of the examples.

The Green Ledger: Tracking ESG with Beancount

· 6 min read
Mike Thrift
Mike Thrift
Marketing Manager

In today's world, Environmental, Social, and Governance (ESG) metrics are no longer just buzzwords; they're essential indicators of a company's health and future viability. But how do you integrate these crucial sustainability insights with traditional financial accounting? Enter Beancount, an open-source, plain-text double-entry ledger that offers a surprisingly powerful and flexible solution for bridging this gap.

Imagine transforming your fragmented sustainability reporting into a streamlined, automated system that tracks everything from carbon emissions to supplier diversity, all within your existing financial workflow. Beancount makes this possible by treating ESG data as "first-class citizens alongside financial transactions."

2025-06-22-esg-tracking

Modeling ESG Data: The Beancount Way

Beancount's inherent flexibility is its superpower when it comes to ESG. Instead of siloed spreadsheets, you can embed sustainability metrics directly into your financial structure using a few key techniques:

  • Dedicated Accounts and Commodities: Think of your environmental footprint like another currency. You can create accounts like Metrics:Emissions:CO2e to track carbon emissions. These emissions can even be treated as a commodity (e.g., a unit of CO2 equivalent, tCO2e), allowing you to record specific quantities in your transactions. For instance, a flight purchase could credit an Emissions:CO2e account with +0.3 tCO2e alongside the monetary cost.
  • Custom Metadata Tags: Beancount's key-value metadata is perfect for adding context. You can tag a transaction with CO2e: 0.3 t or Scope: 3 to denote its carbon impact or GHG Protocol scope. This links financial outlays directly to their environmental consequences, providing a richer, more complete picture.
  • Structured Tags for Categories: Aligning with standards like the Greenhouse Gas Protocol (GHGP) is crucial. You can use consistent tags or account naming conventions, such as Metrics:Emissions:Scope1, Metrics:Emissions:Scope2, and Metrics:Emissions:Scope3 to easily categorize and report on direct, energy-related, and value chain emissions.

This adaptable approach means that as ESG standards evolve, you can adjust your ledger structure without a complete overhaul.


Beancount vs. Specialized ESG Tools: A Strategic Choice

While dedicated ESG platforms like Persefoni or SAP Green Ledger offer highly automated, purpose-built solutions, Beancount presents a compelling alternative, particularly for those seeking transparency and control.

FeatureBeancount (Plain-Text)Specialized SaaS (e.g., Persefoni, Plan A)Enterprise ERP Integration (e.g., SAP Green Ledger)
Data ModelingUser-defined accounts & metadata; flexible but requires manual structuring.Pre-defined schemas; guided input for activities and automated conversion to emissions.Emissions mapped directly to ERP transactions and master data.
Emission FactorsUser-supplied or integrated via custom scripts; requires manual updates.Built-in, regularly updated emission factor libraries; automatic calculations.Integrated with corporate data and standard factors for audit-grade accuracy.
Data IntegrationOpen architecture via custom Python scripts/APIs; requires development for automated imports.Many pre-built connectors to external data sources (utilities, ERPs, travel systems).Native integration with core business processes and data flows within the ERP.
Reporting & AuditCustom queries and Fava reports; highly customizable but requires user design. Version control (Git) for transparent audit trail.Rich dashboards, pre-built reports for standards (GHG, TCFD, CDP). In-platform audit logs and period locking.Integrated reporting within ERP; designed for "reasonable assurance" auditable data.
Cost & AccessibilityFree and open-source; requires Beancount/scripting knowledge.Commercial SaaS with subscription costs; less technical overhead.Enterprise software with potentially high licensing and implementation costs; requires specific ERP expertise.

Beancount is a DIY powerhouse: It gives you unparalleled flexibility and transparency, making it ideal for individuals or technically savvy small organizations. You own your data completely, avoiding vendor lock-in.

Specialized tools offer turnkey solutions: They excel at automated data collection, built-in emission factor databases, and ready-made compliance reports, often at a higher cost and with less flexibility.

A hybrid approach is also viable: use Beancount for detailed internal tracking and reconciliation, then export summary data to an external platform for high-level stakeholder reporting.


Real-World Applications: ESG in Action with Beancount

Beancount’s versatility makes it suitable for several key ESG use cases:

  • Tracking Scope 3 Emissions: The most challenging emissions to track (from your value chain) can be integrated by linking supplier emissions data to purchase transactions. Beancount provides a clear audit trail for these complex figures, enabling better analysis and pinpointing data sources.
  • Sustainability Audits and Assurance: Like financial data, ESG figures need to be verifiable. Beancount allows you to link each ESG entry to source documents (e.g., utility bills, third-party verification statements), providing a meticulous audit trail for transparency and assurance.
  • EU CSRD/ESRS Compliance Reporting: For companies facing stringent regulations like CSRD, Beancount can serve as a central repository for quantitative disclosures. While it won't automatically format reports into XBRL, it provides the granular, auditable data needed to generate compliance-ready figures.
  • Carbon Footprint Analysis & Management Accounting: Treat carbon as another dimension of management accounting. By allocating emissions to profit centers or product codes, you can calculate metrics like "emissions per dollar of revenue" and identify carbon hotspots, driving more informed sustainability decisions.

Best Practices for Your Beancount ESG Ledger

To maximize the effectiveness of Beancount for ESG, consider these best practices:

  1. Design a Clear Chart of Accounts for ESG: Structure your ESG accounts thoughtfully (e.g., Metrics:Emissions:Scope1:Fuel), just like your financial accounts.
  2. Use Metadata Consistently: Leverage tags (e.g., Scope: 3, FactorSource: EPA2024) for consistent context and easier querying.
  3. Balance Granularity with Manageability: Focus on material metrics to avoid overwhelming your ledger with unnecessary detail.
  4. Automate with Caution: Use Python scripts for data import and validation, but ensure robust error checking and clear documentation of your automation processes.
  5. Leverage Version Control: Use Git to track every change to your ledger, providing a transparent and auditable history of your ESG data.
  6. Connect to Documents and Evidence: Link source files (e.g., PDFs of utility bills) to ledger entries for easy verification during audits.
  7. Utilize Fava for Insights: Configure Fava to display custom ESG charts and reports, making your sustainability data actionable and accessible to non-technical stakeholders.
  8. Stay Updated on Standards: ESG reporting is dynamic; be prepared to adapt your Beancount structure as new regulations and frameworks emerge.

The Future is Green, and Plain-Text

While Beancount currently lacks native ESG intelligence or plug-and-play reporting, its open-source nature presents immense opportunities for enhancement. Community-driven plugins for carbon accounting, standardized ESG ledger templates, and better integration with emission factor APIs could significantly boost its capabilities.

As the corporate world increasingly embraces "green ledgers," Beancount stands ready as a flexible, transparent, and auditable solution. By integrating ESG data with the same rigor as financial data, Beancount empowers organizations to not only meet compliance demands but also drive meaningful sustainability initiatives.

Are you ready to bring your ESG data into the plain-text revolution?

Navigating Receivables in Beancount

· 3 min read
Mike Thrift
Mike Thrift
Marketing Manager

In the labyrinth of personal finance management, Beancount emerges as a beacon of clarity and precision for plain-text bookkeeping. Particularly when it comes to managing receivables—money expected from others—Beancount offers a structured approach to keep your financial records in impeccable order. This blog will guide you through the intricacies of tracking receivables, processing refunds, and managing unresolved transactions with Beancount. Whether you're returning a purchase, lending money, or awaiting a refund, this post is your roadmap to financial clarity.

Understanding Receivables in Beancount:

2024-02-17-navigating-receivables-beancount-guide

Receivables represent money that is owed to you. This could be from a variety of scenarios, such as after a shopping return awaiting a refund or when you lend money to someone. For instance, consider you've returned a watch strap to an online store like Amazon.com and are awaiting a refund. In Beancount, this transaction is recorded as money moving from your credit card liability to your assets as receivables:

2023-10-31 * "Amazon.com" "[Return] Watch Strap"
Liabilities:CreditCard:Chase -12.00 USD
Assets:Receivables

Managing Refunds:

Once the refund is processed and you receive the money, another transaction is recorded to offset the balance in Receivables. This ensures that your accounts reflect the money back in your possession:

2023-11-01 * "Amazon.com" "[Refund] Watch Strap"
Liabilities:CreditCard:Chase 12.00 USD
Assets:Receivables

Complete Transaction Cycle:

A complete in-and-out transaction involving receivables is combining both transactions above and showcased as follows, demonstrating a balanced account post-refund:

2023-10-31 * "Amazon.com" "[Return] Watch Strap"
Liabilities:CreditCard:Chase -12.00 USD
Assets:Receivables

2023-11-01 * "Amazon.com" "[Refund] Watch Strap"
Liabilities:CreditCard:Chase 12.00 USD
Assets:Receivables

Handling Unresolved Transactions:

For transactions where the refund or repayment has not yet been received, Beancount employs the #UNRESOLVED tag. This tag helps in identifying and tracking amounts that are still pending. For example:

2023-10-31 * "John Doe" "Lending Money" #UNRESOLVED
Liabilities:CreditCard:Chase -100.00 USD
Assets:Receivables

By focusing on transactions tagged as #UNRESOLVED, you can quickly ascertain which amounts are yet to be settled.

Maintaining a Zero Balance:

In a proper ledger, the sum of all transactions under the Assets:Receivables account, excluding those tagged with #UNRESOLVED, should ideally return to zero. This ensures that all expected funds have been accounted for, maintaining the integrity of your financial records.

For example, a valid ledger might look like this, with an unresolved transaction clearly marked, awaiting closure:

2023-10-31 * "Amazon.com" "[Return] Watch Strap"
Liabilities:CreditCard:Chase -12.00 USD
Assets:Receivables

2023-11-01 * "Amazon.com" "[Refund] Watch Strap"
Liabilities:CreditCard:Chase 12.00 USD
Assets:Receivables

2023-10-31 * "John Doe" "Lending Money" #UNRESOLVED
Liabilities:CreditCard:Chase -100.00 USD
Assets:Receivables

An invalid ledger is one where a transaction causes the Receivables account not to zero out, necessitating the #UNRESOLVED tag for correction.

Conclusion

Navigating receivables in Beancount doesn't have to be daunting. With a clear understanding of how to record transactions, manage refunds, and keep an eye on unresolved transactions, you can maintain accurate and reliable financial records. Embracing the structured approach of Beancount for receivables management not only simplifies your financial tracking but also brings peace of mind, knowing that every dime is accounted for. So, why not leverage the power of Beancount to make your financial management as smooth

Beancount Cheat Sheet

· 2 min read
Mike Thrift
Mike Thrift
Marketing Manager

Example Account Name

Assets:US:BofA:Checking

cheatsheet-en

Account Types

Assets          +
Liabilities -
Income -
Expenses +
Equity -

Commodities

CNY, EUR, CAD, AUD
GOOG, AAPL, RBF1005
HOME_MAYST, AIRMILES
HOURS

Directives

General syntax

YYYY-MM-DD <Directive> <Parameters...>

Opening & Closing Accounts

2001-05-29 open Expenses:Restaurant
2001-05-29 open Assets:Checking USD,EUR ; Currency constraints

2015-04-23 close Assets:Checking

Declaring Commodities (Optional)

1998-07-22 commodity AAPL
name: "Apple Computer Inc."

Prices

2015-04-30 price AAPL   125.15 CNY
2015-05-30 price AAPL 130.28 CNY

Notes

2013-03-20 note Assets:Checking "Called to ask about rebate"

Documents

2013-03-20 document Assets:Checking "path/to/statement.pdf"

Transactions

2015-05-30 * "Some narration about this transaction"
Liabilities:CreditCard -101.23 CNY
Expenses:Restaurant 101.23 CNY

2015-05-30 ! "Cable Co" "Phone Bill" #tag ˆlink
id: "TW378743437" ; Meta-data
Expenses:Home:Phone 87.45 CNY
Assets:Checking ; You may leave one amount out

Postings

  ...    123.45 USD                             Simple
... 10 GOOG {502.12 USD} With per-unit cost
... 10 GOOG {{5021.20 USD}} With total cost
... 10 GOOG {502.12 # 9.95 USD} With both costs
... 1000.00 USD @ 1.10 CAD With per-unit price
... 10 GOOG {502.12 USD} @ 1.10 CAD With cost & price
... 10 GOOG {502.12 USD, 2014-05-12} With date
! ... 123.45 USD ... With flag

Balance Assertions and Padding

; Asserts the amount for only the given currency:
2015-06-01 balance Liabilities:CreditCard -634.30 CNY

; Automatic insertion of transaction to fulfill the following assertion:
2015-06-01pad Assets:Checking Equity:Opening-Balances

Events

2015-06-01 event "location" "New York, USA"
2015-06-30 event "address" "123 May Street"

Options

option "title" "My Personal Ledger"

Other

pushtag #trip-to-peru
...
poptag #trip-to-peru
; Comments begin with a semi-colon

Enhancing Your Beancount Experience with Custom Links and Queries

· 3 min read
Mike Thrift
Mike Thrift
Marketing Manager

Beancount, the double-entry accounting system beloved by developers and finance nerds alike, is powerful in its simplicity. But for those who want more control and faster navigation inside Fava, Beancount’s web interface, custom sidebar links and SQL queries can take your workflow to the next level.

In this guide, we’ll show you how to:

  • Add quick-access links to Fava’s sidebar
  • Use SQL queries for advanced filtering and analysis
  • Customize your workflow for monthly reviews or anomaly detection

Why Customize Fava?

Fava is already a beautiful interface for viewing your Beancount ledger, but as your journal grows, so does the need for better shortcuts and smarter queries.

Pain points this solves:

  • Navigating through time ranges repeatedly
  • Filtering transactions across nested accounts
  • Spotting negative balances or anomalies faster

Let’s start with improving your daily workflow with simple sidebar shortcuts. These links appear in Fava’s left sidebar and can take you directly to filtered views like this month’s transactions or last month’s income.

Add these lines to your Beancount file:

2021-01-01 custom "fava-sidebar-link" "Current Month" "/jump?time=month"
2021-01-01 custom "fava-sidebar-link" "Last Month" "/jump?time=month-1"
2021-01-01 custom "fava-sidebar-link" "Clear All" "/jump?account=&time=&filter="

What They Do:

  • Current Month: Opens the transaction view filtered to the current month.
  • Last Month: Instantly jumps to the previous month—great for end-of-month reviews.
  • Clear All: Resets filters, showing all entries again.

These shortcuts eliminate manual time input and make your Fava experience feel more fluid and personalized.

🔍 Custom SQL Queries

For deeper insight, Fava’s SQL interface is incredibly powerful. Here’s a query that finds all negative balances in accounts that match a pattern—perfect for flagging unusual or problematic transactions.

SELECT account, units(sum(position)), sum(position)
WHERE number(units(position)) < 0
AND account ~ '.*:BCM:.*'
AND date >= DATE(2021,12,9)
AND date < DATE(2022,1,9)

Breakdown:

  • account ~ '.*:BCM:.*': Filters accounts containing :BCM: in their name.
  • number(units(position)) < 0: Flags negative balances (e.g. overspent budgets).
  • Date filters narrow the result to a specific 1-month window.

Use cases:

  • Spot errors like duplicate expenses or incorrect postings
  • Audit a specific vendor or category
  • Quickly extract actionable insights for budgeting

While Fava doesn’t allow direct links to custom queries, you can create a monthly review habit by:

  • Using the “Current Month” link to start your review
  • Opening your saved queries tab in another pane
  • Reviewing both simultaneously—filter first, then dig deep

This combo helps you catch anomalies before they spiral and ensure your ledger stays clean.

Final Thoughts

Beancount is minimal by design, but small enhancements like these bring huge gains in efficiency. Whether you’re reviewing your budget, debugging strange balances, or simply saving clicks, custom links and SQL queries give you more power and less friction.

Bonus: If you're using Fava’s custom reports, you can even build full dashboards tailored to your personal finance rituals.

Ready to take control?

Start small: add the “Current Month” link. Then build your own queries. Your future self will thank you.

Want more tips like this? Subscribe to our newsletter or explore more Beancount recipes at Beancount.io.