keepcalculator

06 Numbers and Powers

Integrate OnlyOffice in WordPress: Full Guide

Card No. 06·72766 · Updated · Standard formula, shown below

Yes, you can integrate OnlyOffice in WordPress by installing the official OnlyOffice Document Server plugin and connecting it to your own OnlyOffice Document Server (or a commercial cloud version). This lets you create, edit, and collaborate on documents, spreadsheets, and presentations directly inside your WordPress admin, without leaving your browser. Below we explain the two main integration paths, how to set them up, what to watch out for, and how to choose what fits your site.

What OnlyOffice Integration Actually Means

OnlyOffice is a self-hosted office suite that includes editors for text documents, spreadsheets, and presentations. Its WordPress plugin is not a standalone editor; it is a bridge. The plugin adds a new “OnlyOffice” menu in your WordPress dashboard where you can create files, upload existing ones, and open them in a full editor. The actual editing happens on a separate OnlyOffice Document Server, which can run on your own machine (via Docker or a VPS) or be provided by a commercial host. The plugin handles the connection, file storage, and user permissions.

Two Ways to Integrate: Self-Hosted vs. Cloud

You have two basic options:

  • Self-hosted Document Server – You install OnlyOffice Document Server on your own server (using Docker is the most common method). This gives you full control and no per-user fees, but you must manage updates, backups, and security yourself. It requires a server with at least 2 GB of RAM and a domain with a valid SSL certificate.
  • Commercial cloud (OnlyOffice Cloud) – OnlyOffice offers a paid cloud service where they host the document server for you. You get a connection key and simply enter it in the WordPress plugin. This is easier to maintain, but you pay a monthly fee per user.

Both paths use the same WordPress plugin, so the integration steps are nearly identical after you have the Document Server URL or cloud key.

Step-by-Step Setup (Self-Hosted)

Here is the typical process for a self-hosted setup. The exact commands may vary with your OS, but the logic is the same.

  1. Install Docker on your server (if not already present).
  2. Run the Document Server container with the official image onlyoffice/documentserver. You must map ports 80 and 443, and set a volume for persistent data.
  3. Set up a subdomain like doc.yourdomain.com and point it to your server. The Document Server must be accessible via a valid HTTPS address – it will not work over plain HTTP or with a self-signed certificate.
  4. Install the WordPress plugin from the WordPress repository (search for “OnlyOffice”). Activate it.
  5. Enter the Document Server URL in the plugin settings. For self-hosted, it is the HTTPS address of your container (e.g., https://doc.yourdomain.com). For cloud, you enter the provided connection string.
  6. Save and test – create a new document from the OnlyOffice menu. If the editor opens, the integration works.

That is the core. Many users also configure the plugin to allow front-end editing (so visitors can edit files on a public page) or to restrict access by user role.

Choosing Between Self-Hosted and Cloud

Your choice depends on your technical comfort and budget.

  • Self-hosted is best if you already have a VPS or dedicated server, you are comfortable with Docker and Linux, and you want to avoid recurring costs. You must handle SSL certificates (Let’s Encrypt is free), firewall rules, and regular updates.
  • Cloud is best if you want zero maintenance and a predictable monthly fee. It is also a good option if you cannot open extra ports on your server or if your WordPress host blocks Docker.

There is no third-party middle ground – the plugin only works with an OnlyOffice Document Server, either self-hosted or cloud.

Common Problems and How to Fix Them

Users often hit a few recurring issues. Here are the most frequent ones and what to check.

  • Editor does not load – Usually a CORS or HTTPS problem. Make sure your Document Server URL is HTTPS and that the domain matches the certificate. Also, check that your server allows WebSocket connections (the editor uses them for real-time collaboration).
  • File opens read-only – The plugin checks user permissions. If you are logged in as an administrator, you should have edit rights. If not, check the plugin settings for the “Can Edit” role list.
  • Cannot upload files – The plugin stores files in your WordPress media library. If uploads are failing, check your WordPress upload limits and file permissions.
  • Document Server returns an error – Look at the Document Server logs. For Docker, use docker logs <container_name>. Common causes are insufficient memory or a misconfigured JWT secret.

If you use a self-hosted server, also verify that port 443 is open and that your firewall is not blocking the Document Server’s outbound requests to your WordPress site.

Costs and Performance Considerations

Self-hosted OnlyOffice Document Server is free (under the AGPL license for the community edition). You pay for the server hardware and your own maintenance time. A small VPS with 2 GB RAM can handle a handful of concurrent editors, but for a busy site with many users, you will need more resources – typically 4 GB RAM or more.

The cloud version has a per-user monthly fee (pricing is on the OnlyOffice website; it changes, so check current rates). The cloud service includes updates and backups, which can be worth the cost if you do not want to manage a server.

Performance also depends on your WordPress host. The plugin itself is lightweight, but opening a large spreadsheet will consume browser memory. Ensure your users have modern browsers (Chrome, Firefox, Edge, Safari) – the editor does not work on Internet Explorer.

Security and Data Privacy

When you self-host, your documents never leave your server. That is a major privacy advantage. However, you are responsible for securing the server: keep the OS and Docker image updated, use strong passwords, and enable HTTPS. The Document Server supports JWT (JSON Web Token) to authenticate requests – enable it and set a strong secret in both the Document Server config and the WordPress plugin settings.

With the cloud version, your documents are stored on OnlyOffice’s servers. If your organization has strict data-residency requirements, self-hosting is the safer choice. In either case, the WordPress plugin does not store document content in the WordPress database; it only stores file metadata and the connection settings.

Frequently Asked Questions

Does the plugin work with any WordPress theme?

Yes, the plugin is theme-independent. It adds its own admin pages and uses its own editor interface. However, if you want to embed the editor on a public page (front-end), you may need to adjust your theme’s CSS to give the editor enough height.

Can I use OnlyOffice with WordPress multisite?

Yes, the plugin supports multisite. You need to activate it network-wide and then configure the Document Server URL for each sub-site, or use the network settings if you want a single shared server.

Is there a free cloud option?

OnlyOffice offers a free trial for the cloud, but it is not free indefinitely. The self-hosted community edition is free, but you must run it on your own hardware.

Can my visitors edit documents without logging in?

By default, editing requires a WordPress user account. You can enable anonymous editing in the plugin settings, but that allows anyone to edit any file, which is usually not what you want. For public collaboration, consider creating a special user role with limited permissions.

Does the integration work with Google Drive or Dropbox?

No, the WordPress plugin works only with files stored in your WordPress media library. If you want to edit files from cloud storage, you would need to download them first and then upload them to WordPress, or use a third-party plugin that connects OnlyOffice to those services – but that is beyond the official integration.

What happens to my documents if I deactivate the plugin?

Your files remain in the WordPress media library – they are not deleted. You just lose the ability to edit them in OnlyOffice. You can still download the original files via the media library.

Related

Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.

More cards in this drawer

The whole Numbers and Powers drawer →