printing-templates

Frappe Printing & Templates

Create print formats, email templates, and document templates using Jinja in Frappe.

When to use

• Creating custom print formats for documents
• Building email templates with dynamic content
• Generating PDFs from documents
• Using Jinja templating in web pages
• Configuring letter heads for branding
• Using the Print Format Builder

Inputs required

• Target DocType for the print format
• Layout requirements (fields, tables, headers)
• Whether format is standard (version controlled) or custom (DB-stored)
• Letter Head / branding requirements
• PDF generation needs

Procedure

0) Choose format type

Type	How to Create	Version Controlled	Customizable by User
Standard	Developer Mode, saved as JSON	Yes	No
Print Format Builder	Drag-and-drop UI	No (DB)	Yes
Custom HTML (Jinja)	Type "new print format" in awesomebar	Optional	Depends

1) Create a Jinja print format

Create via awesomebar → "New Print Format":

1. Set a unique name
2. Link to the target DocType
3. Set "Standard" = "No" (or "Yes" for dev mode export)
4. Check "Custom Format"
5. Set Print Format Type = "Jinja"
6. Write your Jinja HTML

<div class="print-format">
    <h1>{{ doc.name }}</h1>
    <p><strong>{{ _("Customer") }}:</strong> {{ doc.customer }}</p>
    <p><strong>{{ _("Date") }}:</strong> {{ frappe.format_date(doc.transaction_date) }}</p>

    <table class="table table-bordered">
        <thead>
            <tr>
                <th>{{ _("Item") }}</th>
                <th>{{ _("Qty") }}</th>
                <th class="text-right">{{ _("Rate") }}</th>
                <th class="text-right">{{ _("Amount") }}</th>
            </tr>
        </thead>
        <tbody>
            {% for item in doc.items %}
            <tr>
                <td>{{ item.item_name }}</td>
                <td>{{ item.qty }}</td>
                <td class="text-right">{{ frappe.format(item.rate, {'fieldtype': 'Currency'}) }}</td>
                <td class="text-right">{{ frappe.format(item.amount, {'fieldtype': 'Currency'}) }}</td>
            </tr>
            {% endfor %}
        </tbody>
        <tfoot>
            <tr>
                <td colspan="3" class="text-right"><strong>{{ _("Total") }}</strong></td>
                <td class="text-right"><strong>{{ frappe.format(doc.grand_total, {'fieldtype': 'Currency'}) }}</strong></td>
            </tr>
        </tfoot>
    </table>

    {% if doc.terms %}
    <div class="terms">
        <h4>{{ _("Terms & Conditions") }}</h4>
        <p>{{ doc.terms }}</p>
    </div>
    {% endif %}
</div>

<style>
    .print-format { font-family: Arial, sans-serif; }
    .print-format h1 { color: #333; }
    .print-format table { width: 100%; margin-top: 20px; }
</style>