Global Settings

Global Settings

InvenTree ships with a lot of dynamic settings which can be configured at run-time. These settings are stored in the InvenTree database itself.

The following settings are global settings which affect all users.

Staff Status Required

Only users with staff status can view and edit global settings

To edit global settings, select Settings from the menu in the top-right corner of the screen.

Global settings are arranged in the following categories:

Server Settings

Configuration of basic server settings.

Setting	Type	Description	Default
InvenTree Instance Name	String	String descriptor for the InvenTree server instance	InvenTree Server
Use Instance Name	Boolean	Use instance name in title bars	False
Restrict showing about	Boolean	Show the about modal only to superusers	False
Base URL	String	Base URL for server instance	blank
Company Name	String	Company name	My company name
Download from URL	Boolean	Allow downloading of images from remote URLs	False

Login Settings

Change how logins, password-forgot, signups are handled.

Setting	Type	Description	Default
Enable registration	Boolean	Enable self-registration for users on the login-pages	False
Enable SSO	Boolean	Enable SSO on the login-pages	False
Enable SSO registration	Boolean	Enable self-registration for users via SSO on the login-pages	False
Enable password forgot	Boolean	Enable password forgot function on the login-pages. This will let users reset their passwords on their own. For this feature to work you need to configure E-mail	True
E-Mail required	Boolean	Require user to supply e-mail on signup. Without a way (e-mail) to contact the user notifications and security features might not work!	False
Enforce MFA	Boolean	Users must use multifactor security. This forces each user to setup MFA and use it on each authentication	False
Mail twice	Boolean	On signup ask users twice for their mail	False
Password twice	Boolean	On signup ask users twice for their password	True
Auto-fill SSO users	Boolean	Automatically fill out user-details from SSO account-data. If this feature is enabled the user is only asked for their username, first- and surname if those values can not be gathered from their SSO profile. This might lead to unwanted usernames bleeding over.	True
Allowed domains	String	Restrict signup to certain domains (comma-separated, starting with @)

Barcodes

Configuration of barcode functionality

Setting	Type	Description	Default
Barcode Support	Boolean	Enable barcode functionality in web interface	True

Currencies

Configuration of currency support

Setting	Type	Description	Default
Default Currency	Currency	Default currency	USD

Reporting

Configuration of report generation

Setting	Type	Description	Default
Enable Reports	Boolean	Enable report generation	False
Page Size	String	Default page size	A4
Debug Mode	Boolean	Generate reports in debug mode (HTML output)	False
Test Reports	Boolean	Enable generation of test reports	False

Parts

Main Settings

Setting	Type	Description	Default
IPN Regex	String	Regular expression pattern for matching Part IPN	blank
Allow Duplicate IPN	Boolean	Allow multiple parts to share the same IPN	True
Allow Editing IPN	Boolean	Allow changing the IPN value while editing a part	True
Part Name Display Format	String	Format to display the part name	{{ part.id if part.id }}{{ ' | ' if part.id }}{{ part.name }}{{ ' | ' if part.revision }}{{ part.revision if part.revision }}
Show Price History	Boolean	Display historical pricing for Part	False
Show Price in Forms	Boolean	Display part price in some forms	True
Show Price in BOM	Boolean	Include pricing information in BOM tables	True
Show related parts	Boolean	Display related parts for a part	True
Create initial stock	Boolean	Create initial stock on part creation	True

Creation Settings

Setting	Type	Description	Default
Template	Boolean	Parts are templates by default	False
Assembly	Boolean	Parts can be assembled from other components by default	False
Component	Boolean	Parts can be used as sub-components by default	True
Trackable	Boolean	Parts are trackable by default	False
Purchaseable	Boolean	Parts are purchaseable by default	True
Salable	Boolean	Parts are salable by default	False
Virtual	Boolean	Parts are virtual by default	False

Copy Settings

Setting	Type	Description	Default
Copy Part BOM Data	Boolean	Copy BOM data by default when duplicating a part	True
Copy Part Parameter Data	Boolean	Copy parameter data by default when duplicating a part	True
Copy Part Test Data	Boolean	Copy test data by default when duplicating a part	True
Copy Category Parameter Templates	Boolean	Copy category parameter templates when creating a part	True

Internal Price Settings

Setting	Type	Description	Default
Internal Prices	Boolean	Enable internal prices for parts	False
Internal Price as BOM-Price	Boolean	Use the internal price (if set) in BOM-price calculations	False

Part Import Setting

This section of the part settings allows staff users to:

• import parts to InvenTree clicking the Import Part button
• enable the "Import Parts" tab in the part category view.

Setting	Type	Description	Default
Show Import in Views	Boolean	Display the import wizard in some part views	True

Part Parameter Templates

Refer to the section describing how to create part parameter templates.

Categories

In this section of the settings, staff users can set a list of parameters associated to a part category.

To add a parameter to a part category:

1. select the category in the dropdown list
2. click the New Parameter button on the top right
3. fill out the "Create Category Parameter Template" form
4. click the Submit button.

After a list of parameters is added to a part category and upon creation of a new part in this category, this list of parameters will be added by default to the new part.

Stock

Configuration of stock item options

Setting	Type	Description	Default
Stock Expiry	Boolean	Enable stock expiry functionality	False
Stock Stale Time	Days	Number of days stock items are considered stale before expiring	90
Sell Expired Stock	Boolean	Allow sale of expired stock	False
Build Expired Stock	Boolean	Allow building with expired stock	False
Stock Ownership Control	Boolean	Enable ownership control functionality	False

Build Orders

Options for build orders

Setting	Type	Description	Default
Reference Pattern	String	Pattern for defining Build Order reference values	BO-{ref:04d}

Purchase Orders

Options for purchase orders

Setting	Type	Description	Default
Reference Pattern	String	Pattern for defining Purchase Order reference values	PO-{ref:04d}

Sales orders

Options for sales orders

Setting	Type	Description	Default
Reference Pattern	String	Pattern for defining Sales Order reference values	SO-{ref:04d}

Plugin Settings

Change into what parts plugins can integrate into.

Setting	Type	Description	Default
Enable URL integration	Boolean	Enable plugins to add URL routes	False
Enable navigation integration	Boolean	Enable plugins to integrate into navigation	False
Enable setting integration	Boolean	Enable plugins to integrate into inventree settings	False
Enable app integration	Boolean	Enable plugins to add apps	False