Table of Contents
-
Introduction
-
About Dolibarr and Its Release Cycle
-
Overview of Version 22.0
-
User Interface and Experience Improvements
-
Enhancements in the Core ERP Modules
-
5.1 CRM and Third Parties
-
5.2 Invoicing and Payments
-
5.3 Products and Services
-
5.4 Stock and Warehousing
-
5.5 Accounting and Finance
-
-
HR and Payroll Module Updates
-
Project and Task Management Features
-
New API and Developer Tools
-
Security and Performance Optimizations
-
Integration and Interoperability
-
Deprecated Features and Migration Notes
-
Community Contributions and Module Ecosystem
-
Recommended Modules Now Compatible with 22.0
-
Tips for a Safe Upgrade to 22.0
-
Final Thoughts
-
Resources and Download Links
1. Introduction
With every major release, Dolibarr ERP & CRM evolves to meet the growing and changing demands of SMEs, freelancers, and organizations around the world. Version 22.0 continues this tradition with a wide range of new features, usability improvements, and architectural refinements designed to enhance both functionality and performance.
In this detailed article, we explore everything you need to know about Dolibarr 22.0: from new features and interface updates to module improvements, technical upgrades, and community contributions. Whether you're a business owner, consultant, developer, or ERP administrator, this guide will help you understand what’s new and how to benefit from it.
2. About Dolibarr and Its Release Cycle
Dolibarr is a modular, open-source ERP and CRM system that serves as an all-in-one suite for business management. Its scope includes invoicing, CRM, stock, human resources, projects, accounting, and more.
The Dolibarr Foundation follows a regular release cycle, delivering major versions twice per year, typically in June and December. Each major release introduces new features, while minor updates (e.g., 22.0.1, 22.0.2) deliver security fixes and performance improvements.
Version 22.0, released in June 2025, is the first major release of the year and comes with substantial upgrades across several functional and technical layers.
3. Overview of Version 22.0
Dolibarr 22.0 includes over 180 improvements, 50+ bug fixes, and multiple new features requested by the community. Some of the key highlights include:
-
Improved responsive UI for mobile and tablet users
-
More powerful filtering and search options
-
New permissions and role-management features
-
Significant improvements in the Accounting, HR, and Project modules
-
API enhancements for external integrations
-
Compatibility updates for PHP 8.3 and MySQL 8.0+
-
Multiple security hardening measures
-
Refined document generation and numbering tools
This release reflects Dolibarr’s commitment to user-centered development and modern technology standards.
4. User Interface and Experience Improvements
Dolibarr 22.0 focuses significantly on improving the end-user experience, particularly in terms of responsiveness, usability, and clarity.
Modernized UI Elements
-
New button styling for better visibility
-
Enhanced modal dialogs for quicker actions
-
More intuitive navigation in top menus
-
Cleaner layout on invoice, project, and product pages
Improved Responsive Behavior
Mobile and tablet views are more reliable thanks to:
-
Responsive tables with horizontal scrolling
-
Collapsible menus for smaller screens
-
Reflowed forms and input fields
Customizable Dashboards
Users can now:
-
Add widgets more easily
-
Customize home page dashboards by role
-
Use new graphs and KPI tiles for invoices, sales, and inventory
These enhancements significantly boost productivity, especially for users managing tasks from mobile devices.
5. Enhancements in the Core ERP Modules
Each of Dolibarr's core business modules received attention in version 22.0. Below, we detail the most important changes.
5.1 CRM and Third Parties
-
New status field for customer and prospect lifecycle management
-
Ability to assign custom tags to leads and contacts
-
Improved email templates with placeholders for third-party metadata
-
Option to define default payment conditions per customer group
5.2 Invoicing and Payments
Dolibarr’s billing engine now includes:
-
Recurring invoice enhancements, including better control of start/stop logic
-
Configurable invoice numbering masks by project or client group
-
New settings for partial payments and prepayment tracking
-
Extended PDF customization options for headers, footers, and footnotes
These changes offer greater automation and flexibility for businesses with diverse billing needs.
5.3 Products and Services
Improvements include:
-
Easier product category selection with multi-select UI
-
New inventory fields (e.g., min/max reorder levels visible on product pages)
-
Bulk update features for pricing, tax, and stock thresholds
-
New multi-warehouse assignment logic for SKUs
5.4 Stock and Warehousing
Warehouse management is enhanced with:
-
Improved inter-warehouse transfer tools
-
Alerts for pending deliveries and discrepancies
-
Option to log movement reasons (e.g., damage, loss, manual adjustment)
-
Inventory freeze dates for audit compliance
5.5 Accounting and Finance
One of the most requested areas for improvement:
-
New journals by module: separate entries for sales, purchases, bank
-
Multi-period financial reports (quarterly, YTD)
-
New VAT ledger views by tax code and jurisdiction
-
Accounting export improvements (compatibility with Sage, Odoo, QuickBooks)
-
Better support for custom chart of accounts
This version makes Dolibarr’s accounting module much more powerful and better suited for country-specific adaptations.
6. HR and Payroll Module Updates
Dolibarr 22.0 includes important updates for HR teams:
-
Enhanced leave and holiday calendar with color coding and filters
-
Timesheet import improvements (CSV, XLSX)
-
Ability to attach scanned contracts or job descriptions to employee records
-
Payroll entries can now be linked to accounting journals
-
Improved CNSS and IGR reporting compatibility for Moroccan and francophone users
These updates help align HR with legal, fiscal, and accounting requirements, especially in regions where compliance is tightly regulated.
7. Project and Task Management Features
Project-driven teams will find several improvements in Dolibarr 22.0 that enhance how tasks are assigned, tracked, and invoiced.
New Features for Project Management:
-
Gantt View Enhancements: You can now collapse/expand project trees, adjust task durations via drag-and-drop, and export Gantt views in PDF format.
-
Custom Task Statuses: Define your own workflow statuses beyond the default "To Do / In Progress / Done".
-
Task Dependencies: Tasks can now be linked using dependency logic, supporting workflows with sequential phases.
-
Improved Project Dashboard: KPIs such as budget consumption, hours logged, and overdue tasks are now visualized directly on the project summary screen.
-
Project Billing Enhancements: Invoices can be generated based on tasks marked as billable, including a new "billable by milestone" option.
These updates make Dolibarr much more practical for agencies, consulting firms, freelancers, and technical project managers who need reliable tracking and billing tools.
8. New API and Developer Tools
For developers and integrators, version 22.0 offers enhanced flexibility and more complete data access.
REST API Improvements:
-
New endpoints for:
-
Stock transfers
-
Journal entries
-
Employee leave requests
-
Project tasks with sub-tasks
-
-
API authentication supports OAuth 2.0 and API keys
-
Better error responses with detailed status messages
-
Pagination and filtering now available on nearly all endpoints
Hooks and Triggers:
-
Additional hooks for developers to integrate into workflows:
-
Before/after invoice validation
-
On leave approval
-
On stock movement
-
-
Custom triggers can now be managed via the GUI in the admin panel
Module Development Enhancements:
-
New helper classes and functions to reduce code duplication
-
Improved module descriptor logic for faster installation and compatibility checks
-
Automatic language string extraction for translation
Dolibarr continues to solidify itself as a developer-friendly ERP framework, opening the door to more advanced custom modules and external apps.
9. Security and Performance Optimizations
Security and performance were high priorities in the 22.0 development cycle.
Security Enhancements:
-
Improved protection against CSRF attacks
-
Updated session timeout logic for better control
-
IP whitelisting for sensitive admin areas
-
ReCAPTCHA integration for login and contact forms
-
HTTPS-only cookie enforcement (when available)
Performance Upgrades:
-
Faster page rendering through optimized SQL queries
-
Caching added to certain dashboard KPIs and charts
-
Improved performance of batch operations (invoice generation, mass updates)
-
Asynchronous email sending support for higher-volume operations
These improvements are especially relevant for cloud-hosted Dolibarr instances, where performance under load is critical.
10. Integration and Interoperability
Dolibarr 22.0 introduces better support for third-party integrations, including:
-
Email Services: Improved SMTP support, compatibility with Sendinblue, Mailgun, Gmail
-
Payment Gateways: Updated modules for Stripe and PayPal, plus new compatibility with Moroccan and European providers
-
E-commerce: Sync modules for WooCommerce and PrestaShop updated to be fully compatible with 22.0
-
Accounting Software: New export profiles for Odoo, Sage FR, QuickBooks Desktop, and CSV with journal formatting
The push toward interoperability continues to make Dolibarr an ideal base ERP that connects easily to a larger digital ecosystem.
11. Deprecated Features and Migration Notes
With every major release, some features are deprecated or changed. In version 22.0:
-
Legacy Accounting Module (pre-13.0) is no longer supported
-
PDF templates using old TCPDF class structure should be updated to the new DOMPDF engine
-
Old-style theme compatibility has been removed (only modern responsive themes are supported)
-
Some deprecated API endpoints have been retired (see changelog for specifics)
Migration Checklist:
-
Back up your data before upgrade
-
Test all third-party modules for compatibility
-
Update your PHP version to at least 8.1
-
Review and clean up deprecated templates
-
Reconfigure cron jobs (a new scheduler format is used)
As always, test the upgrade in a staging environment before deploying to production.
12. Community Contributions and Module Ecosystem
Dolibarr 22.0 is not just a product of its core development team—it’s also the result of community participation.
Contributions in This Release:
-
More than 90 contributors worldwide
-
20+ community-submitted pull requests merged
-
Translations updated in 15+ languages
-
Several bug fixes and patches proposed by Moroccan, French, and German users
Ecosystem Highlights:
-
Dolistore modules are increasingly being updated for compatibility with version 22
-
Popular modules such as Advanced Projects, Moroccan Chart of Accounts, Inventory Extensions, and Custom PDF Designer are now available in 22.x-compatible versions
-
Community forums have new documentation threads and tutorials, particularly in French and Spanish
This active ecosystem ensures that Dolibarr continues to evolve from both the top-down and bottom-up.
13. Recommended Modules Now Compatible with 22.0
Some of the best-reviewed and most useful third-party modules now tested and compatible with version 22 include:
Module Name | Purpose |
---|---|
Multi-Warehouse Extended | Better control over stock in multiple locations |
Advanced Accounting Reports | Enhanced ledgers, balance sheets, and VAT declarations |
HRM Complete | Payroll, leave, and compliance tools in one package |
Document Designer | Full control over invoice and proposal PDFs |
WooCommerce Sync Pro | Live stock and order sync between e-commerce and ERP |
FEC Export Morocco | Legal file generation for Moroccan businesses |
Be sure to check module documentation and confirm compatibility before installation.
14. Tips for a Safe Upgrade to 22.0
Upgrading a live ERP system requires caution. Follow these steps:
Before You Upgrade:
-
Backup database and documents
-
Test on a cloned/staging server
-
Deactivate non-essential modules
-
Read the full 22.0 changelog
During Upgrade:
-
Use the Dolibarr upgrade wizard
-
Let it handle database migrations
-
Monitor logs for error messages
-
Reapply any custom themes or templates after core files update
After Upgrade:
-
Test critical functions: invoicing, orders, payments
-
Review cron job behavior and logs
-
Verify user permissions and roles
-
Clear cache and update language packs
Taking these precautions ensures a smooth transition with minimal downtime.
15. Final Thoughts
Dolibarr 22.0 is a mature, polished, and performance-oriented release that continues to show why this ERP is trusted by thousands of SMEs across the world. Whether you're looking to improve invoicing, manage complex projects, maintain accounting compliance, or integrate with e-commerce, version 22.0 has something for you.
With enhanced usability, better mobile compatibility, more advanced reporting, and stronger APIs, Dolibarr takes a major step forward as a modern, scalable, and fully open-source ERP system.
For business owners and IT teams alike, the 22.0 release represents a great time to upgrade, streamline processes, and expand what you do with Dolibarr.