The version of these settings

This is used internally to determine whether some preferences may need conversion when switching to a newer version of GnuCash. true

Save window sizes and locations

If active, the size and location of each dialog window will be saved when it is closed. The sizes and locations of content windows will be remembered when you quit GnuCash. Otherwise the sizes will not be saved. 'colon'

Character to use as separator between account names

This setting determines the character that will be used between components of an account name. Possible values are any single non-alphanumeric unicode character, or any of the following strings: "colon", "slash", "backslash", "dash" and "period". ''

Transaction Linked Files head path

This is the path head for the Transaction Linked Files with relative paths true

Compress the data file

Enables file compression when writing the data file. true

Show auto-save explanation

If active, GnuCash shows an explanation of the auto-save feature the first time that feature is started. Otherwise no extra explanation is shown. 5

Auto-save time interval

The number of minutes until saving of the data file to harddisk will be started automatically. If zero, no saving will be started automatically. false

Enable timeout 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. 20

Time to wait for answer

The number of seconds to wait before the question window will be closed and the changes saved automatically. true

Display negative amounts in red

Display negative amounts in red false

Automatically insert a decimal point

If active, GnuCash will automatically insert a decimal point into values that are entered without one. Otherwise GnuCash will not modify entered numbers. 2

Number of automatic decimal places

This field specifies the number of automatic decimal places that will be filled in. false

Force prices to display as decimals even if they must be rounded.

If active, GnuCash will round prices as necessary to display them as decimals instead of displaying the exact fraction if the fractional part cannot be exactly represented as a decimal. false

Do not create log/backup files.

This setting specifies what to do with old log/backups files. "forever" means keep all old files. "never" means no old log/backup files are kept. Each time you save, older versions of the file are removed. "days" means keep old files for a number of days. How many days is defined in key 'retain-days' true

Delete old log/backup files after this many days (0 = never).

Do not delete log/backup files.

Delete old log/backup files after this many days (0 = never)

This setting specifies the number of days after which old log/backup files will be deleted (0 = never). false

Don't sign reverse any accounts.

This setting allows certain accounts to have their balances reversed in sign from positive to negative, or vice versa. The setting "income-expense" is for users who like to see negative expenses and positive income. The setting of "credit" is for users who want to see balances reflect the debit/credit status of the account. The setting "none" doesn't reverse the sign on any balances. true

Sign reverse balances on the following: Credit Card, Payable, Liability, Equity, and Income.

Sign reverse balances on income and expense accounts.

Use account colors in the account hierarchy

If active the account hierarchy will colorize the account using the account's custom color if set. This can serve as a visual aid to quickly identify accounts. false

Use account colors in the tabs of open account registers

If active the account register tabs will be colored using the account's custom color if set. This can serve as a visual aid to quickly identify accounts. false

Use formal account labels

If active, formal accounting labels "Credit" and "Debit" will be used when designating fields on screen. Otherwise, informal labels such as Increase/Decrease, "Funds In"/"Funds Out", etc. will be used. true

Show close buttons on notebook tabs

If active, a "close" button will be displayed on any notebook tab that may be closed. Otherwise, no such button will be shown on the tab. Regardless of this setting, pages can always be closed via the "close" menu item or the "close" button on toolbar. 30.0

Width of notebook tabs

This key specifies the maximum width of notebook tabs. 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. true

Opens new tab adjacent to current tab instead of at the end

If active, new tabs are opened adjacent to current tab. If inactive, the new tabs are opened instead at the end. true

Use the system locale currency for all newly created accounts.

This setting controls the source of the default currency for new accounts. If set to "locale" then GnuCash will retrieve the default currency from the user's locale setting. If set to "other", GnuCash will use the setting specified by the currency-other key. false

Use the specified currency for all newly created accounts.

Default currency for new accounts

This setting specifies the default currency used for new accounts if the currency-choice setting is set to "other". This field must contain the three letter ISO 4217 code for a currency (e.g. USD, GBP, RUB). false

Use 24 hour time format

If active, use a 24 hour time format. Otherwise use a 12 hour time format. 4

Date format choice

This setting chooses the way dates are displayed in GnuCash. Possible values for this setting are "locale" to use the system locale setting, "ce" for Continental Europe style dates, "iso" for ISO 8601 standard dates , "uk" for United Kingdom style dates, and "us" for United States style dates. false

In the current calendar year

When a date is entered without year it can be completed so that it will be within the current calendar year or close to the current date based on a sliding window starting a set number of months backwards in time. true

In a sliding 12-month window starting a configurable number of months before the current month

Maximum number of months to go back.

Dates will be completed so that they are close to the current date. Enter the maximum number of months to go backwards in time when completing dates. false

Show Horizontal Grid Lines

If active, horizontal grid lines will be shown on table displays. Otherwise no horizontal grid lines will be shown. false

Show Vertical Grid Lines

If active, vertical grid lines will be shown on table displays. Otherwise no vertical grid lines will be shown. true

Show splash screen

If active, a splash screen will be shown at startup. Otherwise no splash screen will be shown. true

Display the notebook tabs at the top of the window.

This setting determines the edge at which the tabs for switching pages in notebooks are drawn. Possible values are "top", "left", "bottom" and "right". It defaults to "top". false

Display the notebook tabs at the bottom of the window.

This setting determines the edge at which the tabs for switching pages in notebooks are drawn. Possible values are "top", "left", "bottom" and "right". It defaults to "top". false

Display the notebook tabs at the left of the window.

This setting determines the edge at which the tabs for switching pages in notebooks are drawn. Possible values are "top", "left", "bottom" and "right". It defaults to "top". false

Display the notebook tabs at the right of the window.

This setting determines the edge at which the tabs for switching pages in notebooks are drawn. Possible values are "top", "left", "bottom" and "right". It defaults to "top". false

Display the summary bar at the top of the page.

This setting determines the edge at which the summary bar for various pages is drawn. Possible values are "top" and "bottom". It defaults to "bottom". true

Display the summary bar at the bottom of the page.

This setting determines the edge at which the summary bar for various pages is drawn. Possible values are "top" and "bottom". It defaults to "bottom". false

Closing a tab moves to the most recently visited tab.

If active, closing a tab moves to the most recently visited tab. Otherwise closing a tab moves one tab to the left. false

Set book option on new files to use split "action" field for "Num" field on registers/reports

If selected, the default book option for new files is set so that the 'Num' cell 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 default book option for new files is set so that the 'Num' cell on registers shows/updates the transaction 'num' field. true

Color the register using a gnucash specific color theme

When enabled the register will use a GnuCash specific color theme (green/yellow). Otherwise it will use the system color theme. Regardless of this setting the user can always override the color theme via a gnucash specific css file to be stored in the gnucash used config directory. More information can be found in the gnucash FAQ. false

Superseded by "use-gnucash-color-theme"

This option is temporarily kept around for backwards compatibility. It will be removed in a future version. false

"Enter" key moves to bottom of register

If active, pressing the enter key will move to the bottom of the register. Otherwise pressing the enter key will move to the next transaction line. true

Automatically raise the list of accounts or actions during input

Automatically raise the list of accounts or actions during input false

Move to Transfer field when memorised transaction auto filled

If active then after a memorised transaction is automatically filled in the cursor will move to the Transfer field. If not active then it skips to the value field. false

Create a new window for each new register

If active, each new register will be opened in a new window. Otherwise each new register will be opened as a tab in the main window. false

Color all lines of a transaction the same

If active all lines that make up a single transaction will use the same color for their background. Otherwise the background colors are alternated on each line. true

Show horizontal borders in a register

Show horizontal borders between rows in a register. If active the border between cells will be indicated with a heavy line. Otherwise the border between cells will not be marked. true

Show vertical borders in a register

Show vertical borders between columns in a register. If active the border between cells will be indicated with a heavy line. Otherwise the border between cells will not be marked. false

Show future transactions after the blank transaction in a register

Show future transactions after the blank transaction in a register. If active then transactions with a date in the future will be displayed at the bottom of the register after the blank transaction. Otherwise the blank transaction will be at the bottom of the register after all transactions. true

Show all transactions on one line or in double line mode on two.

This field specifies the default view style when opening a new register window. Possible values are "ledger", "auto-ledger" and "journal". The "ledger" setting says to show each transaction on one or two lines. The "auto-ledger" setting does the same, but also expands only the current transaction to show all splits. The "journal" setting shows all transactions in expanded form. false

Automatically expand the current transaction to show all splits. All other transactions are shown on one line or in double line mode on two.

All transactions are expanded to show all splits.

Show a second line with "Action", "Notes", and "Linked Documents" for each transaction.

Show a second line with "Action", "Notes", and "Linked Documents" for each transaction in a register. This is the default setting for when a register is first opened. The setting can be changed at any time via the "View->Double Line" menu item. false

Only display leaf account names.

Show only the names of the leaf accounts in the register and in the account selection popup. The default behaviour is to display the full name, including the path in the account tree. Activating this option implies that you use unique leaf names. false

Show the entered and reconcile dates

Show the date when the transaction was entered below the posted date and reconciled date on split row. false

Show entered and reconciled dates on selection

Show the entered date and reconciled date on transaction selection. false

Show the calendar buttons

Show the calendar buttons Cancel, Today and Select. false

Move the selection to the blank split on expand

This will move the selection to the blank split when the transaction is expanded. 0.0

Number of transactions to show in a register.

Show this many transactions in a register. A value of zero means show all transactions. 2.0

Number of characters for auto complete.

This sets the number of characters before auto complete starts for description, notes and memo fields. false

Create a new window for each new report

If active, each new report will be opened in its own window. Otherwise new reports will be opened as tabs in the main window. true

Use the system locale currency for all newly created reports.

This setting controls the default currency used for reports. If set to "locale" then GnuCash will retrieve the default currency from the user's locale setting. If set to "other", GnuCash will use the setting specified by the currency-other key. false

Use the specified currency for all newly created reports.

Default currency for new reports

Zoom factor to use by default for reports.

On high resolution screens reports tend to be hard to read. This option allows you to scale reports up by the set factor. For example setting this to 2.0 will display reports at twice their typical size. '%1$s-%2$s-%3$s'

PDF export file name format

This setting chooses the file name for PDF export. This is a sprintf(3) string with three arguments: "%1$s" is the report name such as "Invoice". "%2$s" is the number of the report, which for an invoice report is the invoice number. "%3$s" is the date of the report, formatted according to the filename-date-format setting. Note: Any characters that are not allowed in filenames, such as '/', will be replaced with underscores '_' in the resulting file name. 'locale'

PDF export file name date format choice

This setting chooses the way dates are used in the filename of PDF export. Possible values for this setting are "locale" to use the system locale setting, "ce" for Continental Europe style dates, "iso" for ISO 8601 standard dates , "uk" for United Kingdom style dates, and "us" for United States style dates. false

Allow file incompatibility with older versions.

If active, gnucash will be allowed to intentionally break file compatibility with older versions, so that a data file saved in this version cannot be read by an older version again. Otherwise gnucash will write data files only in formats that can be read by older versions as well. (-1,-1,-1,-1)

Last window position and size

This setting describes the size and position of the window when it was last closed. The numbers are the X and Y coordinates of the top left corner of the window followed by the width and height of the window. (-1,-1,-1,-1)

Last window position and size

Position of the horizontal pane divider.

Position of the horizontal pane divider. (-1,-1,-1,-1)

Last window position and size

Search only in active items

This setting indicates whether to search in all items in the current class, or only in 'active' items in the current class. ''

Last pathname used

This field contains the last pathname used by this window. It will be used as the initial filename/pathname the next time this window is opened. ''

Last pathname used

This field contains the last pathname used by this window. It will be used as the initial filename/pathname the next time this window is opened. ''

Last pathname used

This field contains the last pathname used by this window. It will be used as the initial filename/pathname the next time this window is opened. ''

Last pathname used

This field contains the last pathname used by this window. It will be used as the initial filename/pathname the next time this window is opened. (-1,-1,-1,-1)

Last window position and size

Position of the horizontal pane divider.

Position of the horizontal pane divider. 200

Position of the vertical pane divider.

Position of the vertical pane divider. (-1,-1,-1,-1)

Last window position and size

Show the new user window

If active, the new user window will be shown. Otherwise it will not be shown. (-1,-1,-1,-1)

Last window position and size

New hierarchy window on "New File"

If active, the "New Hierarchy" window will be shown whenever the "New File" menu item is chosen. Otherwise it will not be shown. 1.0

Default to 'new search' if fewer than this number of items is returned

Default to 'new search' if fewer than this number of items is returned (-1,-1,-1,-1)

Last window position and size

Search only in active items

If active, only the 'active' items in the current class will be searched. Otherwise all items in the current class will be searched. (-1,-1,-1,-1)

Last window position and size

Search only in active items

If active, only the 'active' items in the current class will be searched. Otherwise all items in the current class will be searched. (-1,-1,-1,-1)

Last window position and size

Search only in active items

If active, only the 'active' items in the current class will be searched. Otherwise all items in the current class will be searched. (-1,-1,-1,-1)

Last window position and size

Search only in active items

If active, only the 'active' items in the current class will be searched. Otherwise all items in the current class will be searched. (-1,-1,-1,-1)

Last window position and size

Search only in active items

If active, only the 'active' items in the current class will be searched. Otherwise all items in the current class will be searched. (-1,-1,-1,-1)

Last window position and size

Search only in active items

If active, only the 'active' items in the current class will be searched. Otherwise all items in the current class will be searched. true

Is tax included in this type of business entry?

If set to active then tax is included by default in entries of this type. This setting is inherited by new customers and vendors. false

Auto pay when posting.

At post time, automatically attempt to pay customer documents with outstanding pre-payments and counter documents. The pre-payments and documents obviously have to be against the same customer. Counter documents are documents with opposite sign. For example for an invoice, customer credit notes and negative invoices are considered counter documents. true

Show invoices due reminder at startup

If active, at startup GnuCash will check to see whether any invoices will become due soon. If so, it will present the user with a reminder dialog. The definition of "soon" is controlled by the "Days in Advance" setting. Otherwise GnuCash does not check for due invoices. 7.0

Show invoices due within this many days

This field defines the number of days in advance that GnuCash will check for due invoices. Its value is only used if the "Notify when due" setting is active. false

Enable extra toolbar buttons for business

If active, extra toolbar buttons for common business functions are shown as well. Otherwise they are not shown. 0

The invoice report to be used for printing.

The name of the report to be used for invoice printing. false

Open new invoice in new window

If active, each new invoice will be opened in a new window. Otherwise a new invoice will be opened as a tab in the main window. true

Accumulate multiple splits into one

If this field is active then multiple entries in an invoice that transfer to the same account will be accumulated into a single split. This field can be overridden per invoice in the Posting dialog. true

Is tax included in this type of business entry?

If set to active then tax is included by default in entries of this type. This setting is inherited by new customers and vendors. false

Auto pay when posting.

At post time, automatically attempt to pay vendor documents with outstanding pre-payments and counter documents. The pre-payments and documents obviously have to be against the same vendor. Counter documents are documents with opposite sign. For example for a bill, vendor credit notes and negative bills are considered counter documents. true

Show bills due reminder at startup

If active, at startup GnuCash will check to see whether any bills will become due soon. If so, it will present the user with a reminder dialog. The definition of "soon" is controlled by the "Days in Advance" setting. Otherwise GnuCash does not check for due bills. 7.0

Show bills due within this many days

This field defines the number of days in advance that GnuCash will check for due bills. Its value is only used if the "Notify when due" setting is active. (-1,-1,-1,-1)

Last window position and size

GUID of predefined check format to use

This value specifies the predefined check format to use. The number is the guid of a known check format. 0

Which check position to print

On preprinted checks containing multiple checks per page, this setting specifies which check position to print. The possible values are 0, 1 and 2, corresponding to the top, middle and bottom checks on the page. 0

Number of checks to print on the first page.

Number of checks to print on the first page. 7

Date format to use

This is the numerical identifier of the predefined date format to use. '0'

Custom date format

If the date format is set to indicate a custom date format, this value is used as an argument to strftime to produce the date to be printed. It may be any valid strftime string; for more information about this format, read the manual page of strftime by "man 3 strftime". 0

Units in which the custom coordinates are expressed

Units in which the custom coordinates are expressed (inches, mm, ...). (0,0)

Position of payee name

This value contains the X,Y coordinates for the start of the payee line on the check. (0,0)

Position of date line

This value contains the X,Y coordinates for the start of the date line on the check. Coordinates are from the lower left corner of the specified check position. (0,0)

Position of check amount in words

This value contains the X,Y coordinates for the start of the written amount line on the check. Coordinates are from the lower left corner of the specified check position. (0,0)

Position of check amount in numbers

This value contains the X,Y coordinates for the start of the numerical amount line on the check. Coordinates are from the lower left corner of the specified check position. (0,0)

Position of payee address

This value contains the X,Y coordinates for the start of the payee address line on the check. Coordinates are from the lower left corner of the specified check position. (0,0)

Position of notes line

This value contains the X,Y coordinates for the start of the notes line on the check. Coordinates are from the lower left corner of the specified check position. (0,0)

Position of memo line

This value contains the X,Y coordinates for the start of the memo line on the check. Coordinates are from the lower left corner of the specified check position. (0,0)

Offset for complete check

This value contains the X,Y offset for the complete check. Coordinates are from the lower left corner of the specified check position. 0.0

Rotation angle

Number of degrees to rotate the check. (0,0)

Position of split's amount in numbers

This value contains the X,Y coordinates for the start of the split's amount line on the check. Coordinates are from the lower left corner of the specified check position. (0,0)

Position of split's memo line

This value contains the X,Y coordinates for the start of the split's memo line on the check. Coordinates are from the lower left corner of the specified check position. (0,0)

Position of split's account line

This value contains the X,Y coordinates for the start of the split's account line on the check. Coordinates are from the lower left corner of the specified check position. false

Print the date format below the date.

Each time the date is printed, print the date format immediately below in 8 point type using the characters Y, M, and D. 'sans 10'

The default check printing font

The default font to use when printing checks. This value will be overridden by any font specified in a check description file. false

Print '***' before and after text.

Print '***' before and after text. (-1,-1,-1,-1)

Last window position and size

Show currencies in this dialog

Show currencies in this dialog (-1,-1,-1,-1)

Last window position and size

Last pathname used

This field contains the last pathname used by this window. It will be used as the initial filename/pathname the next time this window is opened. 0

Window geometry

The position of paned window when it was last closed. (-1,-1,-1,-1)

Last window position and size

Last pathname used

This field contains the last pathname used by this window. It will be used as the initial filename/pathname the next time this window is opened. true

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. true

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. true

Use bayesian matching

Enables bayesian matching when matching imported transaction against existing transactions. Otherwise a less sophisticated rule-based matching mechanism will be used. 1.0

Minimum score to be displayed

This field specifies the minimum matching score a potential matching transaction must have to be displayed in the match list. 4.0

Likely matching transaction within these days

This field specifies the maximum number of days a transaction is likely to be a match in the list. 14.0

UnLikely matching a transaction outside of these days

This field specifies the minimum number of days a transaction is unlikely to be a match in the list. 3.0

Add matching transactions below this score

This field specifies the threshold below which a matching transaction will be added automatically. A transaction whose best match's score is in the red zone (above the display minimum score but below or equal to the Add match score) will be added to the GnuCash file by default. 6.0

Clear matching transactions above this score

This field specifies the threshold above which a matching transaction will be cleared by default. A transaction whose best match's score is in the green zone (above or equal to this Clear threshold) will be cleared by default. 2.0

Maximum ATM fee amount in your area

This field specifies the extra fee that is taken into account when matching imported transactions. 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 recognised as a match. false

Automatically create new commodities

Enables the automatic creation of new commodities if any unknown commodity is encountered during import. Otherwise the user will be asked what to do with each unknown commodity. (-1,-1,-1,-1)

Last window position and size

Display or hide reconciled matches

Shows or hides transactions from the match picker which are already of some reconciled state. (-1,-1,-1,-1)

Last window position and size

Default QIF transaction status

Default status for QIF transaction when not specified in QIF file. false

Default QIF transaction status

Default status for QIF transaction when not specified in QIF file. false

When the status is not specified in a QIF file, the transactions are marked as reconciled.

Default status for QIF transaction when not specified in QIF file. (-1,-1,-1,-1)

Last window position and size

Last pathname used

This field contains the last pathname used by this window. It will be used as the initial filename/pathname the next time this window is opened. true

Show documentation

Show some documentation-only pages in QIF Import assistant. (-1,-1,-1,-1)

Last window position and size

Pre-select cleared transactions

If active, all transactions marked as cleared in the register will appear already selected in the reconcile dialog. Otherwise no transactions will be initially selected. false

Prompt for interest charges

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. true

Prompt for credit card payment

If active, after reconciling a credit card account, prompt the user to enter a credit card payment. Otherwise do not prompt the user for this. false

Always reconcile to today

If active, always open the reconcile dialog using today's date for the statement date, regardless of previous reconciliations. (-1,-1,-1,-1)

Last window position and size

Run "since last run" dialog when a file is opened.

This setting controls whether the scheduled transactions "since last run" processing is run automatically when a data file is opened. This includes the initial opening of the data file when GnuCash starts. If this setting is active, run the "since last run" process, otherwise it is not run. true

Show "since last run" notification dialog when a file is opened.

This setting controls whether the scheduled transactions notification-only "since last run" dialog is shown when a data file is opened (if "since last run" processing is enabled on file open). This includes the initial opening of the data file when GnuCash starts. If this setting is active, show the dialog, otherwise it is not shown. false

Set "Review Created Transactions" as the default for the "since last run" dialog.

This setting controls whether as default the "review created transactions" is set for the "since last run" dialog. false

Set the "auto create" flag by default

If active, any newly created scheduled transaction will have its 'auto create' flag set active by default. The user can change this flag during transaction creation, or at any later time by editing the scheduled transaction. 0

How many days in advance to notify the user.

How many days in advance to notify the user. (-1,-1,-1,-1)

Last window position and size

Set the "notify" flag by default

If active, any newly created scheduled transaction will have its 'notify' flag set by default. The user can change this flag during transaction creation, or at any later time by editing the scheduled transaction. This setting only has meaning if the create-auto setting is active. 0

How many days in advance to remind the user.

How many days in advance to remind the user. 0

The next tip to show.

The next tip to show. (-1,-1,-1,-1)

Last window position and size

Show "Tip Of The Day" at GnuCash start

Enables the "Tip Of The Day" when GnuCash starts up. If active, the dialog will be shown. Otherwise it will not be shown. ''

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. 4

Number of files in history

This setting contains the number of files to keep in the Recently Opened Files menu. This value may be set to zero to disable the file history. This number has a maximum value of 10. ''

Most recently opened file

This field contains the full path of the most recently opened file. ''