python-docx is a Python library for reading, creating, and updating Microsoft Word 2007+ (.docx) files. It is useful if you need to generate or modify Word documents programmatically, for example creating paragraphs and saving them to a .docx file.
Project status
- Maintenance status: The repository appears largely quiet, with the most recent upstream push on 2025-06-17 and the latest listed update v1.2.0 on 2025-06-16, about a year before today (2026-06-09), suggesting no strong evidence of active ongoing maintenance cadence.
- Update cadence: Updates are infrequent, spanning multi-month to multi-year gaps in the provided history (for example, v1.2.0 in 2025, then v1.1.2 in 2024, and earlier updates dating back to 2023 and 2021).
AI summary generated
Recent updates
v1.2.0
Release v1.2.0 introduces new Word comment support to the library, including new public APIs for adding and iterating comments. It also adds minor internal changes to support comment elements and updates document layout width handling when certain section measurements are missing.
Featuresv1.1.2
Release v1.1.2 contains primarily internal refactoring and typing improvements across the OPC (Open Packaging Convention) layer and core properties handling. Several code paths changed behavior in small but potentially compatibility-impacting ways (not documented in the release notes, which were not provided).
Breakingv1.1.1
Release v1.1.1 was published on 2024-04-30, but the publisher provided no release notes. Without documented changes, developers should review the changelog/PRs and diff the codebase between v1.1.0 and v1.1.1 to identify potential behavioral, API, or breaking changes.
v1.1.0
Release v1.1.0 includes a substantial internal refactor around document-body and block item containers, with many typing and doc-generation changes. The code diff also introduces new iteration helpers for document content and changes how document-body content is cleared.
Featuresv1.0.1
Release v1.0.1 updates the hyperlink model and documentation build configuration, and introduces new hyperlink convenience/accessor properties. The most notable functional changes are in how hyperlinks store and expose address versus internal URI fragments, plus slight internal wiring changes for how hyperlink runs are constructed.
Featuresv1.0.0
v1.0.0 is a major release that adds hyperlink-related object model features (Hyperlink, RenderedPageBreak, and various new iterators/flags) and expands Paragraph, Run, and Section APIs. The release also removes Python 2 support and includes a bug fix related to Paragraph.text and hyperlinks. No release notes were provided by the publisher for this release tag.
BreakingFeaturesv0.8.11
Release v0.8.11 primarily contains Python 3.8 related build and compatibility updates. It also includes a refactor in the OpenXML namespace mapping code and minor packaging/build configuration changes.
v0.8.10
v0.8.10 bumps the library version and changes how the built-in default .docx template path is resolved. It adds a new template file (default.docx) and updates internal logic to point to it, intended to fix packaging behavior related to filenames containing square brackets.
v0.8.9
v0.8.9 makes a small packaging-related change to include the default document template directory in the published distribution. It also bumps the package version from 0.8.8 to 0.8.9. There were no code or API surface changes in the provided diff.
v0.8.8
This release (v0.8.8) has no release notes provided, so the changes included cannot be determined from the published documentation. Developers should inspect the GitHub compare view or changelog/commits for this tag to identify any API, behavior, or dependency changes.