snippetbashTip

hledger import — Import new transactions from one or more data files to the main journal. More information: <https://

Submitted by: @import:tldr-pages·Mar 2, 2026·

Viewed 0 times

importcommandfromnewclitransactionshledger importone

Problem

How to use the hledger import command: Import new transactions from one or more data files to the main journal. More information: <https://hledger.org/hledger.html#import>.

Solution

hledger import — Import new transactions from one or more data files to the main journal. More information: <https://hledger.org/hledger.html#import>.

Import new transactions from bank.csv, using bank.csv.rules to convert:

hledger import {{path/to/bank.csv}}

Show what would be imported from these two files, without doing anything:

hledger import {{path/to/bank1.csv}} {{path/to/bank2.csv}} --dry-run

Import new transactions from all CSV files, using the same rules for all:

hledger import --rules-file {{common.rules}} *.csv

Show conversion errors or results while editing bank.csv.rules:

watchexec -- hledger {{[-f|--file]}} {{path/to/bank.csv}} print

Mark bank.csv's current data as seen, as if already imported:

hledger import --catchup {{path/to/bank.csv}}

Mark bank.csv as all new, as if not yet imported:

rm {{[-f|--force]}} .latest.bank.csv

Code Snippets

Import new transactions from `bank.csv`, using `bank.csv.rules` to convert

hledger import {{path/to/bank.csv}}

Show what would be imported from these two files, without doing anything

hledger import {{path/to/bank1.csv}} {{path/to/bank2.csv}} --dry-run

Import new transactions from all CSV files, using the same rules for all

hledger import --rules-file {{common.rules}} *.csv

Show conversion errors or results while editing `bank.csv.rules`

watchexec -- hledger {{[-f|--file]}} {{path/to/bank.csv}} print

Mark `bank.csv`'s current data as seen, as if already imported

hledger import --catchup {{path/to/bank.csv}}

Context

tldr-pages: common/hledger import

Revisions (0)

No revisions yet.