The GnuCash Preferences window allows you to customize your
session by setting several options. From the
( → on MacOS).
The GnuCash Preferences window will open.
Using the tabs on the left make your desired changes. The settings in
this dialog are set per user and not stored with the file. This is
in contrast to the settings described in Section 10.3, “Book Options”,
which are kept with, and are part of, the file (or Book), and as such are
common to all users. So GnuCash Preferences settings are
individual to each user who uses a given file and any changes made by one
user will not affect other users of that file. Also, a given user's
preferences will be common to all files that that user opens with
Pausing the cursor for a couple of seconds over options in these windows will display a tooltip with in-depth information on the choice.
The changes you make will be applied at once.
To close the GnuCash Preferences window press the button.
Each tab in the GnuCash Preferences window is
discussed in its own section below. For a listing of the tabs, see
Chapter 10, Customizing
The presentation of the sections that follows matches the order of the tabs, which are sorted alphabetically by name, in English. The order of the tabs may be different in other languages.
Start Date: This item sets the accounting period’s start date.
Relative: Use the specified relative starting date for profit/loss calculations. Also use this date for net assets calculations. Relative defines start by today or start of current/previous year, quarter, month.
Absolute: Use the specified absolute starting date for profit/loss calculations. Also use this date for net assets calculations.
End Date: This item sets the accounting period’s end date.
Relative: Use the specified relative ending date for profit/loss calculations. Also use this date for net assets calculations.
Absolute: Use the specified absolute ending date for profit/loss calculations. Also use this date for net assets calculations.
Include grand total: If checked, show in the Summarybar a grand total of all accounts converted to the default currency.
Include non-currency totals: if this
option is selected,
GnuCash will include in the Summarybar a total
for non-currency items (for instance number of shares).
Separator Character: The account separator is the character that separates a parent account from its sub-account, for example Utilities:Electric. The default is a : (Colon), but you can also select / (Slash), \ (Backslash), - (Dash) or . (Period), or any Unicode character that isn’t a letter or a number.
Reverse Balanced accounts: This option lets you determine whether account balances will display as positive or negative numbers:
Income & Expense assigns a
positive credit balance to income account balances and a
negative debit balance to expense account balances. See
Section 5.1, “Types of
GnuCash Accounts” for more information
on these account types.
Credit accounts (default) displays
a positive balance for account types that would normally carry
a credit balance (income, credit, liability, equity). See
Section 5.1, “Types of
GnuCash Accounts” for more information on
these account types.
None shows all credit balances as negative and all debit balances as positive.
Labels: Select this option if you want column headings in the register to refer to debits and credits instead of the default informal headings such as withdrawal and deposit.
Default Currency: This item determines which currency will be selected by default when creating new accounts.
Locale: Use the system locale currency for all newly created accounts.
Choose: specify the currency to use, independent of your system settings.
Account Color: This option lets you manage the display of the account color set in the Edit Account window:
Show the Account Colors as background: show the accounts color as account name background in the Accounts Page.
Show the Account Colors on tabs: show the accounts color as background in the account register tabs.
Enable extra buttons: If checked, extra toolbar buttons for common business functions are shown.
Open in new window: If checked, each invoice will be opened in its own top level window. If clear, the invoice will be opened in the current window.
Accumulate splits on post: Whether multiple entries in an invoice which transfer to the same account should be accumulated into a single split by default.
Report for printing: Allows to select the invoice report to be used for printing.
Tax Included: Whether tax is included by default in entries on invoices. This setting is inherited by new customers and vendors.
Auto pay on posting: If enabled, at post time automatically attempt to pay customer documents with outstanding pre-payments and counter documents.
Counter documents are documents with opposite sign. For example for an invoice, customer credit notes and negative invoices are considered counter documents.
The pre-payments and documents obviously have to be against the same customer.
Notify when due: Lets you set whether
you want to be notified at
of when a bill is soon to be due.
Days in advance: How many days before the due date to warn about bills coming due.
Tax Included: Whether tax is included by default in entries on bills. This setting is inherited by new customers and vendors.
Process payments on posting: If enabled, at post time automatically attempt to pay vendor documents with outstanding pre-payments and counter documents.
Counter documents are documents with opposite sign. For example for a bill, vendor credit notes and negative bills are considered counter documents.
The pre-payments and documents obviously have to be against the same vendor.
Use 24-hour clock: Lets you specify if you want to use 24 or 12 hours time format. That is if 11 o’clock at night should be represented as 11PM or 23:00.
Date Format: This option controls the appearance of the date (you can see a preview of the date beside each of the choices). The available choices are:
US: Use the date format common in the United States.
UK: Use the date format common in the United Kingdom.
Europe: Use the date format common in continental Europe.
ISO: Use the date format specified by the ISO-8601 standard.
Locale: Use the date format specified by the system locale.
Date completion: This option lets you manage the case when a date is entered without a year:
In the current calendar year: (Default) Dates will be completed so that they are within the current calendar year.
In a sliding 12-month window starting a configurable number of months before the current month: Dates will be completed so that they are close to the current date. You can enter the maximum number of months to go backwards in time when completing dates.
Display "Tip of the Day" dialog: This option displays or hides the
Tip of the Day screen when
GnuCash is started.
Show splash screen: With this option you
can enable or disable the visualization of the startup screen while
GnuCash is starting up.
Perform account list setup on new file:
This option turns off the display of the New Account
Hierarchy Setup assistant when the entry → is selected from the
Set book option on new files to use split "action" field for "Num" field on registers/reports: If selected, the displayed setting on the New Book Options dialog for the Use Split Action Field for Number setting will be selected and, if saved, the book option for the new file will be set so that the "Num" field on registers shows/updates the split-action field and the transaction-num field is shown on the second line in double line mode (and is not visible in single line mode). Otherwise, the displayed setting on the dialog will not be selected and, if saved, the book option for the new file will be set so that the "Num" field on registers shows/updates the transaction-num field. See the discussion in Section 10.3, “Book Options” about how to set book options including the option for Section 10.3.1.3, “Use Split Action Field for Number”. Regardless of the setting of this preference, the user can modify the initially displayed setting for this option on the New Book Options dialog before saving the options.
If the New Book Options dialog appears in situations where a new book is being set up, the settings from this preference will determine the default setting for the corresponding check box on the dialog. However, the button on the New Book Options dialog must be pressed for the setting to be made for the new book; otherwise it will default to not selected.
Display negative amounts in red: If you
turn off this option,
GnuCash will display negative numbers in
Automatic Decimal Point: This option will automatically insert a decimal point into numbers you type in.
When a calculation is entered in the Amount field, the decimal sign is inserted into every operand that omits a decimal separator.
Decimal Places: This field allows you to set the number of decimal places to be used.
The following options are only relevant for files saved in XML format.
Compress files: This option determines
GnuCash data file will be compressed or not.
Show auto-save confirmation question:
If this option is enabled,
GnuCash will show you a confirmation screen
each time the auto-save process is started.
Auto-save time interval: This field sets the number of minutes between each automatic saving of the file. Set to 0 to disable the auto-save feature.
Enable timout on "Save changes on closing" question: If enabled, the Save changes on closing question will only wait a limited number of seconds for an answer. If the user didn’t answer within that time, the changes will be saved automatically and the question window closed. You can set the number of seconds in the Time to wait for answer field.
Retain log files: In this section you can set your preferences about the log files using the provided radio buttons.
Never: Disable the creation of log files.
For: Enter a specific number of days for which keep the files.
Forever: Disable the auto deletion of log files; retains the log files forever.
New search limit: Defaults to "new search" if fewer than this number of items is returned.
Show documentation: The first time you use the QIF importer you may notice that the importer has detailed instructions on how to import a file. Once you have become familiar with using the importer, you might want to turn off this option. Turning off the option gives you less detail in the importer screens.
Default transaction status (overridden by the status given by the QIF file): In this section you can set the default status for imported transactions using the provided self-explainingradio buttons:
Not cleared (Default)
Enable skip transaction action: Enable the SKIP action in the transaction matcher. If enabled, a transaction whose best match’s score is in the yellow zone (above the Auto-ADD threshold but below the Auto-CLEAR threshold) will be skipped by default.
Enable update match action: Enable the UPDATE AND RECONCILE action in the transaction matcher. If enabled, a transaction whose best match’s score is above the Auto-CLEAR threshold and has a different date or amount than the matching existing transaction will cause the existing transaction to be updated and cleared by default.
Use Bayesian matching: Use Bayesian algorithms to match new transactions with existing accounts.
Match display threshold: The minimal score a potential match must have to be displayed in the match list.
Auto-add threshold: A transaction whose best match’s score is in the red zone (above display threshold, but below or equal to Auto-add threshold) will be added by default.
Auto-clear threshold: A transaction whose best match’s score is in the green zone (above or equal to Auto-clear threshold) will be cleared by default.
Commercial ATM fees threshold:
In some places commercial ATMs (not
belonging to a financial institution) are installed in places like convenience
stores. These ATMs add their fee directly to the amount instead of showing up as a
separate transaction or in your monthly banking fees. For example, you withdraw
$100, and you are charged $101.50 plus Interac fees. If you manually entered
that $100, the amounts won’t match. You should set this to whatever is the
maximum such fee in your area (in units of your local currency), so the
transaction will be recognized as a match by
Automatically create new commodities: Enables the automatic creation of new commodities if any unknown commodity is encountered during import. If not enabled, the user will be asked what to do with each unknown commodity.
This section is shown only if
Close log window when finished: Close the log window when the operation is completed.
Remember PIN: Enable this option if you
GnuCash to remember the PIN you
enter for online banking authentication.
Verbose debug messages: Enable this option if you
GnuCash to show more information about the online
The Online Quotes tab allows you to set options
that affect the fetching of online quotes with the
Alpha Vantage API key: To retrieve online quotes from Alphavantage, this key needs to be set. A key can be retrieved from the Alpha Vantage website.
“Automatic Updating Exchange Rates” in the guide.
The Printing tab allows you to set some options that affect the printing of checks on paper.
Print date format: Enable this option if you want to print on the check, below the actual date, its format in 8 point type.
Print blocking chars: Enable this option to print a series of three asterisks before and after each text field in the check.
Default font: Click the button on the left to open a Pick a Font screen in which you can customize the font that will be used to print checks.
'Enter' moves to blank transaction: If selected, move the cursor to the blank transaction at the end of the register after the user presses the Enter key. Otherwise the cursor will be moved down one row.
Auto-raise lists: If selected, all lists will automatically be expanded when input focus is in the list field.
Tab order includes Transfer on Memorised Transaction: If selected, when the transaction is auto filled, pressing the Tab key in the register the cursor’s jump will include the Transfer field.
Check cleared transactions: If selected, automatically check off cleared transactions when reconciling.
Automatic interest transfer: If selected, prior to reconciling an account which charges or pays interest, prompt the user to enter a transaction for the interest charge or payment. Currently only enabled for Bank, Credit, Mutual, Asset, Receivable, Payable, and Liability accounts.
Automatic credit card payment: If selected, after reconciling a credit card statement, prompt the user to enter a credit card payment.
Always reconcile to today: If selected, always open the reconcile screen with today’s date for statement date, regardless of previous reconciliation.
Use GnuCash built-in color theme: If selected,
GnuCash register color theme will be used.
Otherwise the system color theme will be applied to register windows.
Double mode colors alternate with transactions: If selected, configures the register window to alternate between the primary and secondary colors with each transaction, instead of each row.
Draw horizontal lines between rows: If
GnuCash will draw a horizontal line between each
Draw vertical lines between columns: If
GnuCash will draw a vertical line between the cells in
The Register Defaults tab preferences affect the behavior of the transaction register windows.
Here you can choose from 3 different styles for register windows:
Basic ledger: Show all transactions on one line. (Two in double line mode.)
Auto-split ledger: Automatically expand the current transaction to show all splits. All other transactions are shown on one line. (Two in double line mode.)
Transaction journal: All transactions are expanded to show all splits.
Register opens in a new window: If selected, register will be in a separate window instead of in a tab.
Double line mode: If selected, show two lines of information for each transaction instead of one.
Only display leaf account names: If selected, only the name of the leaf accounts will be displayed in the Account selection popup. The default behavior is to display the full account name including the path in the account tree.
Enabling this option implies that you use unique leaf account names.
Number of transactions: How many transactions to show in a register. Set to 0 to show all transactions.
The Reports tab preferences affect
the behavior of
Default Report Currency: This item determines which currency will be used by default when creating reports. You can choose:
Locale: Use the system locale currency for all newly created reports.
Choose: Use the specified currency for all newly created reports.
Report opens in a new window: if you select this option, the reports will open up in a new window, instead of in a tab.
The Scheduled Transactions tab
preferences affect the behavior of
GnuCash for scheduling transactions.
More information about scheduled transactions can be found in
Section 6.12, “Scheduling Transactions”.
Since Last Run Dialog
Run when data file opened: If selected,
the Since Last Run screen will appear when
GnuCash opens the file.
Show notification window: If selected,
a list of scheduled and created transactions will appear when
GnuCash opens the file.
Transaction Editor Defaults
Auto-Create new transactions: If selected, new scheduled transactions will automatically be entered into the register. If the auto-create option is enabled, you can also check Notify before transactions are created so that you will be able to confirm creating the transactions.
Create in advance: The default number of days in advance to create the registered scheduled transactions.
Remind in advance: The default number of days in advance to remind about new scheduled transactions.
Save window size and position: If
selected, next time
GnuCash starts it will re-use the window size
and position configured in the last run.
Show close button on notebook tabs: Adds a small close icon on each tab, to make it easier to close the various tabs.
Bring the most recent tab to the front: If selected, the newly created tab will be shown over the other tabs.
Width: The width of tab label expressed in characters.
If the text in the tab is longer than this value (the test is approximate) then the tab label will have the middle cut and replaced with an ellipsis.
Position the tabs at the Top (default), Bottom, Left or Right.
Summary Bar Position
Position the Summary Bar at the
Top or at the Bottom (default) of
GnuCash main window.