Print Settings
Print Settings allow you to configure how documents are printed or exported in ERPNext. You can define PDF preferences, page layout options, draft printing behavior, paper size, network printers, and other printing-related settings.
Since ERPNext is browser-based, the actual print command is executed by your web browser.
Access Print Settings
Navigate to:
Home → Settings → Print SettingsPDF Settings
1. Send Print as PDF
By default, documents shared through email are sent as PDF attachments.
- Enable this option to send documents as PDF.
- Disable it to send documents in HTML format.
PDF is the default format used when emailing documents from ERPNext.
2. Repeat Header and Footer in PDF
Letter Heads contain the standard header and footer used in printed documents.
- Enable this option to repeat the header and footer on every page.
- Disable it if you want the header and footer to appear only once.
3. PDF Page Size
Select the paper size used while generating PDF documents.
The default page size is A4, although other standard paper sizes and custom dimensions can also be selected.
Page Settings
1. Print With Letterhead
Automatically includes the configured Letter Head whenever a document is printed.
A default Letter Head must be configured or selected within the document for it to appear.
2. Compact Item Print
This option simplifies the Items table in printed sales and purchase transactions.
Instead of displaying every item-related column, the print format shows only:
- Description
- Quantity
- Rate
- Amount
Additional information such as Item Code, Item Name, Serial Numbers, Images, and Description is combined into the Description column.
Enable Compact Item Print to create cleaner and more readable transaction printouts.
3. Allow Print for Draft
Draft documents are saved but not yet submitted.
Enable this option if users should be allowed to print documents before submission.
4. Always Add “Draft” Heading
When enabled, every printed draft document displays a prominent Draft label.
This clearly indicates that the document has not yet been officially submitted.
5. Allow Page Break Inside Table
Allows long item descriptions to continue onto the next page instead of forcing the entire row onto a single page.
This improves the formatting of lengthy documents with large descriptions.
6. Allow Print for Cancelled Documents
Allows printing of documents that have been cancelled.
Cancelled documents no longer affect accounting or operational reports but may still be required for audit or reference purposes.
7. Print Taxes with Zero Amount
By default, taxes with zero calculated value are hidden in printed documents.
Enable this option to display all configured tax rows, including those with zero amounts.
Network Printer / Print Server
ERPNext supports printing through a network print server.
To configure a print server:
- Enter the Print Server IP address.
- Specify the Port Number.
- Select the default printer.
Before using this feature, install the required printing libraries on the server.
Required Dependencies
Debian-based systems
sudo apt-get install libcups2-devRed Hat-based systems
sudo yum install cups-libsInstall pycups
./env/bin/pip install pycupsRun the above command from the frappe-bench directory.
Raw Printing
ERPNext also supports Raw Printing for compatible thermal printers.
Raw Printing sends print commands directly to supported printers, making it ideal for POS receipts, barcode labels, and thermal printing.
Best Practices
- Use PDF as the default format when sharing official documents.
- Enable Compact Item Print for documents containing many item columns.
- Use the Draft watermark when printing documents before approval.
- Allow printing of cancelled documents only if required for audit or compliance.
- Verify network printer configuration before enabling Print Server settings.
