> ## Documentation Index
> Fetch the complete documentation index at: https://docs.guito.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Costs and income

> Record the rent, running costs and improvements of an asset and see its net income and an annualised return that includes them.

On each asset's page, the **Costs and income** section gathers the money the asset brings in and what it costs you after you bought it: the rent on a flat, the service charge and property tax, the car's insurance and inspection, the work done on the house. With these records, the **Summary** card shows the asset's net income and an annualised return that takes the rent and costs into account. You find the section in **Property & valuables** (`/properties`), when you open an asset.

## What you can record

Each record has a **Type**, and each type belongs to one of three groups. The group decides which figure the record counts in:

* **Income** goes into the net income: the rent you receive, the money from renting out the car.
* **Running costs** come off the net income: what you pay to keep the asset, such as the service charge, taxes, insurance and repairs.
* **Improvements** add to what the asset cost: what makes it better or bigger than it was when you bought it.

The types depend on the asset's category:

| Asset | Income | Running costs | Improvements |
| - | - | - | - |
| Property | Rent, Other income | Service charge, Property tax, Insurance, Repair or upkeep, Other cost | Renovation or improvement |
| Vehicle | Rental, Other income | Insurance, Road tax, Inspection, Repair or service, Other cost | Upgrade |
| Other assets, such as jewellery or art | Other income | Insurance, Storage or safekeeping, Repair or restoration, Other cost | Improvement |

You can give each record a **Description**, for example "Rent, 2nd floor flat" or "New kitchen". Without one, the record shows the name of its type.

A repair is a running cost, not an improvement: it puts the asset back as it was, it doesn't make it better. Fuel, tolls and parking aren't cost types either, because they are the cost of using the car, not of owning it.

> [!NOTE]
>
> In Portugal, when working out the capital gain on selling a property, improvement works from the 12 years before the sale count, but ordinary upkeep does not. That's why improvements and repairs sit in different groups.

## Add a cost or income

**1. Open the asset**

In **Property & valuables**, open the asset and, in the **Costs and income** section, click **Add**.

**2. Choose the type**

In **Type**, choose what you are recording. The list is organised by the three groups.

**3. Enter the amount, the date and the account**

Fill in the **Amount** and the **Date**. For a cost, choose in **Paid with** the account the money left; for income, in **Received in**, the account it reached. If you paid in cash without a wallet in guito, or from an account you don't have in guito, choose **None**: the record stays on this asset only.

**4. Link the transaction**

In **Transaction**, link the record to the account's transaction (see below). Add a **Description** if you like and click **Add**.

What **Transaction** offers depends on the account you chose:

> [tab] Synced account
>
> Choose **One transaction** or **Recurring**.
>
> With **One transaction**, if the payment already shows up in the account, for the same amount and close to that date, the transaction is filled in and tagged **Suggestion**. If it's the wrong one, click it to look for another, or choose **No transaction**. The record always counts the amount you typed: linking the transaction only confirms it is the same money, it doesn't count it twice.
>
> If the date is before the transactions you already have from that account in guito, you see **We can't see this transaction in your account yet.** The record is saved and the transaction can be linked later.
>
> With **Recurring**, part of Plus, choose one of that account's [recurring transactions](https://docs.guito.app/en/features/recurring.md), such as the rent you receive every month or the service charge. Every transaction of that recurring payment counts, the upcoming ones too: each new payment starts counting on the asset as soon as it reaches your account. If you leave Plus, the transactions that already counted keep counting, but new ones are no longer added.

> [tab] Cash wallet
>
> Choose **Existing transaction**, to link one you already recorded in the wallet, or **New transaction**, so the payment also shows up in the wallet's transactions. The line underneath says what happens, for example "Adds €600.00 to the Cash balance and counts in your March 2026 income."
>
> When guito finds a transaction in the wallet for the same amount and close to that date, it starts on **Existing transaction**, with that transaction chosen. **New transaction** is only possible from the wallet's first day.

> [tab] Other manual account
>
> You can link a transaction you already recorded in that account. You can't create a new one in a bank account you keep by hand: once you connect it to the bank or import a statement, the same payment would show up twice.

If the transaction or the recurring payment you chose matches records you had already entered by hand, guito warns you that you already have records for that money. Click **Replace** so the hand-entered records go and the same money doesn't count twice.

### When the transaction arrives later

If you entered a record with an account in **Paid with** or **Received in** before the transaction reached that account, guito looks for it when new transactions are imported:

* If it finds a single transaction that can only belong to that record, it links it, and the record's line shows **automatic**.
* If the match isn't clear, a card appears above the list, for example "Was this the payment for Boiler?" with the debit, its date and the account. Click **Yes, link it** to link it, or **No** so it isn't suggested again. When there are several, they come as a pile: you answer one at a time, and the card shows how far along you are (for example, "1 of 5"). From four onwards, **See all** opens the full list.

## Edit or delete a record

Click a record in the list to open it. You can change its type, amount, date, account and description, then click **Save**. To take a transaction off the record, for example one linked automatically that wasn't the right one, click **Unlink**: that transaction won't be linked to this record again. To remove the record, click **Delete**.

## Link from a transaction

You can also start from the transaction. Open it in **Transactions**, open the options menu (⋯) and choose **Link to an asset**. Choose the asset, then the type: money coming in can only be income, and money going out can only be a cost or an improvement. Under **Add to**, you can add it to a record you already have, for example one more invoice for the same renovation.

The transaction's details then show **Linked to** with the asset's name, which takes you to it, and the type beside it. To undo it, open the transaction's options menu (⋯) and choose **Unlink from the asset**. If it was the record's only transaction, the record also leaves the asset.

## Link a recurring payment

On Plus, you can link a whole [recurring transaction](https://docs.guito.app/en/features/recurring.md) to an asset. On its page, open the options menu (⋯), choose **Link to an asset**, then the asset and the type. Every transaction of that recurring payment counts on the asset, the ones already paid or received and the upcoming ones. Its details show **Linked to** with the asset and the type, and **Unlink** to undo it.

## Transactions stay in your accounts

Linking a transaction to an asset doesn't change it. The money really did come in or leave your account, so the transaction still counts in **Transactions**, in your cash flow and in your [budgets](https://docs.guito.app/en/features/budgets.md). The asset simply shows that money too.

## What the figures mean

The page's figures follow the chart's period at the top: **1Y** shows the last 12 months, **All** everything since the purchase, and you can also pick a range. Each record and each group in **Costs and income** shows the sum for that period, and a group with nothing in it disappears. For example, on **1Y** works done two years ago don't show.

### How much the asset gained

The chart at the top shows the asset's value, and the change beside it shows how much it gained over the period; on **All**, it says "since the start". The total cost line on the chart is what you paid plus the improvements.

Improvements only count after a valuation made after them. A valuation from before the work can't include it, and the value you entered when creating the asset is just the purchase price. For example, you bought a house for €200,000 and did €20,000 of work in March. If you value it at €250,000 in June, it gained €30,000. Until you record a valuation after the work, the **Summary** card shows **No valuation since the works** under **Improvements**, with an **Add valuation** button.

### The Summary card

The **Summary** card shows:

* **Acquisition cost**, **Improvements** and **Total cost**, the two added together.
* **Net income**: income minus running costs, over the chart's period. For example, a flat let for €700 a month, with €1,800 of service charge, property tax and insurance over the past year, has a net income of €6,600 on **1Y**. If your records start after the period does, **Records from** and the month of the first one appear.
* **Annualised return**: how much the asset earned on average per year since the purchase. Once you have rent or costs recorded, it counts them too and shows **Includes rent and costs**.
* **Holding period**.

The **Annualised return** doesn't change with the chart's period: it describes the asset since the purchase. If your records start long after the purchase, for example a flat bought in 2010 with records only from 2025, counting only the last few years of rent would make it look like a poor deal. In that case the return counts the value only and says what is missing, for example **Value only: records from 2010 to 2024 are missing**. Record the missing years so it counts the rent and costs. If you've owned the asset for only a short time, you see **Insufficient period**.

### Assets that earn nothing

A car for personal use or the home you live in earn nothing, they only cost. In that case, the **Summary** card shows **Running costs** for the period instead of the net income, and also **Cost of owning the car**, **Cost of owning the property** or **Cost of owning the asset**: the loss in value and the running costs added together.

## Loans stay out

A loan's interest isn't a running cost of the asset. If the asset has a [linked loan](https://docs.guito.app/en/features/credits.md), the **Financing** section shows **Interest paid**, noted **Estimated from the plan**, but that amount doesn't go into the net income or the annualised return.

Loan instalments can't be linked to an asset either: the loan already counts them, and counting them on the asset would take the same money off twice. In the same way, a transaction you linked to an asset isn't used as a loan instalment.

## In the Property & valuables list

In the **Property & valuables** list, the **Return** and **% Return** columns show how much each asset has gained, with improvements counted the same way. When an asset has income or running costs recorded, an **Annual income** column also appears, with each asset's net income over the last 12 months.

## FAQ

> [accordion] I recorded improvements, but the asset didn't gain any value. Why?
>
> Improvements only count after a valuation made after them. Click **Add valuation** and enter the asset's current value so they start counting.

> [accordion] Why did a record disappear from the list?
>
> The list shows the chart's period. A record from before that period doesn't show. Choose **All** on the chart to see every record since the purchase.

> [accordion] I linked a transaction to an asset. Does it stop counting in my spending?
>
> No. The transaction still counts in **Transactions**, in your cash flow and in your budgets. The asset simply shows it too.

> [accordion] Why can't I link my mortgage instalment to the house?
>
> The instalment already counts in the loan. The interest shows as an estimate in the asset's **Financing** section and stays out of the net income.

> [accordion] Why does the annualised return count the value only?
>
> Because your rent and cost records start long after the purchase. Record the missing years and the return starts counting them.

> [accordion] Can I change a record from a cost to income?
>
> Yes, but if the record has linked transactions, unlink them first: money coming in can't be a cost, and money going out can't be income.

## Related pages

> [card] [Properties and assets](https://docs.guito.app/en/features/properties-and-assets.md)
>
> The assets you own, with their valuations and archiving.

> [card] [Loans](https://docs.guito.app/en/features/credits.md)
>
> Loans and mortgages, including those linked to a property.

> [card] [Recurring transactions](https://docs.guito.app/en/features/recurring.md)
>
> Payments and income that repeat, such as rent or the service charge.

> [card] [Transactions](https://docs.guito.app/en/features/transactions.md)
>
> Your accounts' transactions, where you can also link one to an asset.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.