Supported Features
URL/HTML to PDF Conversion
The URL/HTML to PDF Conversion operation lets you convert any publicly accessible webpage or raw HTML content into a downloadable PDF file. This is ideal for automating the creation of invoices, receipts, reports, or web page snapshots directly from HTML templates or live URLs. Simply provide either a valid URL or an HTML string as input. PDF.co will generate a high-quality PDF and return a file URL that you can use in the next step of your workflow—such as sending via email, storing in Google Drive, or combining with other documents.
Input
| Name | Description | Required |
|---|---|---|
| Convert Type | Choose the type of conversion you want to perform: URL to PDF, HTML to PDF, or HTML Template to PDF. If you’ve previously created an HTML template in PDF.co, you can select the template (by copying the Template ID) to inject it with dynamic JSON data and generate a PDF automatically. | Yes |
| Source File URL | Provide the URL to the source PDF document, or a filetoken:// link from PDF.co Built-In Files Storage. If you use another cloud service such as Google Drive or Dropbox ensure the link is publicly accessible. | Yes |
| HTML Code | Enter the HTML code you want to convert into a PDF file. | No, unless you’re using HTML to PDF |
| Template ID | Set ID of HTML template to be used. View and manage your templates at HTML to PDF Templates. See guidance below to learn more about HTML Template to PDF conversion. | No, unless you’re using HTML Template to PDF |
| File Name | File name for the generated output, the input must be in string format. | No |
| Orientation | Sets the document orientation. Options: Portrait for vertical layout, and Landscape for horizontal layout. | No |
| Paper Size | Specifies the paper size. Supports standard formats such as Letter, Legal, Tabloid, Ledger, and A0 to A6. If you need a custom size, use the Custom Paper Size option instead. Do not use both Paper Size and Custom Paper Size at the same time. | No |
| Custom Paper Size | Set a custom size by providing width and height separated by a space, with optional units: px (pixels), mm (millimeters), cm (centimeters), or in (inches). Examples: ‘200 300’, ‘200px 300px’, ‘200mm 300mm’, ‘20cm 30cm’, ‘6in 8in’. | No |
| Render Page Background | Set to false to disable background colors and images are included when generating PDFs from HTML/URL | No |
| Do Not Wait for Full Load | Controls how thoroughly the converter waits for a page to load before converting HTML to PDF --- false waits for full page load, while true speeds up conversion by waiting only for minimal loading. | No |
| Margins | Set custom margins, overriding CSS default margins. Specify the margins in the format {top} {right} {bottom} {left}. You can usepx,mm,cmorinunits. Also, you can set margins for all sides at once using a single value. | No |
| Media Type | Controls how content is rendered when converting to PDF. Options: print (uses print styles), screen (uses screen styles), none (no media type applied). | No |
| Header | Add HTML code for the page header. This content will appear at the top of every page in the generated PDF. | No |
| Footer | Add HTML code for the page footer. This content will appear at the top of every page in the generated PDF. | No |
| Webhook URL | The callback URL or Webhook used to receive the output data. | No |
| Output Link Expiration (In Minutes) | Set the expiration time for the output link in minutes. After this specified duration, any generated output file(s) will be automatically deleted from PDF.co Temporary Files Storage. The maximum duration for link expiration varies based on your current subscription plan. To store permanent input files (e.g. re-usable images, pdf templates, documents) consider using PDF.co Built-In Files Storage. | No |
| Custom Profiles | Use JSON to customize PDF processing with options like output resolution, OCR settings, text extraction methods, encryption, and image handling. Check our Custom Profiles section to see all available parameters for your current endpoint. | No |
HTML Template to PDF
HTML Template to PDF conversion allows you to transform predefined HTML templates into PDF documents with injected data. Each HTML template has a unique ID, you simply need to enter this ID in your n8n module and provide the required data in JSON format. You can create your own templates or use the predefined ones available in the PDF.co HTML Templates Tool. You can use data in JSON or CSV format to inject into your HTML template. See the sample below:JSON Sample
CSV Sample
Custom Profiles
You can set additional options for the operation used in the PDF.co node by using Custom Profiles. A custom profile is a string in JSON-like format containing predefined parameters. Here’s an example of a Custom Profiles input:base64 format. You can find the list of available parameters for customizing profiles in the PDF.co operation documentation below:
| Parameter | Type | Default | Description |
|---|---|---|---|
outputDataFormat | string | - | If you require your output as base64 format, set this to base64 |
HTMLCodeHeadInject | string | - | Injects custom CSS and JavaScript code into the HTML <head> section during conversion. See HTML to PDF Knowledge Base for more information and sample usage. |
DataEncryptionAlgorithm | string | - | Controls the encryption algorithm used for data encryption. See User-Controlled Encryption for more information. The available algorithms are: AES128, AES192, AES256. |
DataEncryptionKey | string | - | Controls the encryption key used for data encryption. See User-Controlled Encryption for more information. |
DataEncryptionIV | string | - | Controls the encryption IV used for data encryption. See User-Controlled Encryption for more information. |
DataDecryptionAlgorithm | string | - | Controls the decryption algorithm used for data decryption. See User-Controlled Encryption for more information. The available algorithms are: AES128, AES192, AES256. |
DataDecryptionKey | string | - | Controls the decryption key used for data decryption. See User-Controlled Encryption for more information. |
DataDecryptionIV | string | - | Controls the decryption IV used for data decryption. See User-Controlled Encryption for more information. |
Output
| Name | Description |
|---|---|
jobId | Unique identifier for the background job. |
pageCount | Number of pages in the PDF document. |
error | Indicates whether an error occurred (false means success) |
status | Status code of the request (200, 404, 500, etc.). For more information, see Response Codes. |
credits | Number of credits consumed by the request |
remainingCredits | Number of credits remaining in the account |
duration | Time taken for the operation in milliseconds |
url | Direct URL to the final PDF file stored in S3. |
name | Name of the output file |
outputLinkValidTill | Timestamp indicating when the output link will expire |