Skip to content

A local-first personal finance app

Update Reconciliation document to current UI - follows #6220 (#6225)

Juulz52d013cb8655
diff --git a/packages/docs/docs/accounts/reconciliation.md b/packages/docs/docs/accounts/reconciliation.md
index 16b623e6c9..d07ee7bc83 100644
--- a/packages/docs/docs/accounts/reconciliation.md
+++ b/packages/docs/docs/accounts/reconciliation.md
@@ -1,52 +1,77 @@
# Reconciliation
-Keeping your Actual account ledgers consistent with your bank ledgers is important to maintain a healthy budget and know exactly how much currency is available to spend. Some choose to reconcile monthly, weekly, or even daily. Actual provides the Reconciliation tool to help manage this process.
+Keeping your Actual account ledgers consistent with your bank ledgers is important to maintain a healthy budget and know exactly how much currency is available to spend. Some choose to reconcile monthly, weekly, or even daily. Actual provides a Reconciliation tool to help manage this process.
## Work Flow
-When you reconcile, you will be comparing your bank statement, print or online, against Actual's ledger for that account. If you have made transactions against the budget that have not been verified against your account the **cleared** flag will be shown in gray. If the transaction has been moved out of the pending section of your (online) bank statement, click the gray circle to turn it green. This is a visual indication that the transaction is in both your budget and in your account statement, and they match.
+When you reconcile, you compare your bank statement, print or online, against Actual's ledger for that account. If you have transactions in Actual that have not been verified against your bank account the **cleared** flag will be shown in gray (pending). If the transaction is finalized (cleared) on your bank statement, click the gray circle to turn it green. This is a visual indication that the transaction is in both your budget and in your account statement, and they match.
-By clicking on the green balance in the header of the account view, two more category balances will come into view. The **cleared total** only includes transactions that have been cleared while the **uncleared total** will represent the transactions you have entered but may not have entered the bank statement yet.
+Click on the green balance in the header of the account view to bring two more category balances into view. The **cleared total** only includes transactions that have been matched to the bank while the **Uncleared total** shows the sum of the transactions that aren't yet matched to the bank statement.
-![](/img/reconcile/reconcile-1.png)
+![Image of all totals in account header](/img/reconcile/reconcile-1.png)
## Starting the Reconciliation Tool
-Click the πŸ”’ lock icon in the top right-hand corner of the account ledger.
+Click the πŸ”’ lock icon in the top right-hand corner of the account ledger. Notice that the last date the account was reconciled is shown on hover.
-![](/img/reconcile/reconcile-2.png)
+![Image of lock icon](/img/reconcile/reconcile-2-2025.png)
-Let's imagine that we have just checked our account balance for our Ally Savings account and the current balance is 3012.13. We enter the balance we want to match into the Reconciliation tool and press **Reconcile**.
+Let's imagine that you checked your account balance for Chase Amazon and the current balance is -310.80. The tool will default to the **Cleared total**. Enter the balance you want to match into the Reconciliation tool and click **Reconcile**.
-![](/img/reconcile/reconcile-3.png)
+:::tip
-The tool will tell us exactly how much is different than the budget ledger. Now we can check the Actual ledger against the bank ledger and watch the difference come closer to 0 as you change the cleared status of transactions. In this case, we're looking for transactions that add up to 324.82. This is much easier by looking at the Actual ledger and bank statement side by side to match the transactions.
+Remember to use a negative number for the balance on credit or loan accounts
-![](/img/reconcile/reconcile-4.png)
+:::
-When the cleared amount of the Actual account ledger and the value you entered into the Reconciliation tool are the same, the tool will let you know that you are reconciled and you can press done.
+![Image of reconcile box with no bank sync](/img/reconcile/reconcile-3-2025.png)
-![](/img/reconcile/reconcile-5.png)
+Or, if you use certain bank sync providers, the last synced balance will be shown. You can use that balance by clicking the **Use last synced total** button.
-Upon pressing done, all cleared transactions will receive a lock icon. This represents the fact that they were included in a reconciliation and makes it harder to accidentally change.
+![Image of reconcile box with bank sync](/img/reconcile/reconcile-3a-2025.png)
-![](/img/reconcile/reconcile-6.png)
+The tool will tell you exactly what the difference is between the bank statement and your Actual ledger. Click the gray circles as you match each Actual transaction to the bank ledger and watch the difference come closer to 0 as you change the status of each transaction to green (cleared). In the example, the cleared transactions need to add up to -82.60 This is much easier if you look at the Actual ledger and bank statement side by side to match the transactions.
-Of course, there's always the possibility you need to change a locked transaction. You can click on the lock of any transaction to open a dialog to unlock it.
+![Image of tool with nonmatching balance](/img/reconcile/reconcile-4-2025.png)
-![](/img/reconcile/reconcile-7.png)
+When the cleared amount of the Actual account ledger and the value entered into the Reconciliation tool are the same, the tool will let you know that you are _All reconciled!_ Click on the **Lock transactions** button to complete the reconciliation and lock the cleared transactions. If you want to leave reconciling for a later time, click **Exit reconciliation** to cancel.
+
+:::warning
+
+If you fail to click the **Lock transactions** button after the _All reconciled!_ message appears, you will not change the status of the cleared transactions to locked.
+
+:::
+
+![Image of All reconciled](/img/reconcile/reconcile-5-2025.png)
+
+
+![Image of newly locked transactions](/img/reconcile/reconcile-6-2025.png)
+
+If you ever need to unlock a transaction. Click on the lock of any transaction to open a dialog to unlock it. After you unlock a transaction this way, the status will revert to "Cleared". A reconcile will need to be performed to re-lock the transaction.
+
+![Image of unlock transaction box](/img/reconcile/reconcile-7.png)
+
+If you try to edit a locked transaction, the following warning will appear. Click **Confirm** to proceed. Once confirmed, the edit will be made and the transaction will remain locked.
+
+![Image of unlock transaction box](/img/reconcile/reconcile-12.png)
## Using the Reconciliation Tool for Off Budget Asset Tracking
-Some people use off budget accounts to track values of assets such as vehicles, real estate, retirement accounts, or other investment accounts or property. The reconciliation tool is useful to update these values as well. Let's say we have a house that was valued at 367,800 but with current changes in the market it is now valued at 385,000. We go to the ledger for the house, choose the reconciliation tool, and enter 385,000 as the new value into the tool.
+Off budget accounts can easily be used to track values of assets such as vehicles, real estate, retirement accounts, or other investment accounts or property. The reconciliation tool is useful to update these values using the **Create reconciliation transaction** button.
+
+For example, on 10-Nov-2025, my house was valued at 231,100 then some houses sold in my neighborhood and a few days later it was valued at 234,600. Go to the House Asset account, choose the reconciliation tool, and enter 234600 as the new value into the tool.
+
+![Image of asset reconcile box](/img/reconcile/reconcile-8-2025.png)
+
+The tool tells us that we have a gain of 3,500.
+
+![Image of Create transaction](/img/reconcile/reconcile-9-2025.png)
-![](/img/reconcile/reconcile-8.png)
+Click on the **Create reconciliation transaction** button to easily create a new transaction that automatically brings the value of the asset in line with the new valuation. Now the reconciliation tool reports that it is _All reconciled!_ Click the **Lock transactions** button to complete the task.
-The tool tells us that we have a gain of 17,200.
+![Image of created transaction All reconciled](/img/reconcile/reconcile-10-2025.png)
-![](/img/reconcile/reconcile-9.png)
+![Image of created transaction locked](/img/reconcile/reconcile-11-2025.png)
-We can use the "Create reconciliation transaction" button to easily create a new transaction that brings the value of the account in line with the new valuation. You should now have a reconciliation tool that is reporting that it is finished and you can enjoy a new higher net worth.
-![](/img/reconcile/reconcile-10.png)
diff --git a/packages/docs/static/img/reconcile/reconcile-10-2025.png b/packages/docs/static/img/reconcile/reconcile-10-2025.png
new file mode 100644
index 0000000000..3159a19c80
Binary files /dev/null and b/packages/docs/static/img/reconcile/reconcile-10-2025.png differ
diff --git a/packages/docs/static/img/reconcile/reconcile-11-2025.png b/packages/docs/static/img/reconcile/reconcile-11-2025.png
new file mode 100644
index 0000000000..00b34fdd8c
Binary files /dev/null and b/packages/docs/static/img/reconcile/reconcile-11-2025.png differ
diff --git a/packages/docs/static/img/reconcile/reconcile-12.png b/packages/docs/static/img/reconcile/reconcile-12.png
new file mode 100644
index 0000000000..72ead46639
Binary files /dev/null and b/packages/docs/static/img/reconcile/reconcile-12.png differ
diff --git a/packages/docs/static/img/reconcile/reconcile-2-2025.png b/packages/docs/static/img/reconcile/reconcile-2-2025.png
new file mode 100644
index 0000000000..c0b5d6b7ca
Binary files /dev/null and b/packages/docs/static/img/reconcile/reconcile-2-2025.png differ
diff --git a/packages/docs/static/img/reconcile/reconcile-3-2025.png b/packages/docs/static/img/reconcile/reconcile-3-2025.png
new file mode 100644
index 0000000000..5c4758aeae
Binary files /dev/null and b/packages/docs/static/img/reconcile/reconcile-3-2025.png differ
diff --git a/packages/docs/static/img/reconcile/reconcile-3a-2025.png b/packages/docs/static/img/reconcile/reconcile-3a-2025.png
new file mode 100644
index 0000000000..e25b0a3d0b
Binary files /dev/null and b/packages/docs/static/img/reconcile/reconcile-3a-2025.png differ
diff --git a/packages/docs/static/img/reconcile/reconcile-4-2025.png b/packages/docs/static/img/reconcile/reconcile-4-2025.png
new file mode 100644
index 0000000000..c83fcda33c
Binary files /dev/null and b/packages/docs/static/img/reconcile/reconcile-4-2025.png differ
diff --git a/packages/docs/static/img/reconcile/reconcile-5-2025.png b/packages/docs/static/img/reconcile/reconcile-5-2025.png
new file mode 100644
index 0000000000..f56e36dcfa
Binary files /dev/null and b/packages/docs/static/img/reconcile/reconcile-5-2025.png differ
diff --git a/packages/docs/static/img/reconcile/reconcile-6-2025.png b/packages/docs/static/img/reconcile/reconcile-6-2025.png
new file mode 100644
index 0000000000..8ebfa3aae9
Binary files /dev/null and b/packages/docs/static/img/reconcile/reconcile-6-2025.png differ
diff --git a/packages/docs/static/img/reconcile/reconcile-8-2025.png b/packages/docs/static/img/reconcile/reconcile-8-2025.png
new file mode 100644
index 0000000000..55cd1ae617
Binary files /dev/null and b/packages/docs/static/img/reconcile/reconcile-8-2025.png differ
diff --git a/packages/docs/static/img/reconcile/reconcile-9-2025.png b/packages/docs/static/img/reconcile/reconcile-9-2025.png
new file mode 100644
index 0000000000..f03aaafee5
Binary files /dev/null and b/packages/docs/static/img/reconcile/reconcile-9-2025.png differ