Skip to content

📝 Transaction Form

The transaction form adds or edits one transaction — or one linked pair — in the bulk workspace. It also shows a transaction read-only when you double-click it in a list. Only the fields that the chosen type needs appear.

Buy Sell Dividend Deposit Adjustment Asset Transfer FX Conversion Cash Transfer

✍️ Fill in the form

  1. Pick the Type, then the Broker if it is not set already.
  2. Fill in the Required section: the Date, the Asset and its quantity when the type has one, and the cash amount.
  3. Open Optional for Tags, a Description or, on dividends, interest and adjustments, a Linked Event.
  4. Click Apply to place the row in the workspace; Save All in the workspace writes it.

A few rules keep entries quick:

  • Amounts are totals — type the total paid or received, not the price per share (Total amount (not per share)).
  • Type positive numbers — the form adds the minus sign where money or units go out: a purchase's payment, a sale's units, a withdrawal, a fee, a tax. Only an Adjustment quantity takes a sign: positive adds units, negative removes them.
  • Checks as you go — once the required fields are filled, the form checks the entry against your ledger and the other workspace rows, and lists any problem at the top. ⚡ Validate now checks at once. The form also spots some mistakes by itself: a date it cannot read, or one in the future, stays on screen in red, and the previous date is not used in its place; a quantity or amount with the wrong sign or format, such as a negative quantity on a purchase, turns red; and a warning at the top flags a transfer with the same broker on both sides, or an exchange with the same currency. Until you fix them, nothing is checked, valid does not appear and Apply stays disabled; ⚡ Validate now takes you to the field to fix instead.
  • Missing broker or asset? — Create new in the broker list, or New asset in the asset list, creates it without leaving the form.
💰 Cost basis of incoming units — for Adjustments and Asset Transfers

When an Adjustment adds units, or on the receiving side of an Asset Transfer, the form asks what those units cost:

  • Auto — LibreFolio computes it as a Weighted Average Cost; press ⚡ Validate now to see it.
  • Manual — you type it.

In Auto, the average is taken at the sending broker of a transfer, or at the adjustment's own broker. If that broker has no other transaction in the asset up to the date the units come in, there is nothing to average, and the cost is 0 by design: if those units did cost something, open the transaction later and type their cost in Manual. In Manual, the field cannot stay empty: LibreFolio flags the row and saves nothing until you fill it in or switch to Auto. Type 0 only for units that really cost nothing, such as the new shares of a stock split; for a gift, type the donor's original cost. If an exchange rate is missing, the Sync FX rates link fetches it.

🏷️ Transaction types

The Financial Theory guide explains each type in depth.

🧾 Single transactions

Type What it records Theory
Buy Units of an asset bought, and the total paid 📖 Read
Sell Units of an asset sold, and the total received 📖 Read
Dividend Cash paid by an asset you hold 📖 Read
Interest Interest received, with or without an asset 📖 Read
Deposit Cash you put into the broker 📖 Read
Withdrawal Cash you take out of the broker 📖 Read
Fee A commission or another cost, optionally tied to an asset 📖 Read
Tax A tax paid, optionally tied to an asset 📖 Read
Adjustment Units added or removed without cash: a split, a gift, a position opened elsewhere 📖 Read

🔗 Paired transactions

A paired operation is recorded as two linked transactions, which the form shows as one, with a From and a To side. Each side has its own date, and the Swap sides arrow turns the direction around.

Type What it records Theory
Asset Transfer Units of one asset moved between two of your brokers 📖 Read
Cash Transfer Cash moved between two of your brokers, in one currency 📖 Read
Currency Exchange One currency converted into another, inside one broker 📖 Read

A transfer needs two different brokers, an exchange two different currencies. Two single rows can also be linked into a pair later, and a pair split back — see Link or unlink a pair.