Skip to main content

NetBox Data Import Plugin

CI Coverage License Python NetBox

A NetBox plugin for importing device inventory and rack layouts from external DCIM systems via configurable field mappings.

Overview

This plugin allows you to:

  • Define import profiles that configure how your source data (Excel) maps to NetBox objects
  • Configure field mappings per column with transformation rules
  • Define class/role mappings to translate your source system's device categories to NetBox roles
  • Synchronize a mapped primary contact into native NetBox Contacts and Contact Assignments
  • Preview the import before applying changes
  • Run imports in the background, track processed rows, and resume the progress page

Currently supports importing from Excel (.xlsx) workbooks with a flat, one-row-per-device layout. The mapping configuration is stored in NetBox, so it can be reused and adapted for other source formats.

Requirements

  • NetBox ≥ 4.6.9
  • Python ≥ 3.12

Cable trace import verifies each pass-through against the PortMapping model, which replaced the single rear-port reference on a front port in NetBox 4.5. The plugin supports NetBox 4.6.9 and later.

Installation

pip install netbox-data-import

Add to PLUGINS in your NetBox configuration:

PLUGINS = ["netbox_data_import"]

License

Apache-2.0 — see LICENSE.

Metadata

Release files for netbox-data-import 2.16.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for netbox-data-import 2.16.0
File Size Uploaded Provenance
netbox_data_import-2.16.0.tar.gz 1.1 MB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for netbox-data-import 2.16.0
File Interpreter ABI Platform
netbox_data_import-2.16.0-py3-none-any.whl Python 3 none any Details

Total release size: 2.3 MB

Release files / netbox_data_import-2.16.0.tar.gz

Download URL netbox_data_import-2.16.0.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
05342f824ce881c1cbf66fb89c04cb3034134fb4c3c13cb71ece907aea076e49
BLAKE2b-256 checksum
How to use checksums
682df0199a9f332c46f035a564d5a9d4d6bbd1080290d75e1ac10860b890fa01
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

Release files / netbox_data_import-2.16.0-py3-none-any.whl

Download URL netbox_data_import-2.16.0-py3-none-any.whl
Size 1.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
41f5efe9021bc2dde67db494406c9547ecbd295aadff53abc649cf720a3de9c0
BLAKE2b-256 checksum
How to use checksums
a09df52d0c41622cadf597d7dcaf02921b29496b6d6fb7807f279b50a19cc295
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

Security for netbox-data-import 2.16.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for netbox_data_import-2.16.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Release history Release notifications | RSS feed

This release

2.16.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page