| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Invoicing (account)
• Purchase (purchase) • Discuss (mail) |
| Lines of code | 3227 |
| Technical Name |
hex_report_studio |
| License | OPL-1 |
| Website | https://hexalian.com |
| Versions | 17.0 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Invoicing (account)
• Purchase (purchase) • Discuss (mail) |
| Lines of code | 3227 |
| Technical Name |
hex_report_studio |
| License | OPL-1 |
| Website | https://hexalian.com |
| Versions | 17.0 18.0 19.0 |
Hex Report Studio
Professional PDF Report Designer for Odoo 17
Live Preview Engine: Visualize your changes instantly! Use the "Set As Default" to apply your design globally, or "Duplicate" to create variations. Adjust colors, fonts, and layout in real-time.
CRITICAL: Invoice Immutability & Regeneration
Invoices and Credit Notes are LEGAL DOCUMENTS. Once Odoo generates a PDF for a posted invoice, it locks that file forever to ensure legal compliance. It will NEVER automatically update to show your new template changes.
To apply new templates to existing Invoices: You MUST use the "Clear Report Cache" button in the Report Settings Actions menu. This forces Odoo to delete the old "locked" PDFs and regenerate them using your new design.
Note: Sales Orders and Quotations are mutable drafts and will update automatically. This restriction applies ONLY to Invoices, and legal documents.
Why Custom Reports Matter?
Brand Identity • Professionalism • Clarity
Stop sending generic Odoo documents. Create branded, professional PDF reports that impress your clients and represent your corporate identity perfectly.
v2.2 includes our new Safe-Clear Cache Engine. It uses SQL-verified targeting to prevent data loss while ensuring your Invoices always match your latest design.
1. Colors & Branding
Match your corporate identity perfectly
Full Color Control:
- Primary Color: Sets the tone for headers, borders, and accents.
- Secondary Color: Controls zebra-striping and background nuances.
- Header Background: Distinct background for table headers.
- Body Text: Ensure perfect readability with custom text colors.
Simply pick a color from the palette or enter your exact Hex code for pixel-perfect branding.
2. Typography Control
Communicate cleanly and effectively
Font & Sizing:
- 14+ Font Families: Choose from Roboto, Open Sans, Lato, Montserrat, and more.
- Size Control: Granular control over Body, Header, and Table font sizes.
- Global Scale: Adjust document readability instantly.
Typography defines the character of your document. Make it modern with sans-serifs or classic with serifs.
3. Header & Document Info
Organized, professional headers
Smart Header Layout:
Configure exactly what appears in your document header. Toggle visibility for:
- Partner Name & Address (Name, VAT, Phone, Email, Ref, Address)
- Document Date, Delivery Date, & Validity Date
- Source Document
- Salesperson & Buyer (Purchase)
- Payment Terms
- QR Code Display (Portal)
Document Information Details:
Fine-tune specific dates and reference fields. Ensure your invoices and orders display exactly the legal info required.
4. Order Lines & Details
Clean, readable line items
Table Customization:
The core of your document. Control the display of columns:
- Line #, Product Ref, Description
- Quantity & Unit of Measure (UoM)
- Unit Prices, Discounts, and Taxes
- Zebra Striping (via Colors tab)
(Note: Product Images are available in the "Premium Features" tab)
5. Footer & Terms
Close with clarity
Footer Elements:
- Terms & Conditions: Automatically appended from Odoo settings.
- Signature Boxes: Show/Hide with custom label (e.g., "Authorized By").
- Company Imprint: Display Company Name, Phone, Email, Website & Tax ID.
- Print Timestamp: Show date/time of printing.
6. Layout Configuration
Format, Spacing & Locales
Page Settings:
- A4 (210 x 297 mm): Standard for Europe, Asia, and most of the world. Taller and narrower.
- US Letter (215.9 x 279.4 mm): Standard for USA/Canada. Wider and shorter.
- US Legal (215.9 x 355.6 mm): Extra tall standard.
7. Advanced Watermarks
Protect and clarify document status
Watermark Engine:
- Text: "DRAFT", "CONFIDENTIAL", "ORIGINAL".
- Rotation: Full 360-degree control (0° to 90°).
- Opacity: Slider control for subtle or bold overlays.
- Font Size: Scale the watermark to full page size.
8. Custom Header HTML
Unlimited creativity for developers
Code Editor:
Inject custom HTML/CSS directly into the header section. Perfect for promos, special banners, or complex branding requirements.
Safe & Secure: Automatically sanitizes inputs to prevent breaking changes.Copy-Paste Sample: 2-Column Header
<div style="display: flex; justify-content: space-between; align-items: center; border-bottom: 2px solid #155948; padding-bottom: 10px; margin-bottom: 20px;">
<div>
<h1 style="color: #155948; margin: 0; font-size: 24px;">SPECIAL PROMO</h1>
<span style="color: #666; font-size: 14px;">Valid until Dec 31</span>
</div>
<div style="text-align: right;">
<strong style="color: #333;">Priority Support</strong><br/>
<span style="color: #666;">+1 (555) 123-4567</span>
</div>
</div>
9. Custom Footer HTML
Precise footer control
Footer Injection:
Add bank details, social media links, or legal disclaimers exactly where you need them.
Supports inline CSS for pixel-perfect PDF rendering.Copy-Paste Sample: 3-Column Footer
<div style="display: flex; justify-content: space-between; font-size: 10px; color: #666; border-top: 1px solid #ddd; padding-top: 10px; margin-top: 30px;">
<div style="width: 30%;">
<strong style="color: #333;">Our Office</strong><br/>
123 Business Rd, Tech City
</div>
<div style="width: 30%;">
<strong style="color: #333;">Bank Details</strong><br/>
Bank: Global Trust<br/>
IBAN: US99 1234 5678 9000
</div>
<div style="width: 30%; text-align: right;">
<strong style="color: #333;">Follow Us</strong><br/>
web: www.hexalian.com
</div>
</div>
10. Premium Features
Borders, Layouts & Images
Advanced Styling:
- Page Borders: Solid, Double, Dashed, Dotted, Groove, Ridge, Inset, Outset styles.
- Product Images: Toggle product thumbnails in order lines.
- Layout Density: Standard, Compact (High Density) or Spacious (Low Density) modes.
- Address Positioning: Swap Partner address to Left, Right, or Center.
Copy-Paste Sample: TEST MODE
Use this snippet to verify your Custom CSS is loading correctly.
Note: You must use the .hex-report class to override styles.
/* 🎨 PROFESSIONAL STYLING EXAMPLE */
/* 1. Brand Color for Titles (Use ID selector) */
#hex_doc_title {
color: #2C3E50 !important;
text-transform: uppercase !important;
border-bottom: 2px solid #2C3E50 !important;
padding-bottom: 5px !important;
}
/* 2. Style Table Headers (Target headers inside the table ID) */
#hex_order_lines_table th {
background-color: #f8f9fa !important;
color: #495057 !important;
text-transform: uppercase !important;
font-size: 0.85rem !important;
}
/* 3. Highlight Total Amount (Target the total row inside the totals section) */
#hex_totals tr.border-black {
font-size: 1.2rem !important;
color: #d9534f !important; /* Red for emphasis */
background-color: #fff3cd !important; /* Light yellow bg */
}
/* 4. Hide Specific Elements (e.g. Custom Header) */
#hex_custom_header {
display: none !important;
}
Available CSS IDs (Selectors)
Target these specific sections using the #ID syntax:
| Target Context | CSS ID | Notes |
|---|---|---|
| Entire Report | .hex-report (Class) |
Main wrapper. Use this for page-level fonts/colors. |
| Document Title | #hex_doc_title |
E.g. "Invoice INV/2023/001" |
| Address Block | #hex_address_block |
Partner & Company address container |
| Document Info Block | #informations |
Date, Due Date, Source, etc. |
| Order Lines (Table) | #hex_order_lines_table |
Main data table (when in Table mode) |
| Order Lines (Cards) | #hex_order_lines_cards |
Grid container (when in Cards mode) |
| Totals Area | #hex_totals |
Subtotal, Tax, and Total amount section |
| Custom Header | #hex_custom_header |
Your Custom HTML Header container |
| Custom Footer | #hex_custom_footer |
Your Custom HTML Footer container |
.hex-report and use !important
if necessary.
Example:
#hex_doc_title { color: #2C3E50 !important; font-weight: bold; }
12. Pre-Designed Templates
Start with a professional base
Gallery Part 1: Standard Collection
From Corporate Green to Navy Blue - ready to use instantly.
Gallery Part 2: Premium Collection
Includes "Dark Mode" and high-contrast designs.
13. Premium Themes Collection
Industry-Specific Design Excellence
Our 8 meticulously crafted premium themes go beyond aesthetics—each is designed with specific industries in mind, incorporating color psychology, typography standards, and layout conventions that resonate with your target market.
Golden Noir (Dark Luxury)
Target Industries: High-End Retail, Jewelry, Luxury Goods, Premium Services
Design Philosophy: Dark mode elegance with metallic gold accents creates an unmistakable premium feel. Perfect for brands that position themselves in the ultra-luxury segment.
- Color Palette: Metallic Gold (#D4AF37) on Deep Black (#1A1A1A)
- Typography: Garamond serif at 28px headers for timeless sophistication
- Layout: Spacious with double borders, card display mode
- Features: Product images enabled, centered address positioning
LUXURY
Royal Sapphire (Corporate Trust)
Target Industries: Finance, Banking, Insurance, Legal Services, Consulting
Design Philosophy: Deep navy blue conveys authority, stability, and trustworthiness—essential for industries managing sensitive financial or legal matters.
- Color Palette: Deep Navy (#0A3D62) with Ice Blue accents (#EAF4F8)
- Typography: Georgia serif at 27px for professional credibility
- Layout: Standard density, solid borders for formality
- Features: Right-aligned address, clean table layout
EXCELLENCE
Platinum Executive (Tech Minimalism)
Target Industries: Technology, SaaS, IT Services, Management Consulting, Startups
Design Philosophy: Clean, modern, data-driven. Emphasizes clarity and efficiency without sacrificing sophistication.
- Color Palette: Slate Gray (#2C3E50) with Light Silver (#F8F9FA)
- Typography: Roboto sans-serif at 26px for contemporary feel
- Layout: Standard density, minimal borders
- Features: Classic table layout, right-aligned address
PRECISION
Burgundy Elegance (Legal Authority)
Target Industries: Law Firms, Notaries, Estate Planning, Premium Wine/Spirits
Design Philosophy: Rich burgundy evokes tradition, authority, and refined taste. Cream backgrounds suggest archival-quality documents.
- Color Palette: Burgundy (#800020) with Cream (#FDF8F3)
- Typography: Garamond serif at 28px for classical gravitas
- Layout: Spacious with double borders, left-aligned address
- Features: Warm paper background, high line spacing for readability
AUTHORITY
Emerald Professional (Healthcare Trust)
Target Industries: Healthcare, Medical Practices, Wellness Centers, Pharmaceuticals
Design Philosophy: Teal/emerald green symbolizes health, growth, and care. Clean typography prioritizes clarity for medical information.
- Color Palette: Teal Green (#0D7377) with Mint Cream (#E8F5F5)
- Typography: Open Sans at 27px for optimal legibility
- Layout: Standard density, solid borders
- Features: Right-aligned address, professional table layout
WELLNESS
Cyber Slate (Tech Innovation)
Target Industries: IT Companies, Software Development, Cybersecurity, Digital Agencies
Design Philosophy: Electric blue conveys cutting-edge technology and digital innovation. Compact layout maximizes information density.
- Color Palette: Electric Blue (#667EEA) on Cool White (#F7FAFC)
- Typography: Roboto at 26px for modern, tech-forward aesthetic
- Layout: Compact/high-density with product images enabled
- Features: Card display mode, left-aligned address
FUTURE
Rose Gold Prestige (Fashion Luxury)
Target Industries: Fashion, Beauty, Cosmetics, Luxury Retail, Event Planning
Design Philosophy: Rose gold represents modern elegance and feminine sophistication. Spacious layout creates breathing room for high-value products.
- Color Palette: Rose Gold (#B76E79) with Blush White (#FFF5F7)
- Typography: Lato at 28px for contemporary elegance
- Layout: Spacious with double borders, product images
- Features: Card display mode, centered address for balance
BEAUTY
Obsidian Prime (Engineering Precision)
Target Industries: Architecture, Engineering, Manufacturing, Industrial Services
Design Philosophy: True black on white maximizes contrast and readability. No-nonsense design emphasizes technical precision and professionalism.
- Color Palette: Obsidian Black (#1C1C1C) with Light Gray (#F5F5F5)
- Typography: Arial at 26px for universal clarity
- Layout: Compact/high-density for technical specifications
- Features: Classic table layout, right-aligned address
STRENGTH
Customization Freedom
While these premium themes provide industry-optimized starting points, every element is fully customizable. Use them as-is or modify colors, fonts, layouts, and features to match your exact brand guidelines. Click "Duplicate" on any theme to create your own variation without affecting the original.
14. Workflow Efficiency
Preview, Duplicate & Default
Power Tools:
- Set as Default: One click makes your design the standard for the company.
- Duplicate: Clone an existing design to test changes safely.
- Live Preview: See PDF changes instantly without printing.
The Control Panel
Scope Configuration
Control where your designs appear
Applies To:
Decide exactly which documents use this template. You can have different designs for Quotes vs Invoices!
- All Documents: Universal design for everything (Quotes, Orders, Invoices).
- Sale Orders: Applies only to Quotations and Sale Orders.
- Purchase Orders: Applies only to RFQs and Purchase Orders.
- Invoices: Applies only to Customer Invoices, Credit Notes.
15. Complete Field Reference Guide
Every Setting Explained
1. Colors Tab
| Field | Purpose |
|---|---|
| Primary / Secondary Color | Branding colors for headers, accents, and stripes. |
| Header Background / Text | Specific colors for table headers. |
| Body / Label / Border Color | Text and line colors for the main document. |
| Zebra Stripe Rows | Toggle alternating row colors in tables. |
2. Typography Tab
| Field | Purpose |
|---|---|
| Font Family | 14+ Options (Arial, Roboto, etc.). |
| Line Height | Vertical text spacing spacing. |
| Font Sizes | Controls for Header, Body, and Table text sizes. |
| Text Direction | LTR (default) or RTL. |
3. Header Fields Tab
| Group | Toggles |
|---|---|
| Partner Info | Name, Address, VAT, Phone, Email |
| Document Info | Document Date, Delivery Date, Source Document (Invoice), Validity/Due Date, Salesperson/Buyer, Payment Terms, Payment Reference |
| Layout Control | Paper Format (A4/Letter/Legal), Orientation (Portrait/Landscape), Layout Density (Standard/Compact/Spacious) |
4. Order Lines Tab
| Group | Toggles |
|---|---|
| Line Columns | Line #, Product Ref, Description, Quantity, UoM, Unit Price, Discount, Taxes, Subtotal, Payment Reference |
| Totals Section | Show Untaxed Amount, Show Tax Amount, Show Total Amount |
| Display Mode | Classic Table vs Modern Cards/Widgets (Premium Feature) |
5. Footer Tab
| Field | Purpose |
|---|---|
| Show Terms & Conditions | Toggle standard Odoo terms/conditions text. |
| Show Print Date/Time | Display timestamp when document was printed. |
| Show Signature Box | Toggle signature box with custom label field (default: "Signature"). |
| Signature Label | Custom text for signature box (e.g. "Approved By", "Authorized Signature"). |
| Show QR Code | Display QR code for portal access or payment (SEPA/EPC QR for invoices). |
| QR Code Position | Choose: Header, Footer, or Payment Section positioning. |
6. Layout Tab
| Section | Options |
|---|---|
| Paper Format | A4 (210x297mm), US Letter (215.9x279.4mm), US Legal (215.9x355.6mm) |
| Orientation | Portrait or Landscape |
| Text Direction | LTR (Left-to-Right) or RTL (Right-to-Left) for Arabic/Hebrew |
| Margins | Top (default 40mm), Bottom (28mm), Left (7mm), Right (7mm) - fully customizable |
| Number Formatting | Thousand Separator (comma/period/space/none), Decimal Separator (period/comma) |
| Date Format | Multiple formats: DD/MM/YYYY, MM/DD/YYYY, YYYY-MM-DD, DD.MM.YYYY, DD-MM-YYYY |
7. Watermark Tab
| Field | Description |
|---|---|
| Use Watermark | Enable/Disable the entire watermark system (checkbox toggle). |
| Watermark Text | The text string to display (e.g. "DRAFT", "CONFIDENTIAL", "ORIGINAL", "COPY"). |
| Watermark Opacity | Transparency level (0.0 = invisible, 1.0 = fully opaque). Default: 0.1 for subtle effect. |
| Watermark Rotation | Angle in degrees (0-360°). Default: 45° for diagonal display. Use 0° for horizontal text. |
| Watermark Font Size | Text size in pixels (default: 120px). Increase for full-page watermarks, decrease for subtle stamps. |
8. Custom Content Tab
| Editor | Capability |
|---|---|
| Custom Header HTML | Inject raw HTML/CSS into the document header section. Useful for promotional banners, special logos, or complex branding. Automatically sanitized for safety. |
| Custom Footer HTML | Inject raw HTML/CSS into the document footer section. Perfect for bank details, legal disclaimers, social media links, or multi-column contact info. |
| Custom CSS | Advanced styling overrides. Write custom CSS rules to fine-tune spacing, fonts, or element positioning beyond standard fields. Use with caution - can override template styling. |
9. Premium Features Tab
| Feature | Description |
|---|---|
| Enable Page Border | Adds decorative border around entire document page. Toggle on/off. |
| Border Style | Choose from: Solid, Double, Dashed, Dotted, Groove, Ridge, Inset, Outset styles. |
| Border Width | Border thickness in pixels (default: 2px). Increase for bold frames. |
| Border Color | Custom hex color for page border (syncs with primary color by default). |
| Report Background Color | Sets entire page background color (default: white #FFFFFF). Use for colored paper effect or Dark Mode. |
| Layout Style | Density control: Standard (balanced), Compact/High Density (more lines per page), Spacious/Low Density (generous whitespace). |
| Address Position | Controls partner address placement: Right (default), Left, or Center alignment in header. |
| Show Product Images | Display product thumbnails in order line items. Requires products to have images uploaded. |
| Display Mode | Choose presentation style: Table (classic grid), Cards (modern boxes), Widgets (compact inline). Default: Table. |
| Custom CSS | Advanced class-based overrides. |
This module uses standalone QWeb templates to ensure maximum design stability. While we include extensive PO translation files for major languages, some standard Odoo terms may rely on your specific database configuration.
Recommendation: We strongly advise testing this module in a Staging/Test Environment first. This ensures all field labels and terms align with your local language requirements before deploying to Production.
🤝 Support & Legal
Email: support@hexalian.com
© 2026 Hexalian LLC. All Rights Reserved.
Hex Report Studio is a module for Odoo. Odoo is a trademark of Odoo S.A.
The images shown are for illustrative purposes and may differ slightly from the final product.
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module