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.2.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.2.0
File Size Uploaded
netbox_data_import-2.2.0.tar.gz 681.9 kB Details

Built distribution (wheel)

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

Total release size: 1.5 MB

Release files / netbox_data_import-2.2.0.tar.gz

Download URL netbox_data_import-2.2.0.tar.gz
Size 681.9 kB
Tags Source
SHA-256 checksum
How to use checksums
1c43ac4272d366bf14ca9dddfd298a267d84821bfbdebcf33b8ae60036fc5074
BLAKE2b-256 checksum
How to use checksums
69e569eff0a231fd5dc5c7628af736cb78e71b633f4252fbed2c78f3948aef12
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.2.0-py3-none-any.whl

Download URL netbox_data_import-2.2.0-py3-none-any.whl
Size 797.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ba7c9b3b182590e8cc81eec8c26cce252ae35fb5131d5095abafeda0b415609c
BLAKE2b-256 checksum
How to use checksums
b9e4d62084fbb6bc9d3f75a0c22e4ad5429bf49200a0e15c52b0f85921da66a4
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

2.3.0

2 release files

This release

2.2.0 This release

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