Skip to content

A local-first personal finance app

added documentation for merging transactions (#678)

Alec Bakholdin48c41e80158e
diff --git a/docs-sidebar.js b/docs-sidebar.js
index 3302302c32..3ecb16bf00 100644
--- a/docs-sidebar.js
+++ b/docs-sidebar.js
@@ -164,6 +164,7 @@ const sidebars = {
items: ['budgeting/rules/custom'],
},
'transactions/importing',
+ 'transactions/merging',
'accounts/reconciliation',
'transactions/payees',
'transactions/bulk-editing',
diff --git a/docs/transactions/merging.md b/docs/transactions/merging.md
new file mode 100644
index 0000000000..b9fcbe5a82
--- /dev/null
+++ b/docs/transactions/merging.md
@@ -0,0 +1,13 @@
+# Merging Duplicate Transactions
+
+To merge two duplicate transactions, select two transactions with the same amount (e.g. two payments of 2 USD), then either use the 'M' shortcut or select the transaction menu dropdown in the top right and click merge. This option will only appear when exactly two matching transactions are selected.
+
+![Merge Transactions](/static/img/merging_transactions.png)
+
+When two transactions are merged, one is determined to be the 'kept' transaction and the other is the 'dropped' transaction. Any empty fields in the 'kept' transactions are copied over from the 'dropped' transaction and the 'dropped' transaction will be deleted. So, if the 'kept' transaction is uncategorized or has no payee, the payee and/or category will be copied over from the 'dropped' transaction before it is deleted.
+
+The following logic is used to determine which transaction is kept:
+
+1. If one transaction is imported through [bank sync](/docs/advanced/bank-sync) and the other is not, the synced transaction is kept. Otherwise, continue to the next step.
+2. If one transaction is imported through a [file import](/docs/transactions/importing) and the other is not, the imported transaction is kept. Otherwise, continue to the final step.
+3. The transaction with the earlier date is kept.
diff --git a/static/img/merging_transactions.png b/static/img/merging_transactions.png
new file mode 100644
index 0000000000..2518fbb24a
Binary files /dev/null and b/static/img/merging_transactions.png differ