> ## Documentation Index > Fetch the complete documentation index at: https://docs.penquify.com/llms.txt > Use this file to discover all available pages before exploring further. # Custom Templates > Create new document templates with Jinja2 HTML. ## Overview Penquify uses Jinja2 HTML templates to render documents. The default template is `guia_despacho.html` (Chilean dispatch guide). You can add your own templates for invoices, purchase orders, bills of lading, or any other document type. ## Template Location Templates live in `penquify/templates/`. Add your `.html` file there. ## Available Variables Templates receive the full document data via `doc.to_dict()`: | Variable | Type | Description | | ------------------------ | ------------ | ------------------------- | | `header.doc_type` | `str` | Document type identifier | | `header.doc_number` | `str` | Document number | | `header.date` | `str` | Document date | | `header.emitter_name` | `str` | Emitter company name | | `header.emitter_rut` | `str` | Emitter tax ID | | `header.emitter_giro` | `str` | Emitter business activity | | `header.emitter_address` | `str` | Emitter address | | `header.receiver_name` | `str` | Receiver company name | | `header.receiver_rut` | `str` | Receiver tax ID | | `header.oc_number` | `str` | Purchase order reference | | `items` | `list[dict]` | Array of line item dicts | | `observations` | `str` | Handwritten notes | | `subtotal` | `float` | Computed subtotal | | `iva` | `float` | 19% VAT | | `total` | `float` | Grand total | Each item in `items` has: `pos`, `code`, `description`, `qty`, `unit`, `unit_price`, `total`, `batch`, `sap_material`, `sap_qty`, `sap_unit`. ## Template Structure Create `penquify/templates/my_invoice.html`: ```html theme={null}

{% for item in items %} {% endfor %}

Pos	Codigo	Descripcion	Cant	UM	P.Unit	Total
{{ item.pos }}	{{ item.code }}	{{ item.description }}	{{ item.qty }}	{{ item.unit }}	{{ "${:,.0f}".format(item.unit_price) }}	{{ "${:,.0f}".format(item.total) }}

Subtotal: ${{ "{:,.0f}".format(subtotal) }}

IVA 19%: ${{ "{:,.0f}".format(iva) }}

Total: ${{ "{:,.0f}".format(total) }}

``` ```python theme={null} files = await generate_document_files(doc, "output/", template_name="my_invoice.html") ``` Or via CLI: ```bash theme={null} penquify pdf --doc-json doc.json --output output/ ``` Or via API: ```json theme={null} { "header": { ... }, "items": [ ... ], "template": "my_invoice.html" } ``` Wrap your document content in a `div.page` element. The PNG renderer looks for `.page` to screenshot. If not found, it captures the full viewport. ## Design Tips * Use a fixed `width` (e.g. 850px) for consistent rendering across documents * Use standard fonts that Playwright's Chromium can render * Keep the design realistic -- penquify generates photos of these documents, so they should look like real printed pages * Test your template by generating the PDF first before creating photo variations

{{ header.emitter_name }}

FACTURA N {{ header.doc_number }}