Integration Guides - Volto

About the ONLYOFFICE and Volto integration

Volto is the React-based frontend for Plone. If your Plone installation uses Volto, a separate ONLYOFFICE connector is available for it. You can download it from the npm Registry or the ONLYOFFICE GitHub page.

Main features

Creating, editing, viewing, and reviewing text documents, spreadsheets, and presentations.
Editing PDFs and filling out PDF forms.
Converting office files to different formats.
JWT support to secure document traffic.

Supported formats

For editing: DOCX, XLSX, PPTX
For viewing: DOCX, XLSX, PPTX, PDF, and other office formats
For PDF editing and form filling: PDF
For converting: office formats to OOXML and other supported output formats

Connecting ONLYOFFICE Docs to Volto

Requirements

ONLYOFFICE Docs (server or cloud version). You need an instance of ONLYOFFICE Docs that is resolvable and connectable both from Volto and any end clients.
Plone with Volto frontend enabled.
ONLYOFFICE connector for Volto v1.0.0 or later.

Installing the ONLYOFFICE connector for Volto

Install the package from npm:

npm install @onlyoffice/volto

For detailed installation and configuration instructions, refer to the official GitHub page.

Configuring the ONLYOFFICE connector for Volto

To configure the connector:

Click the Profile icon in the lower-left corner.
Go to Site Setup → Add-on Configuration → ONLYOFFICE Configuration.
Enter the URL address of your ONLYOFFICE Docs instance.
If required, specify the URL addresses for internal requests.
Enter the Secret key for JWT. For details on finding and setting the secret key, see the Enabling JWT section of this article — the same steps apply.
Click Save.

You can also connect to the demo ONLYOFFICE Docs server directly from the configuration page to try the integration without setting up your own instance.

Important The demo server is public and available for 30 days only. Do not share sensitive or confidential data there.

Start using ONLYOFFICE Docs within Volto

To create a new file:

Go to the Contents section.
Click the ONLYOFFICE icon on the left-side panel.
Choose the file type: Document, Spreadsheet, Presentation, or PDF Form.
The new file will open immediately for editing.

To open an existing file:

Go to the Contents section and click the file.
Click the ONLYOFFICE icon on the left-side panel.
Choose the desired action:
- View with ONLYOFFICE — opens the file in read-only mode. You can navigate through the document, download it to your device, or print it.
- Edit with ONLYOFFICE — opens the file for full editing. Available for DOCX, XLSX, and PPTX files. You can use the full range of formatting and styling tools, as well as plugins for online translation, grammar correction, image editing, diagram creation, and more.
- Review with ONLYOFFICE — available for documents. Opens the file with Track Changes mode enabled, allowing you to suggest edits without permanently altering the original text.

To work with a PDF file:

Go to the Contents section and click the PDF file.
Click the ONLYOFFICE icon on the left-side panel.
Choose the desired action:
- View with ONLYOFFICE — opens the PDF in read-only mode.
- Edit with ONLYOFFICE — opens the PDF for editing. Available tools include text editing, redaction, page management, object insertion, annotation, and AI-powered OCR.
- Fill in form — opens a PDF form for filling. Available field types include text fields, dropdown lists, radio buttons, checkboxes, combo boxes, images, and email addresses.

To learn more about forms, please read the corresponding articles on creating and filling out forms.

To convert a file:

Go to the Contents section and click the file.
Click the Convert with ONLYOFFICE icon (arrow icon) on the left-side panel.
In the pop-up window, select the desired output format from the drop-down list.
Click the arrow button to start the conversion. The converted file will be downloaded to your device.