ONLYOFFICE Docs n8n Nodes

This is an n8n community node that lets you use ONLYOFFICE Document Server in your n8n workflows.

ONLYOFFICE Document Server is a powerful document processing and conversion platform that allows you to work with office documents in various formats. The node integrates with both the conversion API and the web DocBuilder service.

n8n is a fair-code licensed workflow automation platform.

Prerequisites

• ONLYOFFICE Docs v10.0 or later is required.

Installation

Follow the installation guide in the n8n community nodes documentation.

Community nodes (recommended)

1. Go to Settings > Community Nodes in your n8n instance
2. Select Install
3. Enter @onlyoffice/n8n-nodes-docs in Enter npm package name
4. Agree to the risks of using community nodes
5. Select Install

After installing the node, you can use it like any other node. n8n displays the node in search results in the Nodes panel.

Manual installation

To get started install the package in your n8n root directory:

npm install @onlyoffice/n8n-nodes-docs

For Docker-based deployments add the following line before the font installation command in your n8n Dockerfile:

RUN cd /usr/local/lib/node_modules/n8n && npm install @onlyoffice/n8n-nodes-docs

Nodes

This package provides the following nodes:

• ONLYOFFICE Docs: Interact with ONLYOFFICE Document Server API

Operations

The ONLYOFFICE Docs node supports the following resources and operations:

Conversion

• Convert a document
• Convert to PDF
• Convert spreadsheet to PDF
• Generate thumbnail
• Remove password
• Add watermark

Document Builder

Extract from existing documents:

• Extract Text
• Extract Outline
• Extract Tables
• Extract Chunks
• Extract Metadata

Generate new documents:

• Create Document
• JSON to Table
• Generate Spreadsheet
• Generate Presentation
• Markdown to Document

Modify existing documents:

• Fill Template
• Mail Merge
• Append Content to Document
• Append Rows to Spreadsheet
• Update Row in Spreadsheet

Supported formats

The node supports conversion between 50+ formats including:

• Documents: DOCX, DOC, ODT, RTF, TXT, PDF, HTML, EPUB
• Spreadsheets: XLSX, XLS, ODS, CSV, PDF
• Presentations: PPTX, PPT, ODP, PDF
• Images: PNG, JPG, JPEG, SVG, BMP

Credentials

This node supports JWT-based authentication:

| Field | Description | |---------------------------|-----------------------------------------------------------------------| | Document Server URL | Base URL of your Document Server (e.g. https://docs.example.com) | | JWT Secret | The secret key configured on your Document Server | | JWT Header | HTTP header for JWT token (default: Authorization) |

Operation Details

Document Builder

Document Builder operations use the ONLYOFFICE Docs /docbuilder web service endpoint. All operations return fileName, outputUrl, and binary file data (where applicable) so results can be passed directly between nodes in a workflow.

Extract Text

Extracts all paragraphs and tables from a DOCX as structured JSON. Returns paragraphs[] and tables[] arrays.

Extract Outline

Extracts the document heading structure. Returns one item per heading with level (1–6) and text fields.

Extract Tables

Extracts all tables from a document as JSON. Each item has tableIndex, headers[], rows[][], and records[]. Use {{ $json.records }} as input for Generate Spreadsheet, Append Rows, or JSON to Table.

Extract Chunks

Splits a document into text chunks for vectorization or AI embedding pipelines. The Chunk By option controls granularity: by paragraphs or by headings sections. Each output item has text and metadata.

Extract Metadata

Returns document statistics in a single item: paragraphs, headings, tables, estimatedWords, characters.

Create Document

Creates a new DOCX or PDF from plain text. Each line of the Text field becomes a separate paragraph. Optionally set a document title.

JSON to Table

Creates a DOCX or PDF with a formatted table from a JSON array. Object keys become column headers. Supports an optional table title.

Generate Spreadsheet

Creates an XLSX spreadsheet from a JSON array of row objects. Object keys become column headers in row 1.

Generate Presentation

Creates a PPTX presentation from a JSON array of slide objects. Each slide supports title, body, background, font colors, sizes, and alignment.

Markdown to Document

Converts Markdown to a formatted DOCX or PDF. Supports headings (H1–H6), bold, italic, inline code, bullet lists, numbered lists, and fenced code blocks.

Fill Template

Opens a document and replaces {{key}} placeholders with values from the Template Data JSON object. Preserves the original document formatting.

Mail Merge

Runs Fill Template for each record in a JSON array. Returns one output item per generated document, each with fileName, outputUrl, and binary data.

Append Content to Document

Adds paragraphs to the end of an existing document. Each array item can be a plain string or an object with text and bold fields.

Append Rows to Spreadsheet

Adds rows to an existing XLSX file. Object keys in the JSON array must match existing column headers exactly.

Update Row in Spreadsheet

Finds all rows where a given column equals a search value, then updates specified cell values. Column names must match headers exactly.

Convert Document

Converts files between different formats with comprehensive format support.

Parameters:

• File URL — URL of the source file
• Input Format — format of the source file
• Output Format — desired output format
• Output File Name — name for the converted file

Convert to PDF

Quick conversion to PDF format for supported document types.

Convert Spreadsheet to PDF

Advanced spreadsheet conversion with layout options:

• Page orientation (portrait/landscape)
• Custom margins and page size
• Scale and zoom settings
• Grid lines and headings display
• Print area handling

Generate Thumbnail

Create thumbnail images from documents:

• Multiple output formats (PNG, JPG)
• Custom dimensions
• Aspect ratio handling
• Single page or multi-page output

Remove Password

Remove password protection from password-protected documents.

Add Watermark

Convert to PDF with customizable text watermarks:

• Custom text content
• Font styling (size, color, bold)
• Positioning (diagonal/horizontal)
• Transparency control

License

The ONLYOFFICE Docs n8n Nodes are distributed under the MIT license. See LICENSE for more information.

Versions

See CHANGELOG.md for version history and release notes.

Useful links & support

| Resource | URL | |-------------------------------|------------------------------------------------------------------------| | ONLYOFFICE website | onlyoffice.com | | ONLYOFFICE Document Server | onlyoffice.com/docs | | n8n community nodes documentation | docs.n8n.io | | API documentation | api.onlyoffice.com | | Community forum | community.onlyoffice.com | | Help Center | helpcenter.onlyoffice.com | | Found a bug? | Report an issue | | Support email | [email protected] |