---
id: vsdx
version: "0.6.1"
license: unclear
license_treatment: permissive
maintenance: aging
---

# vsdx — vsdx - A python library for processing .vsdx files

License: permissive · Maintenance: aging · Downloads: 160.7K/mo

## What it is and what it does

vsdx is a Python library for reading and writing Microsoft Visio .vsdx files without requiring Visio itself. It lets you programmatically find, modify, and remove shapes, read and set shape properties and data, and work with pages and connectors. The library also supports templating: you can embed Jinja2 code into a .vsdx file and render it with context data to generate new diagrams dynamically.

The package depends on Jinja2 for template rendering and the deprecation library for API lifecycle management. It supports Python 3.8 through 3.14 and is classified as Beta. The library is useful for automation workflows where you need to generate or modify Visio diagrams from data, extract information from existing diagrams, or build diagram-generation pipelines without manual intervention.

Use it for:

- Automate diagram generation from templates and data sources for reports or documentation.
- Extract shape text and properties from existing .vsdx files for data processing or migration.
- Programmatically modify Visio diagrams by finding and updating specific shapes or connectors.
- Build CI/CD pipelines that generate or update architecture or flowchart diagrams from configuration.
- Create batch operations to remove, duplicate, or reorganize shapes across multiple Visio files.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

vsdx reads, modifies, and creates Microsoft Visio .vsdx files programmatically, supporting shape manipulation, templating via Jinja2, and file I/O operations.

Yes, if you need to automate Visio file manipulation without Visio installed. The low install friction, permissive license, and broad Python version support make it straightforward to adopt. The aging maintenance status (222 days since last release) is a minor concern for long-term stability, but the repository is active and no security vulnerabilities are known. Verify that the feature set covers your specific use case before committing to production.

## Install

pip install vsdx
uv add vsdx
poetry add vsdx

## Installing vsdx

Before you install: Low install friction: pure Python wheel with only two runtime dependencies (Jinja2 and deprecation). Maintenance status is aging—last release 222 days ago—but the repository is active and not archived, with recent commits as of 2026-01-04.

License in practice: Permissive license treatment means you can use this in commercial and proprietary projects without copyleft obligations.

Quickstart:

from vsdx import VisioFile

with VisioFile('my_file.vsdx') as vis:
    shape = vis.pages[0].find_shape_by_text('Shape to remove')
    if shape:
        shape.remove()
    vis.save_vsdx('updated.vsdx')

Verify before relying:

- Whether the package handles all Visio file format variations and edge cases reliably in production use.
- Performance characteristics when working with large or complex .vsdx files.
- Completeness of Jinja2 template support for complex conditional and loop scenarios.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 160.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

visio file processing python, vsdx manipulation library, read write visio diagrams, visio shape extraction, vsdx template rendering, visio automation python, diagram file editing, file-format, automation, diagram-generation

[View on SkillFed](https://skillfed.io/packages/vsdx) · [View on PyPI](https://pypi.org/project/vsdx/)