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
- The repository (python-openxml/python-docx) appears actively maintained, with the latest recorded upstream push on 2025-06-17 and the most recent update tag v1.2.0 on 2025-06-16.
- Update cadence looks irregular but ongoing, with the previous tagged updates in 2024-04/05 (v1.1.1 and v1.1.2), then a gap until mid-2025 (v1.2.0), after which development has continued at least through late June 2025.
AI summary generated 2 weeks ago
Recent updates
v1.2.0
11 months agoRelease 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
5/1/2024Release 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
4/30/2024Release 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
11/4/2023Release 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
10/12/2023Release 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
10/10/2023v1.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
5/15/2021Release 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
1/9/2019v0.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
1/8/2019v0.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
1/7/2019This 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.