PDF Annexes · Dolibarr 18 → 24

PDF Annexes
Dolibarr installation guide

Prerequisites, installation in custom/, configuration, first test and update. Start on a copy of your database.

Updated 9 October 2026 · Dolibarr 18 → 24 · PHP 7.4 – 8.3 · version 1.0.0

1. Prerequisites

Dolibarr 18 to 24 with PHP 7.4 to 8.3. Nothing else: no Composer, no server binary, the module uses the PDF engine shipped with Dolibarr. Prepare your annexes as unprotected PDFs (terms of sales, bank details, brochure).

2. Install the module

Download the archive from Dolistore and unzip it into custom/pdfannexes, or deploy it from Home → Setup → Modules/Applications → Deploy external module. Enable PDF Annexes and open its setup with the gear icon.

3. Create the first rule

Click “New rule”, name it “Terms of sales”, tick Quotes, Orders and Invoices, upload your terms PDF (it is checked at once and its page count displayed), keep the position “After the document (end)” and save. The rule appears in the table as active.

PDF Annexes — module setup in Dolibarr

4. Add conditional rules

Create further rules with conditions: a brochure “Before the document (cover)” with a minimum amount incl. tax, export terms with the country condition “Third party country NOT IN the list” and FR, or English terms with the language en. Order decides the merge sequence between rules.

5. Enable product datasheets

In the product annexes section, keep the pattern mode, adjust the file name patterns (FT_* by default, among others) and tick the document types concerned. Attach a PDF named accordingly to a product: it will be appended once at the end of the documents that contain that product.

6. Test on a quote

Open a quote, click Generate in the attached files box and open the PDF: the annexes must appear at the chosen positions. Send the quote by e-mail from Dolibarr: the attachment is the merged file. If Factur-X France is enabled, check that an invoice in a Factur-X context is left untouched.

7. Update

Replace the custom/pdfannexes directory with the new version, then disable and re-enable the module. Rules and uploaded files are kept.

Module page on the Dolibarr wiki ↗