Basic Settings

The basic settings are where you can setup everything you need to define your company.

The settings search is a great way to find settings that are configured in multiple places. If you search for email, color or any other term you’ll find all of the relevant settings.

Company Details

Settings found here relate to the currently selected company, from the company selection drop-down widget in the top left corner of the admin portal UI. Select the company you want to view settings for. The Company Details section is where you configure your address, upload your company logo and also set your company defaults.


Any data entered in this first box of custom fields will all appear as your company's details section, in most default invoice layouts and other records. Emails and websites will be clickable links in PDFs.

Any data entered in here is generally for reference purposes in the admin portal, and don't appear on default documents.


On most default invoices and other documents, you also see all of the data entered in these fields as well. These fields should all be self explanatory, and apply to most if not all businesses in any country.


Image uploaded here will be saved in the public/storage directory like other uploaded files. The company logo image will appear on default invoice layouts, and in the company selection widget in the top left corner of the Admin Portal UI.

The image you select should be 300x300 for best results, and there are no restrictions to the size of the file you upload, but it will cause issues with PDF invoices easily if you do not follow the standard 300x300 pixel resolution practice for logos.


The defaults are system wide - company level defaults, this will applied at every level of the application they refer to.


Upload company documents here. These are not used automatically on any documents, and are only accessible from the admin portal. Documents stored here will also appear in the "public/storage" directory on the web server, implying that files stored here should not be considered truly secure, and this storage location is best reserved for template forms, notices, blank agreements, policy handouts, etc.

User Details

The User Details section covers account settings for the currently logged in user. A user's details help identify them among your team, help your teammates contact each other, and is relevant in Invoice Ninja if you are assigning users to tasks, projects, clients, or etc as a practice for organization and accountability.



Email notifications can be configured here for your user account. You can setup email events to notify you of almost any variety of record change event, whether an invoice, quote, payment, or credit, was viewed, approved, paid, failed, late, sent, created, etc.

You can choose to set notifications to one of three option levels:

Also, the All Events category can be used to quickly set notification levels of every category to the same thing all at once.



Here you can set some server-wide settings for Invoice Ninja that will be applied to the text formatting on all records generated PDF documents.

Custom Labels

In the custom labels section, you are able to reformat the descriptive text labels used in all your document templates. This is a useful feature to add custom language settings to your documents manually.

You have a list to maintain of custom labels. Adding a custom label, such as "Item", will add it to your list on the left column, and in the right column next to "Item" you will see a text-entry field for the text you want to replace "Item" with. For example "Line Item", or "UPC". This replaces the text used on all your invoices, and etc.

Edit, or create a new invoice, credit, etc, in order to see the changes to the text labels applied across your documents now.

Payment Settings

You may configure payment gateways, and payment rules/behaviors from here.

Configure Payment Gateways

Integrating your Invoice Ninja account with a payment gateway allows clients to pay their invoices with 1-click!

The payment gateway processes the transaction in the background while your client never leave their Invoice Ninja client-side portal. Seamless!

Please see: Payment Gateways

Tax Settings

In this section we can configure some of the default settings for taxes applied to either entire invoices, or products themselves only. Tax rates are expressed in % values only.


You can accidentally double charge taxes if you apply tax rates on the flat balance of an invoice, and on the individual products in the invoice themselves. If there is a separate tax for certain products you sell, that might be where this could apply.

Configure Rates - A simple Tax Rates settings panel to manage tax rates applicable to your company. Tax rates configured here are selectable from the Tax and Tax Rate drop down menus on invoices and products. You add a tax rate with the "+" button in the bottom right panel, and simply add a name, and tax rate expressed in percent only.

Product Settings

These options govern the behaviors and rules related to Products either when editing the products directly, or interacting with them on invoices, quotes, etc.

Task Settings

Settings here govern the rules and behaviors related to tasks, which are nested in projects.

These rules strictly govern

Configure Statuses - This button enters another settings panel for "Task Statuses" which manages a list of selectable statuses for tasks, for example: Backlog, Ready to do, In Progress, and Done. All there is to configure for a task status, is the name of the status, and an indicator color.

Expense Settings

These rules govern default settings and behaviors of your company's expense records.

Each of these settings below can be configured on a per-expense record basis, when creating or editing an expense. Changing these settings here will change the default configuration for new expense records.

Configure Categories - This button enters a subsetting panel for "Expense Categories". Here, you can manage a simple list (Name, and Color fields only) for expense categories. This can help you organize your expenses more effectively, by assigning an expense category to each of your expenses.

Import | Export

Here, you have many options for file formats to import your company records from.


CSV formatted records can be imported only. CSV file imports must be done per-category, and not all in one large file.

You will have to manually select matching categories for some entries in the CSV after it is uploaded, because older or other software may not use the same labels.

The expected formatting of the CSV document is to have a single row with all the column categories, followed by a row for each entry.

When importing your CSV document, verify that the column on the left matches your column labels from the CSV file, and that the column in the middle matches the first row underneath the column labels of your CSV file. Then on the right, select the most accurate label available from Invoice Ninja to associate those values with the new label upon import.


A full company backup can be generated via the Export option. This will schedule a job which will export all settings and data and compress it into a .zip file for download. When the job has been completed an email is sent with a download link (Download links expire daily).

The data can be transported to another installation, or used to overwrite an existing company dataset.

If you do not wish to overwrite the current company and instead import the dataset as a NEW company you must create a new company first prior to importing as this will overwrite the current company!

When importing JSON you have the option to import only settings or data or both.

Note on the hosted platform, the company importer will perform a preflight check to ensure your dataset is importable. If your plan does not have sufficient resources (ie. multiple users or client limit is reached), the importer will fail and you will be notified via email of the exact issue.

Device Settings

These settings govern the settings for the session or instance on the physical device you are currently signed into. On a new device, these settings will not apply.

Account Management

The Account Management panel mostly governs the account for your company on the server, status with Invoice Ninja licensing, and API configurations for developers interested in automation.


From this tab you have a few different things presented to you.

First are things related to your company's status, or terms with Invoice Ninja

Second, are all developer resources for automation features.

Third, are the most dangerous and serious buttons! Make sure you know what you are doing!

Enabled Modules

Tick boxes here enable and disable entire modules for the company. Disabling a category or two like "Projects" and "Tasks" will remove them from the menu sidebar on the righthand-side and hide them and all their existing records, until you re-enable the module again.


Security Settings

Configure some simple server account security settings for logged in users.

Want to contribute? Edit this page on GitHub!