hledger Verified current stable Not installed? Data Processing

Hledger / Record New Transactions Default Journal

Record New Transactions Default Journal

Records new transactions in the default hledger journal for tracking expenses.

$
Terminal
hledger add

When To Use

During routine financial updates or new expenses entry events.

Pro Tip

Set `--quiet` to minimize output clutter during frequent transaction entries.

Anatomy of Output

Understanding the result

Transaction recorded: $100 for groceries Transaction Confirmation

Affirms successful entry of transaction.

Current balance: $1,450 Updated Balance

Displays balance after new entry.

Date: 2023-10-01 Transaction Date

Risks recording date alongside the transaction.

Power User Variants

Optimized versions

hledger add --quiet $50 'Utilities'

Record a transaction without verbose output.

hledger add today 'Dining Out' $30

Add a transaction with today's date.

Troubleshooting

Common pitfalls

Error: Invalid transaction format

Solution: Ensure input adheres to transaction formatting rules.

Access denied to journal for new entries

Solution: Check write permissions for the journal.

Missing required fields for transaction

Solution: Ensure all mandatory transaction details are provided.

Command Breakdown

What each part is doing

hledger
Base Command
The executable that performs this operation. Here it runs Hledger before the shell applies any redirect operators.

Alternative Approaches

Comparable commands in other tools

Alternative data processing tools for the same job.