Error while loading the docx(KeyError: "There is no item named 'word/#_top' in the archive")

[akash97715]

Hello Team we are using below code to load the document

from docx import Document

# Path to your DOCX file
docx_file_path = 'myfile.docx'

# Load the DOCX file
document = Document(docx_file_path)

# Example: Print all the text in the document
for para in document.paragraphs:
 print(para.text)

Getting below error:

KeyError Traceback (most recent call last)~\AppData\Local\Temp\ipykernel_13540\1987488543.py in <module> 5 6 # Load the DOCX file----> 7 document = Document(docx_file_path) 8 9 # Example: Print all the text in the document~\Anaconda3\lib\site-packages\docx\api.py in Document(docx) 21 """ 22 docx = _default_docx_path() if docx is None else docx---> 23 document_part = Package.open(docx).main_document_part 24 if document_part.content_type != CT.WML_DOCUMENT_MAIN: 25 tmpl = "file '%s' is not a Word file, content type is '%s'"~\Anaconda3\lib\site-packages\docx\opc\package.py in open(cls, pkg_file) 114 def open(cls, pkg_file): 115 """Return an |OpcPackage| instance loaded with the contents of `pkg_file`."""--> 116 pkg_reader = PackageReader.from_file(pkg_file) 117 package = cls() 118 Unmarshaller.unmarshal(pkg_reader, package, PartFactory)~\Anaconda3\lib\site-packages\docx\opc\pkgreader.py in from_file(pkg_file) 23 content_types = _ContentTypeMap.from_xml(phys_reader.content_types_xml) 24 pkg_srels = PackageReader._srels_for(phys_reader, PACKAGE_URI)---> 25 sparts = PackageReader._load_serialized_parts( 26 phys_reader, pkg_srels, content_types 27 )~\Anaconda3\lib\site-packages\docx\opc\pkgreader.py in _load_serialized_parts(phys_reader, pkg_srels, content_types) 51 sparts = [] 52 part_walker = PackageReader._walk_phys_parts(phys_reader, pkg_srels)---> 53 for partname, blob, reltype, srels in part_walker: 54 content_type = content_types[partname] 55 spart = _SerializedPart(partname, content_type, reltype, blob, srels)~\Anaconda3\lib\site-packages\docx\opc\pkgreader.py in _walk_phys_parts(phys_reader, srels, visited_partnames) 84 phys_reader, part_srels, visited_partnames 85 )---> 86 for partname, blob, reltype, srels in next_walker: 87 yield (partname, blob, reltype, srels) 88 
~\Anaconda3\lib\site-packages\docx\opc\pkgreader.py in _walk_phys_parts(phys_reader, srels, visited_partnames) 84 phys_reader, part_srels, visited_partnames 85 )---> 86 for partname, blob, reltype, srels in next_walker: 87 yield (partname, blob, reltype, srels) 88 
~\Anaconda3\lib\site-packages\docx\opc\pkgreader.py in _walk_phys_parts(phys_reader, srels, visited_partnames) 79 reltype = srel.reltype 80 part_srels = PackageReader._srels_for(phys_reader, partname)---> 81 blob = phys_reader.blob_for(partname) 82 yield (partname, blob, reltype, part_srels) 83 next_walker = PackageReader._walk_phys_parts(~\Anaconda3\lib\site-packages\docx\opc\phys_pkg.py in blob_for(self, pack_uri) 81 Raises |ValueError| if no matching member is present in zip archive. 82 """---> 83 return self._zipf.read(pack_uri.membername) 84 85 def close(self):~\Anaconda3\lib\zipfile.py in read(self, name, pwd) 1470 def read(self, name, pwd=None): 1471 """Return file bytes for name."""-> 1472 with self.open(name, "r", pwd) as fp: 1473 return fp.read() 1474 
~\Anaconda3\lib\zipfile.py in open(self, name, mode, pwd, force_zip64) 1509 else: 1510 # Get info object for name-> 1511 zinfo = self.getinfo(name) 1512 1513 if mode == 'w':~\Anaconda3\lib\zipfile.py in getinfo(self, name) 1436 info = self.NameToInfo.get(name)
 1437 if info is None:
-> 1438 raise KeyError(
 1439 'There is no item named %r in the archive' % name)
 1440 

KeyError: "There is no item named 'word/#_top' in the archive"

Let me know am i doing anything wrong, also it will be helpful if u provide some suggestion to resolve this issue

[scanny]

Sounds like a corrupted docx file. Maybe open it with Word or LibreOffice and save as a new name so it rewrites the file.

[akash97715]

Hello, Thanks for you response. I tried saving with new name but still got the same error. I revalidated the docs it’s not corrupted

[scanny]

@akash97715 if you can send the file I'll take a look at it. Otherwise I just don't have enough to go on. I've never seen this error before and I've been at it for over a decade, so this is something of an edge case.

Do you know the provenance of the document? Was it generated by some package rather than being authored using Word or LibreOffice?

[msr22]

@scanny I am facing the same issue. I tried renaming the file & saving it again but still getting the issue. I am able to open the file correctly in MS Word.

[JiuJiu998]

I also encountered the same problem, unfortunately I couldn't find the cause, but I used the pypandoc library to read it and saved it again to read it normally, although it would lose my necessary file metadata.

[michaelromagne]

The fix below was inspired by other issues in this repo (here and here). You just have to add the below code snippet before running the document = Document(docx_file_path) line @akash97715

It seems to be due to styled headers or headers with bookmarks. @scanny , I would be interested to know if that makes sense for you. On my use case, the header name was still present in the end list after the change.

from docx.opc.oxml import parse_xml
from docx.opc.pkgreader import _SerializedRelationship, _SerializedRelationships

def load_from_xml_v2(baseURI, rels_item_xml):
 """
 Return |_SerializedRelationships| instance loaded with the
 relationships contained in *rels_item_xml*. Returns an empty
 collection if *rels_item_xml* is |None|.
 """
 srels = _SerializedRelationships()
 if rels_item_xml is not None:
 rels_elm = parse_xml(rels_item_xml)
 for rel_elm in rels_elm.Relationship_lst:
 if (
 rel_elm.target_ref in ("../NULL", "NULL")
 or rel_elm.target_ref.startswith("#_") # Internal bookmark
 ):
 continue
 srels._srels.append(_SerializedRelationship(baseURI, rel_elm))
 return srels


_SerializedRelationships.load_from_xml = load_from_xml_v2

[michaelromagne]

Why is this issue close @scanny ? This remains a recurrent issue for python-docx users and in any other project relying on it, for instance see docling: docling-project/docling#1645

[scanny]

@michaelromagne can you provide a DOCX file that reproduces the behavior (as small as possible is helpful :).

If so I'll reopen and take a look. The issue was closed because I could not reproduce and the OP did not provide an example file.

[michaelromagne]

Yes @scanny. Here is the DOCX file: test.docx

The code snippet:

from docx import Document

# Path to your DOCX file
docx_file_path = 'test.docx'

# Load the DOCX file
document = Document(docx_file_path)

# Example: Print all the text in the document
for para in document.paragraphs:
 print(para.text)

The error:

---------------------------------------------------------------------------
KeyError Traceback (most recent call last)
Cell In[5], line 7
 4 docx_file_path = 'test2.docx'
 6 # Load the DOCX file
----> 7 document = Document(docx_file_path)
 9 # Example: Print all the text in the document
 10 for para in document.paragraphs:

File ~/workdir/genai-platform-udp/.venv/lib/python3.13/site-packages/docx/api.py:27, in Document(docx)
 20 """Return a |Document| object loaded from `docx`, where `docx` can be either a path
 21 to a ``.docx`` file (a string) or a file-like object.
 22 
 23 If `docx` is missing or ``None``, the built-in default document "template" is
 24 loaded.
 25 """
 26 docx = _default_docx_path() if docx is None else docx
---> 27 document_part = cast("DocumentPart", Package.open(docx).main_document_part)
 28 if document_part.content_type != CT.WML_DOCUMENT_MAIN:
 29 tmpl = "file '%s' is not a Word file, content type is '%s'"

File ~/workdir/genai-platform-udp/.venv/lib/python3.13/site-packages/docx/opc/package.py:126, in OpcPackage.open(cls, pkg_file)
 123 @classmethod
 124 def open(cls, pkg_file: str | IO[bytes]) -> Self:
 125 """Return an |OpcPackage| instance loaded with the contents of `pkg_file`."""
--> 126 pkg_reader = PackageReader.from_file(pkg_file)
 127 package = cls()
 128 Unmarshaller.unmarshal(pkg_reader, package, PartFactory)

File ~/workdir/genai-platform-udp/.venv/lib/python3.13/site-packages/docx/opc/pkgreader.py:25, in PackageReader.from_file(pkg_file)
 23 content_types = _ContentTypeMap.from_xml(phys_reader.content_types_xml)
 24 pkg_srels = PackageReader._srels_for(phys_reader, PACKAGE_URI)
---> 25 sparts = PackageReader._load_serialized_parts(phys_reader, pkg_srels, content_types)
 26 phys_reader.close()
 27 return PackageReader(content_types, pkg_srels, sparts)

File ~/workdir/genai-platform-udp/.venv/lib/python3.13/site-packages/docx/opc/pkgreader.py:51, in PackageReader._load_serialized_parts(phys_reader, pkg_srels, content_types)
 49 sparts = []
 50 part_walker = PackageReader._walk_phys_parts(phys_reader, pkg_srels)
---> 51 for partname, blob, reltype, srels in part_walker:
 52 content_type = content_types[partname]
 53 spart = _SerializedPart(partname, content_type, reltype, blob, srels)

File ~/workdir/genai-platform-udp/.venv/lib/python3.13/site-packages/docx/opc/pkgreader.py:82, in PackageReader._walk_phys_parts(phys_reader, srels, visited_partnames)
 80 yield (partname, blob, reltype, part_srels)
 81 next_walker = PackageReader._walk_phys_parts(phys_reader, part_srels, visited_partnames)
---> 82 for partname, blob, reltype, srels in next_walker:
 83 yield (partname, blob, reltype, srels)

File ~/workdir/genai-platform-udp/.venv/lib/python3.13/site-packages/docx/opc/pkgreader.py:79, in PackageReader._walk_phys_parts(phys_reader, srels, visited_partnames)
 77 reltype = srel.reltype
 78 part_srels = PackageReader._srels_for(phys_reader, partname)
---> 79 blob = phys_reader.blob_for(partname)
 80 yield (partname, blob, reltype, part_srels)
 81 next_walker = PackageReader._walk_phys_parts(phys_reader, part_srels, visited_partnames)

File ~/workdir/genai-platform-udp/.venv/lib/python3.13/site-packages/docx/opc/phys_pkg.py:83, in _ZipPkgReader.blob_for(self, pack_uri)
 78 def blob_for(self, pack_uri):
 79 """Return blob corresponding to `pack_uri`.
 80 
 81 Raises |ValueError| if no matching member is present in zip archive.
 82 """
---> 83 return self._zipf.read(pack_uri.membername)

File ~/.pyenv/versions/3.13.1/lib/python3.13/zipfile/__init__.py:1598, in ZipFile.read(self, name, pwd)
 1595 def read(self, name, pwd=None):
 1596 """Return file bytes for name. 'pwd' is the password to decrypt
 1597 encrypted files."""
-> 1598 with self.open(name, "r", pwd) as fp:
 1599 return fp.read()

File ~/.pyenv/versions/3.13.1/lib/python3.13/zipfile/__init__.py:1635, in ZipFile.open(self, name, mode, pwd, force_zip64)
 1632 zinfo.compress_level = self.compresslevel
 1633 else:
 1634 # Get info object for name
-> 1635 zinfo = self.getinfo(name)
 1637 if mode == 'w':
 1638 return self._open_to_write(zinfo, force_zip64=force_zip64)

File ~/.pyenv/versions/3.13.1/lib/python3.13/zipfile/__init__.py:1563, in ZipFile.getinfo(self, name)
 1561 info = self.NameToInfo.get(name)
 1562 if info is None:
-> 1563 raise KeyError(
 1564 'There is no item named %r in the archive' % name)
 1566 return info

KeyError: "There is no item named 'word/#Agenda_1' in the archive"

[michaelromagne]

The issue is also highlightened here with the fixes, as described above in my old comment. Ideally the fix should be added in python-docx:

• Unable to read docx containing pictures linking to internal bookmarks: KeyError: "There is no item named 'word/#MyBookmark' in the archive" #902
• Open Word docx file with "The image part with relationship rID8 was not found" error, it always fails #1105

I agree with this process to reproduce the bug, described in the 902 issue:

• Adding a picture to the Word file
• Right-click => Link
• Add link to any internal bookmark.

Thanks a lot for taking time for this 😄