Advanced Document Viewer
Overview
Advanced Document Viewer is a production-ready Mendix pluggable widget that
lets users preview, manage, and interact with uploaded documents directly
within your Mendix application — no third-party services required for core
functionality.
Use this widget alongside the Mendix File Manager widget. File Manager
handles upload; Advanced Document Viewer handles preview, download, and delete.
KEY FEATURES
Preview Support
- PDF — inline preview using blob-fetch (no auto-download, works always)
- Excel / CSV — powered by SheetJS, works on local development too
- Images — JPG, PNG, GIF, WEBP, SVG inline preview
- Office files — DOCX, PPTX via Google Docs Viewer (deployed environments)
- Video and Audio — HTML5 player
- Text and XML — dark monospace viewer
Security
- Per-file password protection — locked files show only a View button;
Download and Delete are hidden until the correct password is entered
- File expiry date — files auto-disable after the expiry date; View,
Download, and Delete are all blocked automatically
Productivity
- Inline annotations — users can add comments per document inside the preview popup
- Bulk select — select multiple files for bulk download or bulk delete
- Delete confirmation dialog — configurable, prevents accidental deletion
- Custom validation message — wire a string attribute from your Save nanoflow to show a red banner when no file has been uploaded
- Pagination — handles large file lists with a Load More button
WHAT MAKES THIS DIFFERENT
Unlike the built-in Mendix File Viewer, Advanced Document Viewer adds
password protection, file expiry, annotations, and bulk
operations — features that enterprise and client-facing applications demand.
Excel and CSV files preview locally without any deployment, which is
unique among Mendix document widgets.
COMPATIBILITY
- Mendix Studio Pro 9.x and 10.x
- Web platform only
- Apache-2.0 license — free for commercial and personal use
SETUP
1. Add the widget to your page alongside a File Manager widget
2. Connect both to the same list datasource (entities extending
System.FileDocument)
3. Map the File name attribute and optionally File size, Upload date,
Expiry date, and Password attributes
4. Configure Display settings as needed
Documentation
Typical usage scenario
The Advanced Document Viewer widget is designed to provide a seamless and interactive document management experience within Mendix applications.
It can be used in scenarios such as:
- Document management systems (DMS)
- Employee portals for accessing files
- Customer portals for secure document sharing
- Internal dashboards for viewing reports (PDF, Excel, images, etc.)
- Applications requiring password-protected file access
This widget solves key problems like:
- Viewing multiple file formats directly inside the app
- Restricting access using per-file password protection
- Providing inline preview without downloading
- Managing documents efficiently with a clean UI
Features
The Advanced Document Viewer widget is designed to provide a seamless and interactive document management experience within Mendix applications.
It can be used in scenarios such as:
- Document management systems (DMS)
- Employee portals for accessing files
- Customer portals for secure document sharing
- Internal dashboards for viewing reports (PDF, Excel, images, etc.)
- Applications requiring password-protected file access
This widget solves key problems like:
- Viewing multiple file formats directly inside the app
- Restricting access using per-file password protection
- Providing inline preview without downloading
- Managing documents efficiently with a clean UI
Installation
Download the widget from Mendix Marketplace
Import the .mpk file into your Mendix project
Add the widget to a page
Configure the required data source (FileDocument entity)
Configuration
- Set Data SourceUse a list of
System.FileDocument(or custom entity)
Map required attributes:
- File Name →
Name - File Size →
Size(optional) - Upload Date →
createdDate(optional) - Expiry Date → custom attribute (optional)
- Password → custom string attribute (optional)
Optional configurations:
- Enable password protection
- Enable expiry validation
- Configure annotations
Frequently Asked Questions
1. Does it support all file types?
Supports most common formats: PDF, Images, Excel, Text, Video, Audio.
2. Is password protection secure?
It is UI-level protection, not encryption. For high security, use backend validation.
3. Can I use it with a single object?
Currently optimized for list-based data source.
4. Does it work on mobile?
Yes, fully responsive and works on mobile devices.
5. Can I customize UI?
Yes, you can modify styles via CSS or extend the widget.
Releases
Initial release of Advanced Document Viewer v1.0.0
What's included in this release:
- PDF preview — inline rendering using blob-fetch, bypasses auto-download
- Excel and CSV preview — powered by SheetJS, works on local development without deployment
- Image preview — supports JPG, PNG, GIF, WEBP, SVG
- Office file preview — DOCX, PPTX via Google Docs Viewer (requires deployed environment)
- Video and Audio — HTML5 player support
- Text and XML — dark monospace viewer
Security features:
- Per-file password protection — Download and Delete are hidden until the correct password is entered
- File expiry date — files automatically disable after expiry, all actions are restricted
- Watermark — dynamic overlay text inside the preview popup
Productivity features:
- Inline annotations and comments per document
- Bulk select with bulk download and bulk delete
- Delete confirmation dialog
- Custom validation message via string attribute
- Pagination support for large file lists
Compatibility:
- Compatible with Mendix Studio Pro 9.x and 10.x
- Built using Mendix pluggable widget architecture
This version marks the first stable release of the Advanced Document Viewer widget, providing a complete and secure document handling solution within Mendix applications.