Custom Report Headers & Footers by LucidBrainz is a powerful document branding solution for Odoo 17 that replaces default Odoo report headers and footers with your own custom images across all reports - including Invoices, Sales Orders, Quotations, Purchase Orders, Delivery Orders, and any other document! Say goodbye to boring default layouts and hello to professional branded documents! This intelligent module allows you to upload custom header and footer images once in company settings, and they automatically apply to ALL reports without any manual configuration. Perfect for businesses wanting professional branding, companies needing custom letterheads, organizations with specific design requirements, franchises maintaining brand consistency, consultants serving multiple clients, agencies managing brand guidelines, and any organization that needs professional document presentation, custom company branding, letterhead automation, or consistent visual identity across all reports. The module features simple image upload interface, automatic replacement of default layouts, full-width image support, works with all Odoo reports, maintains image aspect ratio, seamless PDF generation, no configuration needed after upload, preserves report data and content, and works with standard Odoo external layout. It intelligently hides default Odoo header elements (company logo, name, address, tagline) when custom header image is uploaded, and replaces default footer (company info, page numbers) with your custom footer image. The system gives you complete control over document appearance through a simple company settings interface, allowing you to upload header image, upload footer image, and instantly see changes in all generated reports. When you generate any report (invoice, sales order, quotation, delivery note, purchase order, etc.), the module automatically shows your custom header at the top and custom footer at the bottom, creating a professional, branded document with your company's unique design. The images are displayed in full width (100%), maintain proper aspect ratio, and use professional CSS styling with overflow handling and object-fit contain. The module includes smart conditional logic: if custom images exist, use them; if not, show default Odoo layout. This means you can choose which reports get custom branding by simply uploading or removing images. Ideal for businesses that want to maintain professional brand image, impress clients with custom documents, eliminate manual letterhead insertion, ensure brand consistency, save time on document formatting, comply with corporate guidelines, create memorable first impressions, stand out from competitors, and deliver professional-looking reports every time without any extra effort!

• Custom Header Image Upload: Upload your company's custom header image directly in Settings > Companies. Binary field with image widget for easy file selection. Supports JPG, PNG, and other common image formats
• Custom Footer Image Upload: Upload your company's custom footer image in the same location. Separate field for footer allows complete control over document top and bottom sections
• Company Settings Integration: Both fields added to Company form view right after the 'color' field. Easy to find under Settings > Companies > Your Company > General Information tab
• Universal Report Application: Once uploaded, custom images automatically apply to ALL reports - Sales Orders, Quotations, Invoices, Purchase Orders, Delivery Orders, Manufacturing Orders, and any custom reports
• Automatic Layout Replacement: Inherits 'web.external_layout_standard' template and intelligently replaces default Odoo header/footer with your custom images using XPath positioning
• Default Header Hiding: When custom header image exists, module automatically hides default Odoo header elements (company logo, name, tagline, address) using t-if="not company.report_header_image" condition
• Full Width Display: Custom header and footer images stretch to 100% page width (style="width: 100%"). Creates professional edge-to-edge appearance without white space on sides
• Aspect Ratio Preservation: Images maintain original proportions with height: auto. No distortion or stretching. Uses object-fit: contain to ensure proper scaling within container
• Professional Image Positioning: Header image positioned "before" default header div with margin-top: -70px for optimal placement. Footer replaces entire footer content div
• Base64 Image Encoding: Uses Odoo's image_data_uri() function to convert binary field to base64 data URI. Enables direct embedding in HTML without external file references
• Advanced CSS Styling: Comprehensive inline styles including overflow: hidden, display: block, object-fit: contain ensuring professional rendering across all browsers and PDF engines
• Conditional Logic System: Smart t-if conditions check for image existence. If custom header/footer uploaded, use it. If not, fall back to default Odoo layout. No errors or broken displays
• PDF Generation Compatible: Custom images render perfectly in generated PDF files. Works seamlessly with wkhtmltopdf engine. No quality loss or formatting issues in final PDF output
• Print-Ready Documents: All generated reports are immediately ready for printing with professional appearance. No additional formatting needed before sending to customers or printing
• Zero Configuration: Upload images once, forget about it. No need to configure each report template separately. Works automatically across entire system after image upload
• Data Preservation: Module only replaces header/footer visual elements. All report data (invoice lines, totals, addresses, etc.) remains intact and unaffected
• Multi-Company Support: Each company can have different header/footer images. Works perfectly in multi-company environments. Images tied to specific company record
• Easy Image Updates: Change header/footer anytime by uploading new images in company settings. Changes reflect immediately in all new reports. No module reinstall or upgrade needed
• Preview in Print Dialog: Before generating final PDF, print preview shows your custom header/footer. Verify appearance before downloading or emailing to customers
• Email Integration: Reports sent via email (Send by Email button) include custom branding. Recipients see professional branded documents in email attachments
• Alt Text Attributes: Images include alt="Header" and alt="Footer" attributes for accessibility and SEO purposes. Helps with screen readers and image identification
• XPath Template Inheritance: Uses proper Odoo template inheritance patterns. XPath expressions target exact elements for replacement. Clean code structure following Odoo best practices
• Binary Field Storage: Images stored as binary data in database. No external file dependencies. Automatic backup with database backups. No broken image links
• Image Widget Interface: Uses Odoo's built-in image widget in form view. Provides upload button, preview thumbnail, and delete option. User-friendly interface for non-technical users
• Responsive Container: Div wrapper with class="w-100" ensures responsive behavior. Images adapt to different page sizes while maintaining professional appearance
• Lightweight Module: Minimal code footprint. Only extends res.company model and external_layout template. No heavy dependencies. Fast installation and operation
• Standard Odoo Integration: Depends only on 'sale_management' module (can be changed to 'base' for wider compatibility). Uses standard Odoo ORM and QWeb templates
• Multilingual Compatible: Works with any language installation. Header/footer are images so no translation needed. Module labels can be translated using Odoo's translation system
• Customization Ready: Clean code structure allows easy modifications. Extend to add watermarks, additional branding elements, or custom logic based on your requirements