Transactions

Transactions are the individual financial entries within your accounts -- every purchase, deposit, transfer, and payment. The transactions view is where you record, review, and organize your financial activity.

The transaction register

Adding a Transaction#

Navigate to an account's transaction list and click Add Transaction, or use the global add button from any page.

Form Layout#

The transaction dialog lays its fields out in two columns:

ColumnContains
TransactionType, amount, account and date, plus the destination account and amount when the type is Transfer.
DetailsDescription, vendor, category, the Split across categories toggle, and any tags.

Under the columns, More options holds receipts, notes and the Exclude from forecast option. It is folded away for a new transaction, and opens by itself when the transaction already has notes, a receipt or the forecast option set, or when receipt scanning is available on your server.

A new transaction starts as an Expense dated today, with the cursor in Amount. The account is filled in for you where the app can tell which one you mean: the account you came from, the account the transaction list is filtered to, the last account you saved a transaction to, or your only open account. Otherwise pick one from the list.

Turning on Split across categories replaces the category field with a Split Details table spanning the full width of the dialog, below the columns. On a phone the columns stack into one.

Transaction Fields#

FieldRequiredDescription
DateYesThe date the transaction occurred. Future dates create scheduled transactions.
DescriptionYes, unless a vendor is setA short description of the transaction (e.g., "Grocery store", "Monthly rent"). Transactions the app books for a bill or income payment often have only a vendor, and can still be edited. Such a transaction keeps its vendor until it has a description, so clearing the vendor of one is refused.
AmountYesThe transaction amount. Always entered as a positive number; the type field determines the sign.
TypeYesExpense (money out), Income (money in) or Transfer (between accounts), chosen with the three buttons at the top of the form. Transfer is only offered for a new transaction.
AccountYesThe account this transaction belongs to. Pre-selected if you navigated from an account view.
CategoryNoThe spending or income category. Used for budgeting and reports. See Categories.
VendorNoThe merchant, payee, or payer name.
ReferenceNoA check number, confirmation code, or other external reference.
NotesNoFree-text notes for any additional context.
Exclude from forecastNoMarks the transaction as extraordinary/one-time so it doesn't skew forecast projections. It still affects your account balance. Excluded transactions show a No forecast badge in the list. It also keeps the transaction out of the monthly average that Runway uses.

Tip: If you find yourself entering similar transactions repeatedly, use the duplicate feature to copy an existing transaction and modify only what changed.

Editing Transactions#

There are two ways to edit a transaction:

  • Inline editing -- Click a transaction row in the table to expand it and edit fields directly.
  • Modal editing -- Click the edit button on a transaction to open the full edit modal with all fields visible.

Both methods save changes immediately when you confirm. The edit modal is useful when you need to see all fields at once, while inline editing is faster for quick changes like updating a category or amount.

The ⋮ button beside the edit button on each row opens the rest of the row's actions: Duplicate, Share expense, Match transfer (or Unlink transfer for a transaction that is already matched), Link to bill… (or Unlink from bill, see Linking a Transaction to a Bill) and Delete.

A description or vendor too long for its column shows in full when you hover it, and so does the reference under it. On a narrow screen the Description column keeps room for its text and the table scrolls sideways instead.

Amounts in the list carry a sign as well as a colour, - for money out and + for money in.

The Total at the foot of the list adds up the transactions on the page. When they come from accounts in more than one currency, it gives a total for each currency rather than adding different currencies together.

The Transactions toolbar#

Filters, Bulk Actions and Add Transaction sit beside the page title. The less frequent tools are in the ⋯ menu next to them: Reconcile (see Statement Reconciliation), Find Duplicates, Match All and Export (see Exporting to CSV).

On a phone#

On a narrow screen each transaction is shown as a two-line card instead of a table row: the description and amount on the first line, and the date, category and account beneath, with the edit and ⋮ buttons at the end. Tap a card to open it in the edit form; on a wider screen, clicking a cell edits that field in place instead.

Keyboard navigation#

The transactions list can be worked without the mouse. When you are not typing in a field:

  • j / k -- move a row cursor down / up the list
  • e or Enter -- open the highlighted row for editing
  • x -- select or deselect the highlighted row (for bulk operations)

Press ? anywhere in the app for the full list of shortcuts.

Note: Transfer transactions have some editing restrictions. The transfer type cannot be changed after creation, and the linked transaction in the other account is updated automatically to keep the pair in sync.

Transaction Status#

Every transaction has a status that affects how it is counted toward your balance:

Cleared#

Cleared transactions represent confirmed activity -- they have occurred and are reflected in your bank statement. These are included in the current balance of the account.

Scheduled#

Transactions with a future date are automatically marked as scheduled. They appear in the transaction list in italics with a SCHEDULED badge and are included in the projected balance but not the current balance or the transaction list total.

This distinction lets you enter upcoming bills or expected deposits ahead of time without inflating your current balance. The projected balance (visible in the account detail view) shows what your balance will be once scheduled transactions clear.

When the list shows a single account, each scheduled transaction's running balance is the balance once it has gone through, in smaller grey text, or red if it would take the account below zero. See Current Balance vs. Projected Balance.

Once its date arrives, a scheduled transaction counts in the balance: a background job, which runs every hour, marks it cleared soon after midnight in the account owner's timezone.

Recurring bills create scheduled transactions automatically: marking a bill paid pre-creates a placeholder for the next occurrence. This placeholder is not a duplicate payment — it becomes the real transaction when that occurrence is paid, and until then it stays scheduled, even after its date, as an unpaid bill hasn't moved any money. Each bill has a Create future transaction option to turn this off per bill. A bill's payment can't be set back to scheduled by editing it, and a scheduled transaction can't be ticked in a reconciliation, as it isn't on a statement yet.

Tip: Use scheduled transactions to plan ahead. Enter your rent, subscriptions, and other recurring payments with their expected dates so the projected balance reflects your true financial picture.

Filtering and Searching#

The transaction list includes a filter panel for narrowing down what you see. Filters are applied immediately as you change them.

Available Filters#

FilterDescription
AccountShow transactions from a specific account.
CategoryFilter by spending or income category, or pick Uncategorized for transactions with no category set. Picking a category also finds the split transactions with a part in it — see Splits under a category filter. Uncategorized leaves splits out: their categories live on the individual parts, so they are already categorised.
TypeFilter by credit, debit, or transfer.
StatusShow all transactions, cleared only, or pending/scheduled only.
ReconciledShow all transactions, only reconciled, or only those not yet reconciled.
Date rangeFilter by transaction date (from/to).
Created date rangeFilter by when the transaction was entered into the app (from/to).
Amount rangeFilter by minimum and/or maximum amount.
TagsFilter by tag set tags assigned to the transaction.
Text searchFree-text search across description, vendor, reference, and notes.

Multiple filters can be combined. Click Clear Filters to reset all filters at once.

Tip: The created date filter is useful for reviewing recently entered transactions regardless of their transaction date, which is helpful after a large import.

Configurable Table Columns#

The transaction table columns can be customized to show only the information you care about. Click the column configuration button (gear icon) in the table header to toggle columns on and off.

Available columns include date, description, amount, category, vendor, reference, notes, account, type, tags, and running balance. Your column preferences are saved per user and persist across sessions.

Note: At least one column must remain visible. The app prevents you from hiding all columns.

Bulk Operations#

Bulk mode lets you act on multiple transactions at once. Click Bulk Actions to enter bulk mode, which adds checkboxes to each transaction row.

Selecting Transactions#

  • Check individual transaction checkboxes to select specific transactions.
  • Use the select all checkbox in the table header to select all visible transactions on the current page.
  • The header checkbox shows an indeterminate state when some (but not all) transactions are selected.
  • When more transactions match the current filter than fit on the page, selecting the whole page offers Select all N matching transactions — click it to extend the selection to every matching transaction across all pages (useful for cleaning up a bad import in one pass). Changing the filter clears such a selection, so a bulk action never includes rows you are no longer looking at.

Available Bulk Actions#

ActionDescription
DeletePermanently delete all selected transactions.
ReconcileMark all selected transactions as reconciled.
UnreconcileRemove the reconciled flag from all selected transactions.
EditApply a category, vendor, reference, or notes value to all selected transactions at once. A split transaction is skipped for the category only — its categories live on its parts — while the other values still apply.
TagsAdd or remove tags across all selected transactions at once. The Add and Remove lists are separate: a tag left unchecked in both is not touched, so tagging a large selection never disturbs the tags those transactions already carry. Global tags apply to everything selected; category tags are grouped under their category and state how far they reach, because a tag set belongs to one category and so can only cover part of a mixed selection.

Click Cancel to exit bulk mode and deselect all transactions.

A selection can include transactions in accounts shared with you. With Read & Write on the account, Delete, Reconcile and Edit work on them as on your own, and a category set with Edit has to be one each account's owner can use and you can see. Transactions you can only read are reported as failed, with the reason, and the rest of the selection goes through. Tags only changes transactions in your own accounts.

Warning: Bulk delete is permanent and cannot be undone. Double-check your selection before confirming.

Split Transactions#

A split transaction allocates a single transaction's amount across multiple categories. This is useful when one purchase covers multiple budget categories -- for example, a supermarket receipt that includes both groceries and household supplies.

Creating a Split#

  1. Open the transaction and turn on Split across categories. The category field is replaced by the Split Details table.
  2. Fill in an amount and a category on each row, and click + Add Row for as many parts as you need.
  3. The last row is worked out for you — it always holds whatever is left of the transaction total, so no part of the amount can be left unallocated. It is read-only for that reason. To change it, adjust one of the rows above it, or add another row below.
  4. Remaining, above the table, reads Fully allocated once the parts add up.
  5. Save the transaction.

Split transactions display a split indicator in the transaction list. To change a split, reopen the transaction, from the Transactions page or from an account's page, and the parts appear as you saved them. To remove the split, untick Split across categories, pick the category the whole transaction belongs in and save. The parts are removed and the transaction goes back to a single category.

Every part needs an amount, and it cannot be zero. A split with an empty or 0.00 part is refused before anything is changed, so a transaction that was already split keeps the parts it had.

Note: A split carries no category of its own — the parts hold them. Each part counts toward its own category’s budget, reports and Spending by Category, so a split receipt is never left out of your figures and is never counted twice. Nothing writes a category back onto the transaction either: bulk edit and import rules both leave it empty, though a rule’s other actions — vendor, notes, tags, reference — still apply. If an older version left a stray category on a split, Settings › Repair Data lists it under Split Transactions Carrying a Category and clears just that category, leaving the split and every part of it untouched.

Note: The sum of all split amounts must equal the transaction amount. A part may be negative: a loyalty discount or coupon line on a receipt is a real part of the split, and the items either side of it add up to more than you actually paid.

Splits Under a Category Filter#

Filter the list to a category and the splits that spent in it appear alongside everything else, marked Split part. Because a split covers several categories, the Amount column shows the share belonging to the category you filtered by, with the whole transaction named underneath — a £82.40 supermarket trip filtered to Groceries reads -£12.40, of -£82.40. The total at the foot of the list adds up those shares, so it matches the figure the Spending by Category chart shows for that category.

The Amount cell cannot be edited in place on those rows: the figure is set by the split, not by the row. Open the transaction to change it.

A CSV export taken under a category filter follows the same rule — the Amount column holds the share, and a trailing Split of column holds the whole transaction. On an unfiltered export nothing changes.

Transfer Transactions#

Transfers move money between two of your accounts. When you create a transfer, the app creates a pair of linked transactions -- a debit in the source account and a credit in the destination account.

Creating a Transfer#

  1. Click Add Transaction and set the type to Transfer.
  2. Select the destination account in the To Account dropdown that appears.
  3. Enter the amount and other details as usual.
  4. The app creates both sides of the transfer automatically.

Transfer transactions display a transfer badge in the transaction list so you can distinguish them from regular credits and debits.

Converting an Existing Transaction into a Transfer#

An imported or manually added credit/debit can be turned into a transfer after the fact — useful when a bank-imported payment is really a transfer to one of your own accounts (for example, a payment toward a loan tracked as its own account).

  1. Open the transaction's action menu and choose Match transfer.
  2. If the matching transaction already exists in the other account, click Link as Transfer next to it. The list shows same-currency transactions with the same amount, plus — for accounts in a different currency — nearby opposite transactions of any amount, since the exchanged amount never matches exactly. Check the account and amount before linking a cross-currency pair.
  3. If the other account has no matching transaction (common for accounts with nothing to import, like a loan account), use the "No match? Create the other side" section: pick the account and click Create and link. The app creates the opposite transaction there and links the pair as a transfer.

The "create the other side" dropdown only offers accounts using the same currency — for a cross-currency transfer where the other leg is missing, create it manually with the converted amount and link it via step 2 instead.

After importing bank statements the app also scans automatically and links any pairs it finds (same amount and currency only), so manual matching is only needed when one side is missing, ambiguous, or in another currency.

Note: A transfer cannot be changed back into a regular transaction in one step — unlink the pair, then delete the leg you don't want.

Warning: Deleting one side of a transfer does not automatically delete the other side. If you delete a transfer transaction, check the linked account and remove the counterpart manually if needed.

Linking a Transaction to a Bill#

A transaction you entered yourself, or one left behind by a bill you deleted and set up again, is not one of a bill's payments, so it is missing from the Bills Calendar. Link to bill… in its ⋮ menu files it under a bill. The list shows the bills that pay from the transaction's account, with their due and paid dates so bills of the same name can be told apart, and the ones matching the amount first.

Linking does not move the bill's due date. If the transaction pays the occurrence that is due now, press Mark Paid on the bill afterwards and choose Use that payment, see When the bill already has a payment.

Only money going out can be linked, and only to a bill paying from that account. Unlink from bill takes it off again, except for the bill's latest payment, including one Use that payment chose, which Mark Unpaid on the bill undoes. For that payment the menu tells you so rather than asking you to confirm.

Finding Duplicates#

Find Duplicates in the ⋯ menu lists transactions in the same account with the same amount, direction and description within three days of each other. The oldest in each group is kept and the rest are ticked; Delete Selected deletes the ticked ones.

Above them, under Bill payments with a bank row beside them, it lists a payment one of your bills booked (by auto-pay or Mark Paid) next to an imported transaction that looks like the bank's own row of it: the same amount to the penny, within the bill match window (5 days unless changed in Settings), naming the bill. A bill still waiting for its payment shows its scheduled placeholder. Merge keeps the bank's transaction, with its date, text and cleared status, gives it the bill, its category, tags and splits and anything you added to the booked payment, and deletes the booked one; a waiting bill is paid with the bank's transaction. When one booked payment has two bank transactions beside it, both are listed, and merging one clears the other from the list.

Duplicating a Transaction#

To quickly create a transaction similar to an existing one, use the Duplicate action on any transaction. This opens the new transaction form pre-filled with all values from the original transaction (date, description, amount, category, vendor, etc.). Adjust any fields as needed and save.

This is especially useful for recurring expenses that are not exactly the same each time, like variable utility bills or grocery runs.

Receipt Attachments#

Receipts, invoices, and warranty documents can be attached to any saved transaction from the edit dialog's Receipts section — upload a new file or pick one already in your Nextcloud Files. Transactions with receipts show a 📎 badge in the list. Files always stay in your own Files space; removing an attachment (or the transaction) never deletes the file. See Nextcloud Integration for details.

Exporting to CSV#

Export in the ⋯ menu at the top of the Transactions page downloads every transaction matching your current filters as a CSV file — the whole result set, not just the page on screen. With no filters set, that is every booking across every account, which is what a year-end export usually needs. The same button on an individual account's page exports that account.

Because the export follows the filters, you can narrow it before downloading: a single category, a date range, one tag, or anything else the filters offer.

What's in the File#

ColumnNotes
Date, Description, VendorAs entered or imported.
Category, AccountNames, not IDs.
TypeIncome or Expense.
AmountSigned — expenses are negative, income positive — so the column totals correctly in a spreadsheet.
CurrencyThe account's currency. Amounts are not converted; a multi-currency export carries each in its own currency.
Reference, Notes, StatusAs stored.
Split ofOnly filled in on a split transaction's row in an export taken under a category filter: the whole transaction's amount, while Amount holds the share (see Splits Under a Category Filter).
ReceiptsThe file names of the transaction's receipts, separated by "; " when there are several, so you can find the invoice behind a line. The names are the ones the files had when they were attached. Blank in an account someone has shared with you, as the receipts are the owner's.

Split of and Receipts are the last two columns, so a spreadsheet set up for an older export keeps its column positions.

A transfer between two of your own accounts appears as two rows, one negative and one positive, so it nets to zero in the total rather than counting on both sides.

Note: This is a plain ledger of what you filtered — nothing is removed. That differs from the Reports exports, which leave out accounts and categories you have excluded from reports.

  • Accounts -- Manage the accounts that hold your transactions
  • Categories -- Organize transactions into spending and income categories
  • Tags -- Add additional classification dimensions to transactions via tag sets
  • Importing Bank Statements -- Import transactions from CSV, OFX, or QIF files
  • Import Rules -- Automatically categorize transactions based on description or vendor patterns
  • Nextcloud Integration -- Attach receipts from your Files and find transactions in Nextcloud's unified search

Settings#

  • Date format -- Controls how dates are displayed throughout the app, including the transaction list. Change this in Settings > General.
  • Number format -- Controls decimal and thousands separators for amounts. Change this in Settings > General.