Binary Field Preview

One-click Preview button (eye icon) on every Binary field — form view and list view. Works on all widgets including custom ones.

Attachment Preview

Preview button on Many2Many attachment fields. Quick preview without downloading — images, PDFs, documents all viewable inline.

PDF Report Preview

Intercepts PDF report printing — preview the report in a modal before downloading or printing. Works on all QWeb PDF reports.

Excel Preview (SheetJS)

Preview Excel files client-side using SheetJS — rendered as interactive HTML tables. No Office Online or public URL required. Works on localhost!

Office Document Support

Preview Word, Excel, and PowerPoint via Office Online or Google Docs Viewer. Automatic fallback with download option on localhost.

Excel Preview Mixin

Easy-to-use Python mixin for wizard Excel reports. Inherit the mixin, implement 2 methods, and get Preview + Download buttons automatically!

Install Module

Install the module — no configuration needed. Preview buttons appear automatically on all Binary fields.

Click Preview

Click the eye icon next to any file field or attachment. A preview modal opens instantly.

Print Reports

PDF and Excel reports are intercepted — preview first, then download or print from the modal.

Done!

Close with ESC or click backdrop. Download anytime from the modal header. Zero configuration required.

Python — Inherit the Mixin

class MyWizard(models.TransientModel):
    _name = 'my.wizard'
    _inherit = ['sm.excel.preview.mixin']

    @property
    def _excel_filename(self):
        return 'my_report.xlsx'

    def _generate_excel_data(self):
        output = io.BytesIO()
        # ... generate Excel with openpyxl ...
        return output

XML — Add Buttons

<footer>
    <button name="action_preview_excel"
            type="object"
            string="Preview"
            class="btn-primary"/>
    <button name="action_download_excel"
            type="object"
            string="Download"
            class="btn-secondary"/>
    <button string="Close"
            special="cancel"/>
</footer>

Zero Configuration

Install and it just works. No settings, no setup. Preview buttons appear automatically on every Binary field and attachment across all models.

Works on All Binary Widgets

Not just standard Binary fields — works on custom widgets too (work_permit_upload, etc.) thanks to smart JS DOM fallback when OWL patches don't apply.

Community & Enterprise

Works on both Odoo Community and Enterprise editions. Only depends on the web module — available in every Odoo installation.

Auto-Detect File Types

Files without extensions? No problem. The module auto-detects file type via Content-Type header and renders the correct preview automatically.

Lightweight & Fast

Pure frontend JavaScript using OWL 2 patches. No heavy backend processing, no extra API calls, no database writes. Zero performance impact.

Excel on Localhost

Unlike other modules that need Office Online (public URL), our Excel preview uses SheetJS client-side rendering — works perfectly on localhost and private servers.

Module Info

• Version: 18.0.4.0.0
• License: LGPL-3
• Dependencies: web (only)
• Compatibility: Odoo 18.0 CE & EE

Components Patched

• BinaryField — Preview button on file fields
• ListBinaryField — Preview in list/tree views
• Many2ManyBinaryField — Attachment preview
• Report Handlers — PDF & Excel intercept