They can cause instability, introduce issues and may conflict with future updates. Apply at your own risk!
WYSIWYG Docx Import
This hack adds the ability to import “.docx” files into the WYSIWYG editor, by dragging and dropping a “docx” file into the editor area. The file contents are converted to HTML then inserted into the editor at the current cursor position.
Conversion is performed browser-side using the mammoth.js library. Warning messages from the conversion will be logged to the browser console, and a popup warning notification will advise of this.
Considerations
- This hack uses an externally hosted library, hosted on
jsdelivr.net. You could host this locally instead if desired. - The conversion is relatively simplistic, to result in clean HTML for use in BookStack. Not all formatting is supported by the conversion and you’ll likely lose layout or formatting. Don’t expect a replica result in BookStack, this is more for easy importing of existing content.
- Images will be within content, base64 included, until save when BookStack will attempt to extract them out. This may cause editor performance to be particularly slow until first save after import.
- If using the older (currently default) WYSIWYG editor in BookStack, you will see a “Dropped file type is not supported” warning message pop-up in the editor on use.
Updates
- 2026-09-29: This hack has been updated to also support the new WYSIWYG editor, so this now works for both. The mammoth.js version was also updated, and an
integrityattribute added to protect against unexpected external script manipulation.
Code
head.html
|
|
Install as Module (Beta)
If using BookStack v26.03 or later, you can install this hack as a theme module on your BookStack instance by running the below artisan command from your BookStack installation folder:
php artisan bookstack:install-module https://www.bookstackapp.com/hack-modules/wysiwyg-docx-import.zip
Request an Update
Hack not working on the latest version of BookStack?
You can request this hack to be updated & tested for a small one-time fee.
This helps keeps these hacks updated & maintained in a sustainable manner.
Latest Hacks
View Block: Developer Info
This hack registers a custom view block which will show developer-focused details such as: ID for the current item viewed (With click-to-copy ID) A link to open that item in the API A link to the relevant section in the docs This is available to be added to all content-based layouts. »
View Block: Instance Total Stats
This hack registers a custom view block which can be used on any type of home page. This block lists total counts for shelves, books, chapters, pages and users in the system. »
Azure/Entra OIDC User Avatar Images on Initial Login
This hack hooks into the OIDC login process to fetch and assign user avatar images from Azure/Entra on first user login/registration. »
Tag Values in Page Content via Includes
This hack allows you to dynamically pull in the value of tags into page content, via customizing how page include tags are parsed. This hack will attempt to use tags on the page itself, then look to the parent chapter (if existing), then the parent book’s tags. »