Repository navigation
DOCX Cover Pages building block is omitted during SuperDoc rendering #3972
Description
What happened?
A DOCX created in Microsoft Word contains a standard Word Cover Page. When loaded in SuperDoc, the cover page is not displayed. SuperDoc starts rendering from the first normal document paragraph instead.
The same DOCX renders correctly in Microsoft Word and LibreOffice.
Steps to reproduce
- Create a new DOCX in Microsoft Word.
- Insert a built-in cover page using Insert → Cover Page.
- Add normal document content after the cover page.
- Load the DOCX with SuperDocEditor.
- Observe that the cover page is missing and the document starts with the main content.
SuperDoc version
1.43.2
Browser
None
Additional context
The cover page is represented in word/document.xml as a block-level structured document tag:
<w:sdt>
<w:sdtPr>
<w:docPartObj>
<w:docPartGallery w:val="Cover Pages"/>
</w:docPartObj>
</w:sdtPr>
<w:sdtContent>
</w:sdtContent>
</w:sdt>
The cover-page content is preserved in the DOCX package and is not represented as ordinary body paragraphs. It appears that Cover Pages document parts are parsed but not emitted into the rendered layout.
Activity
linear-code commentedon Sep 3, 2026
IT-1583
caio-pizzol commentedon Sep 3, 2026
[answer edit]
Thanks for reporting @yuqian-dentons. We tested your document with SuperDoc 2.11.0 and confirmed that this is fixed in v2 - the cover page renders correctly. Would you be open to upgrading? Our v1-to-v2 migration guide covers the required package and API changes.
We also reproduced the issue in v1. The document imports correctly, but the v1 renderer skips text boxes and drawings nested inside Word’s cover-page content control. We’re going to work on a v1 fix and will follow up once it is available. If upgrading is not currently feasible, please let us know what constraints are preventing it.
yuqian-dentons commentedon Sep 4, 2026
Thanks for getting back to me so quickly, Caio. I’ve proceeded with the upgrade, and the issues have been resolved in the upgraded version.
Thanks again for your help!