Get Started
Plugins
Macros
More information

Adding plugins to ONLYOFFICE Desktop Editors

There are two ways to add plugins: through the plugin manager and through the plugin folder.

Starting from version 7.4, you can download ready-to-use plugins from ONLYOFFICE Plugin Marketplace.

Follow the steps below to add the plugins to the editor using plugin manager:

  1. Open the Plugins tab.
  2. Click Plugin Manager.
  3. Find the plugin you need and click Install.
Plugins manager

The plugin will be added to the opened editors and all the editors you will open afterwords and displayed within the Plugins tab.

Step 1. Create a new folder in the sdkjs-plugins directory. The path to the folder depends on the operating system you use:

  • For Linux - /opt/onlyoffice/desktopeditors/editors/sdkjs-plugins/
  • For Windows - %ProgramFiles%\ONLYOFFICE\DesktopEditors\sdkjs-plugins\
  • For Mac OS - /Applications/ONLYOFFICE.app/Contents/Resources/editors/sdkjs-plugins/

Step 2. Use a plugin GUID as the folder name. You can find the plugin GUID in the config.json file.

For example, for the Extended comments plugin the guid parameter will look the following way:

{
    "name" : "Extended comments",
    "guid" : "asc.{91EAC419-EF8B-440C-A960-B451C7DF3A37}",
    ...
}

So, the folder name of this plugin will be {91EAC419-EF8B-440C-A960-B451C7DF3A37}.

Step 3. Put all the plugin files to this folder:

Plugin folder

Step 4. Start ONLYOFFICE Desktop Editors. If everything is done correctly, the plugin will be displayed within the Plugins tab:

Extended comments

To uninstall the newly added plugins, proceed in the following way:

  1. Open the Plugins tab.
  2. Go to the plugin Settings.
  3. Click the Remove plugin button Remove button near the corresponding plugin.
This option is not available for the default plugins and the plugins added via the plugin folder.

If you need to uninstall the default plugins, go to the sdkjs-plugins folder and remove the corresponding plugin folder from this directory.

Please note that removing the default plugins from ONLYOFFICE Desktop Editors on Mac OS breaks the package integrity and may cause the application crash. Be careful and don't do this unless absolutely necessary.

The table below contains default plugins guids to make it easier for you to find them:

Default plugins guid’s

Highlight code {BE5CBF95-C0AD-4842-B157-AC40FEDD9841}
Mendeley {BE5CBF95-C0AD-4842-B157-AC40FEDD9441}
OCR {440EBF13-9B19-4BD8-8621-05200E58140B}
Photo editor {07FD8DFA-DFE0-4089-AL24-0730933CC80A}
Speech {D71C2EF0-F15B-47C7-80E9-86D671F9C595}
Thesaurus {BE5CBF95-C0AD-4842-B157-AC40FEDD9840}
Translator {7327FC95-16DA-41D9-9AF2-0E7F449F6800}
YouTube {38E022EA-AD92-45FC-B22B-49DF39746DB4}
Zotero {BFC5D5C6-89DE-4168-9565-ABD8D1E48711}
Send {B509123E-6335-40BD-B965-91EB799346E3}
Please note that after app updating the default plugins will appear again and you will need to uninstall them.