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/CSV) 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) files in the CANS format, with the mapping configuration stored in NetBox so it can be reused and adapted for other source formats.

Requirements

  • NetBox ≥ 4.6.0
  • 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 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.3.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.3.0
File Size Uploaded
netbox_data_import-2.3.0.tar.gz 688.2 kB Details

Built distribution (wheel)

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

Total release size: 1.5 MB

Release files / netbox_data_import-2.3.0.tar.gz

Download URL netbox_data_import-2.3.0.tar.gz
Size 688.2 kB
Tags Source
SHA-256 checksum
How to use checksums
8ba42bd5f601c96ef4cf44f701a45175e55cc74915c2a66020066c1e65dfc8eb
BLAKE2b-256 checksum
How to use checksums
d65398274a2957931ec16586f8a60f919e411c784a236dc589e6ac038f53b944
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 14, 2026.

Transparency log

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

Download URL netbox_data_import-2.3.0-py3-none-any.whl
Size 805.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b2b85d3be6a96e1410b8898211d03d3381d2ffb0b71f16e011e8c47c9ed50b41
BLAKE2b-256 checksum
How to use checksums
3a0d34a9ddf3eee5a2b93e6e2bb475b6516642b3e6eefd89205be72262cbf90b
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 14, 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

2.7.0

2 release files

2.6.0

2 release files

2.5.0

2 release files

2.4.0

2 release files

This release

2.3.0 This release

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