Change Logging
Every time an object in NetBox is created, updated, or deleted, a serialized copy of that object taken both before and after the change is saved to the database, along with metadata including the current time and the user associated with the change. These records form a persistent record of changes both for each individual object as well as NetBox as a whole. The global change log can be viewed by navigating to Other > Change Log.
Contact Groups
Contacts can be organized into arbitrary groups. These groups can be recursively nested for convenience. Each contact within a group must have a unique name, but other attributes can be repeated.
Contact Roles
Contacts can be organized by functional roles, which are fully customizable by the user. For example, you might create roles for administrative, operational, or emergency contacts.
Contacts
Much like tenancy, contact assignment enables you to track ownership of resources modeled in NetBox. A contact represents an individual responsible for a resource within the context of its assigned role.
Contacts
A contact represents an individual or group that has been associated with an object in NetBox for administrative reasons. For example, you might assign one or more operational contacts to each site.
Database Models
Creating Models
Default Value Parameters
DEFAULT_DASHBOARD
Forms
Form Classes
index
NetBox
Internationalization
Beginning with NetBox v4.0, NetBox will leverage Django's automatic translation to support languages other than English. This page details the areas of the project which require special attention to ensure functioning translation support. Briefly, these include:
Microsoft Entra ID
This guide explains how to configure single sign-on (SSO) support for NetBox using Microsoft Entra ID as an authentication backend.
Migrating Your Plugin to NetBox v4.0
This document serves as a handbook for maintainers of plugins that were written prior to the release of NetBox v4.0. It serves to capture all the changes recommended to ensure a plugin is compatible with NetBox v4.0 and later releases.
NetBox Development
Thanks for your interest in contributing to NetBox! This introduction covers a few important things to know before you get started.
NetBox Models
Model Types
NetBox v2.11
v2.11.12 (2021-08-23)
NetBox v2.3 Release Notes
v2.3.7 (2018-07-26)
NetBox v2.4 Release Notes
v2.4.9 (2018-12-07)
NetBox v2.8
v2.8.9 (2020-08-04)
NetBox v2.9
v2.9.11 (2020-12-11)
NetBox v3.1
v3.1.11 (2022-04-05)
NetBox v3.2
v3.2.9 (2022-08-16)
NetBox v3.4
v3.4.10 (2023-04-27)
NetBox v3.6
v3.6.9 (2023-12-28)
NetBox v3.7
v3.7.8 (2024-05-06)
NetBox v4.0
v4.0.11 (2024-09-03)
NetBox v4.3
v4.3.4 (2025-07-15)
REST API Overview
What is a REST API?
Reverting a Branch
Once a branch has been merged, it is generally no longer needed, and can no longer be activated. However, occasionally you may find it necessary to undo the changes from a branch (due to an error or an otherwise undesired state). This can be done by reverting the branch. Only merged branches can be reverted.
Tenancy
Most core objects within NetBox's data model support tenancy. This is the association of an object with a particular tenant to convey ownership or dependency. For example, an enterprise might represent its internal business units as tenants, whereas a managed services provider might create a tenant in NetBox to represent each of its customers.
Tenant Groups
Tenants can be organized by custom groups. For instance, you might create one group called "Customers" and one called "Departments." The assignment of a tenant to a group is optional.
Tenants
A tenant represents a discrete grouping of resources used for administrative purposes. Typically, tenants are used to represent individual customers or internal departments within an organization.