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.7.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.7.0
File Size Uploaded
netbox_data_import-2.7.0.tar.gz 846.5 kB Details

Built distribution (wheel)

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

Total release size: 1.8 MB

Release files / netbox_data_import-2.7.0.tar.gz

Download URL netbox_data_import-2.7.0.tar.gz
Size 846.5 kB
Tags Source
SHA-256 checksum
How to use checksums
34db2e7573da8bd120def3215f8317543bc24dd664a928a66b0bd721f6462531
BLAKE2b-256 checksum
How to use checksums
e577106e01972298fe3ad82d2e3d23a8b183d1bce88cd0a26d3a103968bb9e06
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 Sep 30, 2026.

Transparency log

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

Download URL netbox_data_import-2.7.0-py3-none-any.whl
Size 989.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2ee7b0946f67c097c124474d26b3681d79ffca2105b5a5526faddb59094a3d85
BLAKE2b-256 checksum
How to use checksums
ebaa6bedc2a2e05eb6b4adb18139037414e906e36715314cd54fab175e6ba6fc
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 Sep 30, 2026.

Transparency log

Release history Release notifications | RSS feed

2.15.0

2 release files

2.14.0

2 release files

2.13.0

2 release files

2.9.0

2 release files

2.8.0

2 release files

This release

2.7.0 This release

2 release files

2.6.0

2 release files

2.5.0

2 release files

2.4.0

2 release files

2.3.0

2 release files

2.2.0

2 release files

2.1.0

2 release files

2.0.0

2 release files

1.11.0

2 release files

1.10.0

2 release files

1.9.0

2 release files

1.8.0

2 release files

1.7.0

2 release files

1.6.1

2 release files

1.6.0

2 release files

1.5.2

2 release files

1.5.1

2 release files

1.5.0

2 release files

1.4.2

2 release files

1.4.1

2 release files

1.4.0

2 release files

1.3.1

2 release files

1.3.0

2 release files

1.2.3

2 release files

1.2.2

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.0

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

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