Continuing on from the thread
https://lists.gnucash.org/pipermail/gnucash-user/2025-November/118164.html

My concern is the GnuCash CSV Importer UI and docs are confusing because
the terminology is not clear and the Account field (for single-line mode)
appears before the Multi-split checkbox decision point that determines the
import mode.

Single-line mode (one line = one transaction, two accounts):
* Source Account: Set once in the assistant or via CSV column
* Transfer Account: CSV column or Import Matcher (defaults to Imbalance)

Multi-line mode (one line = one split, 2+ accounts):
* All data per-line; no common Account field
* Groups consecutive lines by identical/blank transaction info (Date,
Description, etc.)

Every transaction needs: Date, Description, Amount(s), Account(s).

Single-line/Multi-line terms are equivalent to Simple/Split Transaction
terms used in the Guide for 2/2+ accounts respectively and also related to
Register View styles for Basic Ledger and Transaction Journal.

References:
*
https://github.com/Gnucash/gnucash/blob/stable/gnucash/gtkbuilder/assistant-csv-trans-import.glade#L46-L55
*
https://github.com/Gnucash/gnucash/blob/stable/gnucash/gtkbuilder/assistant-csv-trans-import.glade#L527-L530

----------------

Proposed UI changes:

1. Rename Multi-split to Multi-line
2. Move Account field under Multi-line checkbox
3. Dim/disable Account field when Multi-line enabled
4. Update tooltip-text
5. Update documentation to describe

Multi-linetooltip-text:

* Disable: Each CSV line is one complete transaction.
* Enable: Multiple consecutive lines form one transaction. Each line
provides details for a single account or split, and the first line must
include the main transaction information such as Date and Description.

The importer groups consecutive lines into the same transaction until it
finds a line where any transaction‑specific field (Transaction ID, Date,
Number, Description, Notes, Transaction Commodity, or Void Reason) contains
different, non‑empty information.
Accounttooltip-text:

Apply a single source account to all imported transactions. The other side
of the transaction can be provided in a Transfer Account column, or left
for the Import Matcher to assign.

Regards

>
_______________________________________________
gnucash-user mailing list
[email protected]
To update your subscription preferences or to unsubscribe:
https://lists.gnucash.org/mailman/listinfo/gnucash-user
-----
Please remember to CC this list on all your replies.
You can do this by using Reply-To-List or Reply-All.

Reply via email to