- Home
- Resources
- Integrations
- CloudConvert
CloudConvert n8n integrationAutomate CloudConvert with n8n.
Files land in a workflow and have to be converted, compressed or locked down before anyone can use them. The CloudConvert n8n integration puts that work in one node: 17 operations across 5 resources, from PDF merging to website capture. There is no trigger on its side; the workflow starts elsewhere.
Community node This node is not shipped with n8n: it is a community package (@cloudconvert/n8n-nodes-cloudconvert) you install from Settings › Community nodes on a self-hosted instance. npm
Verified Trustpilot reviews · AI, automation & growth agency
What does the CloudConvert n8n integration actually do?
CloudConvert turns a file into another file: a different format, a smaller size, a searchable scan, a watermarked copy. The n8n node wraps that API so a workflow can do it between two other steps, without a person downloading anything. One node, 5 resources (Command, File, Metadata, PDF, Website) and 17 operations, in node version 1.
Take invoices arriving as attachments. A workflow reads the inbox with Gmail, passes the binary file to file.convert to get a clean PDF, then runs pdf.pdf/ocr so the scanned ones become searchable. The output goes back into the flow as binary data, ready for storage or for a second CloudConvert call.
Second pattern: monthly reporting. A workflow pulls the rows it needs from Google Sheets, renders each report, then uses file.archive to bundle everything into one ZIP and file.thumbnail to produce a preview image for the page that lists them in Notion. Nobody opens a conversion site by hand.
Third pattern: monitoring a public page. On a schedule, website.capture-website renders a URL as PDF or as a JPG screenshot, and the file is posted to a channel with Slack. Same idea for pricing pages, status pages, or a landing page you want dated proof of.
When an operation is not in the list, the HTTP Request node calls any CloudConvert API endpoint and reuses the same credential through predefined authentication. That is the right move for parts of the API the node does not cover, and it keeps the credential in one place. The trade offs between running this yourself and paying per operation are laid out in the n8n review.
Two limits worth knowing before building. CloudConvert has no trigger node in n8n, so the workflow has to start with a Schedule Trigger on a fixed interval, an n8n Webhook called by another service, or the trigger of another tool. And because this is a community node, it installs on a self hosted instance; n8n Cloud only accepts verified community nodes.
How do you connect CloudConvert to n8n?
- 01
Install the community node
CloudConvert does not ship with n8n. Open Settings, then Community nodes, and install the npm package
@cloudconvert/n8n-nodes-cloudconvert(version 1.1.1). This works on a self hosted instance, whether n8n runs through Docker or npm. On n8n Cloud, the hosted offer run by n8n, only verified community nodes can be installed. Once the package is in, CloudConvert appears in the node search like any other node. - 02
Create the credential
Go to the Credentials menu and add a CloudConvert credential. Two authentication methods exist: OAuth2 (Recommended), where CloudConvert hands n8n a token after you approve the connection, and API Key, where you paste a key from your CloudConvert account. A credential is created once and reused across every workflow, so a second file pipeline does not need a second key.
- 03
Pick it in the node and run once
Drop the CloudConvert node into a workflow and select the credential from its dropdown. Choose a resource, then an operation, and point Binary Property at the field holding the file, usually
datafrom the node before it. Execute the node on one real item and look at the output binary before wiring the rest of the flow behind it.
What can the CloudConvert node do?
The CloudConvert node exposes 17 operations across 5 resources. For each one: the node as you configure it in n8n, the required fields, and our field notes.
| Resource | Create Archive | Capture Website | Execute Command | Convert File | Get Metadata | Write Metadata | Optimize File | Convert PDF to PDF/A | Decrypt PDF | Encrypt PDF | Extract Pages From PDF | Merge Files | Add PDF OCR Layer | Rotate PDF Pages | Split PDF Into Pages | Create Thumbnail | Add Watermark |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Command | ✓ | ||||||||||||||||
| File | ✓ | ✓ | ✓ | ✓ | ✓ | ||||||||||||
| Metadata | ✓ | ✓ | |||||||||||||||
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||||||||
| Website | ✓ |
Operations index
Command
1 operationExecute command
command.commandWhat you see in n8n
Notes & use cases
Runs a custom ffmpeg, ImageMagick or GraphicsMagick command on the input file, which covers anything the ready made operations do not.
Key parameters
- Command: the base command to execute, for example
ffmpegorconvert; the supported commands are listed in the CloudConvert docs. - Engine: FFmpeg, ImageMagick or GraphicsMagick.
- Arguments: input files are read from
/input/{taskName}/and output must be written to/output/. - Capture Console Output: returns the console output in the result, which is how you debug a failing command.
File
5 operationsAdd watermark to a file
file.watermarkWhat you see in n8n
Notes & use cases
Stamps a watermark onto a PDF, an image or a video, and returns the marked copy while the original stays untouched.
Key parameters
- Text: the text used as watermark, often an expression such as
{{ $json.state }}. - Font Size: required, and worth testing on the largest page format you handle.
- Image URL: a PNG, JPG or SVG to use instead of text, paired with Watermark Image.
- Opacity: a percentage, where 100 means fully visible.
- Vertical Position and Horizontal Position: top, center or bottom, and left, center or right.
Convert a file
file.convertWhat you see in n8n
Notes & use cases
The core operation: one file in, the same content in another format out.
Key parameters
- Output Format: the format to convert to, picked from the dropdown.
- Input File Name: the filename with its extension, which is how CloudConvert knows what it received.
- Binary Property: the binary field carrying the file to convert.
- Additional Options: a JSON dictionary of extra options added to the converting task; the CloudConvert job builder generates them for you.
Create archive
file.archiveWhat you see in n8n
Notes & use cases
Bundles several files into a single archive, so the workflow carries one item instead of eight.
Key parameters
- Output Format: the archive format, ZIP, RAR or another supported one.
- Input File Contents: the text content uploaded when the file is not binary.
- Binary Input Data: switch it on to take the files from a binary field instead.
- Input File Name: the name with extension, which becomes the entry inside the archive.
Create a thumbnail
file.thumbnailWhat you see in n8n
Notes & use cases
Produces a small preview image of a file, useful when a list needs to show something before the file is opened.
Key parameters
- Width and Height: the thumbnail size in pixels.
- Fit: Max keeps the image inside the box without enlarging a smaller one, Crop fills the box and cuts the excess, Scale forces both dimensions.
- Output Format: the image format returned.
- Binary Property: the field holding the source file.
Optimize a file
file.optimizeWhat you see in n8n
Notes & use cases
Compresses a file to reduce its size without changing its format, which matters when the next step has an attachment ceiling.
Key parameters
- Binary Property: the binary field holding the file to compress.
- Binary Input Data: on means the file comes from that binary field, off means CloudConvert uses Input File Contents.
- Additional Options: a JSON dictionary of options added to the converting task, generated with the CloudConvert job builder.
Metadata
2 operationsGet metadata from a file
metadata.metadataWhat you see in n8n
Notes & use cases
Reads the metadata CloudConvert can extract from a file and returns it as JSON, so the next node can branch on it.
Key parameters
- Input File Name: the filename including extension.
- Binary Property: the binary field containing the file to inspect.
- Binary Input Data: leave it on when the file arrives from a previous node rather than as text.
Write metadata to a file
metadata.metadata/writeWhat you see in n8n
Notes & use cases
Writes metadata into the file and returns the updated copy, the mirror image of reading it.
Key parameters
- Metadata: a JSON dictionary of keys and values to write, for example Title, Author, Creator or Producer.
- Input File Contents: the text content when the file is uploaded directly.
- Binary Property: the field holding the file to rewrite.
Add OCR layer to PDF
pdf.pdf/ocrWhat you see in n8n
Notes & use cases
Adds a text layer over a scanned PDF, which turns a picture of a page into something you can search and copy from.
Key parameters
- Languages: a comma separated list of language codes, for example
eng,deu. - Auto Orient: detects and corrects page orientation before the OCR pass.
- Binary Property: the binary field holding the scanned PDF.
Convert PDF to PDF/A
pdf.pdf/aWhat you see in n8n
Notes & use cases
Rewrites a PDF into the archival PDF/A family, the format record keeping rules usually ask for.
Key parameters
- Conformance Level: PDF/A-1B, PDF/A-2B or PDF/A-3B.
- Binary Property: the field carrying the PDF to convert.
- Binary Input Data: on when the PDF comes from the previous node as binary data.
Decrypt PDF
pdf.pdf/decryptWhat you see in n8n
Notes & use cases
Removes the protection from a password protected PDF and returns a readable copy for the rest of the workflow.
Key parameters
- Password: the password of the encrypted file, usually pulled from a credential store rather than typed in the node.
- Input File Contents: the text content when the file is uploaded as text.
- Binary Property: the binary field holding the locked PDF.
Encrypt PDF
pdf.pdf/encryptWhat you see in n8n
Notes & use cases
Locks a PDF and, on top of the password, decides what a reader is allowed to do with it.
Key parameters
- Set Password: the password required to open the file.
- Set Owner Password: the owner password for permissions; with it, every protection can be removed again.
- Allow Print and Allow Modify: the permitted levels, for example
fullandform. - Allow Extract and Allow Accessibility: copying content, and screen reader support.
Extract pages from PDF
pdf.pdf/extract-pagesWhat you see in n8n
Notes & use cases
Pulls selected pages out of a PDF and returns them as a new file, leaving the source document alone.
Key parameters
- Pages: single pages or ranges, for example
1,2,5-7; numbering starts at 1. - Binary Property: the field holding the PDF to cut.
- Binary Input Data: on when the PDF is the binary output of an earlier node.
Merge files to PDF
pdf.pdf/mergeWhat you see in n8n
Notes & use cases
Combines several files into a single PDF, in the order the items reach the node. No parameter is required on this one, which makes it the simplest operation of the node and the easiest to slot at the end of a branch that has collected files from different places.
Rotate PDF pages
pdf.pdf/rotate-pagesWhat you see in n8n
Notes & use cases
Turns single pages or every page of a PDF, which fixes documents that were fed into the scanner the wrong way round.
Key parameters
- Rotation: the angle to apply, for example
+90,-90or180. - Pages: the pages or ranges to rotate, such as
1,2,5-7, with numbering starting at 1. - Binary Property: the binary field holding the file.
Split PDF into pages
pdf.pdf/split-pagesWhat you see in n8n
Notes & use cases
Breaks a PDF into one file per page, so a batch document becomes a list of items the workflow can loop over.
Key parameters
- Binary Property: the field holding the PDF to split.
- Binary Input Data: on to take the document from that binary field.
- Input File Contents: the text content, for the upload path instead.
Website
1 operationCapture website
website.capture-websiteWhat you see in n8n
Notes & use cases
Renders a live web page and returns it as a PDF, a JPG or a PNG screenshot. This is the only operation that starts from a URL rather than a file.
Key parameters
- URL: the address of the page to capture.
- Output Format: PDF for a document, JPG or PNG for a screenshot.
- Additional Options: a JSON dictionary of extra options for the task, built with the CloudConvert job builder.
Need help automating CloudConvert with n8n?
A person reads every message.

