Docs

DocSpace

Desktop Apps

Mobile Apps

Connectors

Workspace

Docs API

Document builder

Office API

Plugins and macros

<div class="raw-html-embed"><div>In this section, you will find the instructions how to integrate ONLYOFFICE Docs with your application and extend its functionality using your own plugins/macros, find the information on how to use Office JavaScript API to write code for your plugins, macros, builder scripts, etc.</div></div>

Development

Testing

Writing documentation

Reporting issues

Translating

<div class="raw-html-embed"><div>If you want to help translate the ONLYOFFICE Docs interface, become a beta-tester, have some tips and tricks to work with ONLYOFFICE Docs more efficiently, or want to report a bug, please read the following guides.</div></div>

Contribution

<div class="raw-html-embed"><div>ONLYOFFICE Docs is an all-in-one office suite that offers editors for text  documents, spreadsheets, presentations, digital forms and PDFs. Learn more about available features by choosing one of the corresponding sections below.</div></div>

Plugins

Document Editor

Form Creator

Spreadsheet Editor

Presentation Editor

PDF Editor

Diagram Viewer

Accessibility features

User guides

Roadmap

Changelog

<div class="raw-html-embed"><p><b>ONLYOFFICE Docs</b> interface is available in <b>45</b> languages. The list is changing as new translators wish to have <b>ONLYOFFICE Docs</b> in their own language and help us participating in translation. Below is the table of all the languages currently available for <b>ONLYOFFICE Docs</b>:</p>
       
<table class="table_versionlist talk_pages languages_list_table" id="languagesEditorsTable">
    <thead>
                <tr>
                    <th><span>Language</span></th>
                    <th><span>Locale</span></th>
                    <th><span>Completion Rate<sup>1</sup></span></th>
                </tr>
            </thead>
            <tbody>
                <tr><td>Albanian - Albania</td><td>sq-AL</td><td>97%</td></tr>
                <tr><td>Arabic - Saudi Arabia</td><td>ar-SA</td><td>98%</td></tr>
                <tr><td>Armenian</td><td>hy-AM</td><td>95%</td></tr>
                <tr><td>Azeri - Latin</td><td>Lt-az-AZ</td><td>47%</td></tr>
                <tr><td>Basque</td><td>eu-ES</td><td>63%</td></tr>
                <tr><td>Belarusian</td><td>be-BY</td><td>37%</td></tr>
                <tr><td>Bulgarian</td><td>bg-BG</td><td>15%</td></tr>
                <tr><td>Catalan</td><td>ca-ES</td><td>65%</td></tr>
                <tr><td>Chinese - Simplified</td><td>zh-CN</td><td>98%</td></tr>
                <tr><td>Chinese - Traditional</td><td>zh-TW</td><td>56%</td></tr>
                <tr><td>Czech</td><td>cs-CZ</td><td>87%</td></tr>
                <tr><td>Danish</td><td>da-DK</td><td>28%</td></tr>
                <tr><td>Dutch</td><td>nl-NL</td><td>50%</td></tr>
                <tr><td>English</td><td>en-US</td><td>100%</td></tr>
                <tr><td>English - United Kingdom</td><td>en-UK</td><td>100%</td></tr>
                <tr><td>Finnish</td><td>fi-FI</td><td>35%</td></tr>
                <tr><td>French</td><td>fr-FR</td><td>100%</td></tr>
                <tr><td>Galician</td><td>gl-ES</td><td>51%</td></tr>
                <tr><td>German</td><td>de-DE</td><td>100%</td></tr>
                <tr><td>Greek</td><td>el-GR</td><td>99%</td></tr>
                <tr><td>Hebrew</td><td>he-IL</td><td>98%</td></tr>
                <tr><td>Hungarian</td><td>hu-HU</td><td>63%</td></tr>
                <tr><td>Indonesian</td><td>id-ID</td><td>76%</td></tr>
                <tr><td>Italian</td><td>it-IT</td><td>98%</td></tr>
                <tr><td>Japanese</td><td>ja-JP</td><td>85%</td></tr>
                <tr><td>Korean</td><td>ko-KR</td><td>63%</td></tr>
                <tr><td>Laotian</td><td>lo-LA</td><td>44%</td></tr>
                <tr><td>Latvian</td><td>lv-LV</td><td>56%</td></tr>
                <tr><td>Malay</td><td>ms-MY</td><td>47%</td></tr>
                <tr><td>Norwegian - Bokmål</td><td>nb-NO</td><td>4%</td></tr>
                <tr><td>Polish</td><td>pl-PL</td><td>34%</td></tr>
                <tr><td>Portuguese</td><td>pt-PT</td><td>68%</td></tr>
                <tr><td>Portuguese - Brazilian</td><td>pt-BR</td><td>100%</td></tr>
                <tr><td>Romanian</td><td>ro-RO</td><td>100%</td></tr>
                <tr><td>Russian</td><td>ru-RU</td><td>100%</td></tr>
                <tr><td>Serbian - Cyrillic</td><td>Cy-sr-SP</td><td>97%</td></tr>
                <tr><td>Serbian - Latin</td><td>Lt-sr-SP</td><td>98%</td></tr>
                <tr><td>Sinhala</td><td>si-LK</td><td>81%</td></tr>
                <tr><td>Slovak</td><td>sk-SK</td><td>45%</td></tr>
                <tr><td>Slovenian</td><td>sl-SI</td><td>22%</td></tr>
                <tr><td>Spanish</td><td>es-ES</td><td>100%</td></tr>
                <tr><td>Swedish</td><td>sv-SE</td><td>29%</td></tr>
                <tr><td>Turkish</td><td>tr-TR</td><td>58%</td></tr>
                <tr><td>Ukrainian</td><td>uk-UA</td><td>30%</td></tr>
                <tr><td>Urdu</td><td>ur-PK</td><td>100%</td></tr>
                <tr><td>Vietnamese</td><td>vi-VN</td><td>9%</td></tr>
            </tbody>
        </table>
<p class="last_update">Updated: <b>May 26, 2025</b></p>
<h4 id="Legend">Legend</h4>
<p style="clear: both;"><b><sup>1</sup> Completion rate</b> given in percent shows the translation performance into one of the available languages. 100% means that everything at your <b>ONLYOFFICE Docs</b> is already translated. 50% means that the half of the <b>ONLYOFFICE Docs</b> interface is still available in English. The completion rate values were rounded up.</p>
<h4 id="Participate">If you want to take part in translation</h4>
<p>If you are a translator or simply want to have <b>ONLYOFFICE Docs</b> in your language, you can also participate in translation. See <a href="/guides/become-translator.aspx">this guide</a> on how to become an ONLYOFFICE translator or write to us at <a href="mailto:documentation@onlyoffice.com">documentation@onlyoffice.com</a>.</p>
<h4 id="TranslationReady">I finished the translation, what's next?</h4>
<p>The ways to add your language to <b>ONLYOFFICE Docs</b> when it is ready is described in the articles: <a href="/docs/installation/docs-community-add-language-docker.aspx">for Docker installation</a> and <a href="/docs/installation/docs-community-add-language-linux.aspx">for Linux installation</a>.</p>
<p>If you are interested in more information about the detailed statistics on languages and translations, it is available at <a href="/workspace/administration/available-languages.aspx">this page</a>.</p></div>

Languages

<div class="raw-html-embed"><div>ONLYOFFICE offers <a href="https://www.onlyoffice.com/office-suite.aspx">various Docs solutions</a> attuned to your needs. Learn more about installation, update process, deinstallation, or troubleshooting by choosing your edition below.</div></div>

Community

Cloud

Developer

Enterprise

Installation

<div class="raw-html-embed"><div>Learn how to configure ONLYOFFICE Docs after installation: set up JWT authorization, manage IP filters, connect external databases, add fonts and custom dictionaries, configure the AI plugin, and secure your instance using the <a href="/docs/configuration/docs-security-checklist.aspx">Docs Security checklist</a>.</div></div>

Docs Security checklist

Configuration

<div class="raw-html-embed">
    <p>ONLYOFFICE Docs is an online office suite that lets you create, edit, and collaborate on text documents, spreadsheets, presentations, PDFs, and forms directly in your browser.</p>

    <div class="gs_content" id="whatsincluded_block">
        <h4>What's included</h4>
        <p>ONLYOFFICE Docs includes the following editors:</p>
        <ul>
            <li><a href="https://www.onlyoffice.com/document-editor.aspx?utm_source=help&utm_medium=article&utm_campaign=docs" target="_blank">Document Editor</a> — create and edit <code>.docx</code>, <code>.odt</code>, and other text formats</li>
            <li><a href="https://www.onlyoffice.com/spreadsheet-editor.aspx?utm_source=help&utm_medium=article&utm_campaign=docs" target="_blank">Spreadsheet Editor</a> — work with <code>.xlsx</code>, <code>.ods</code>, and other spreadsheet formats</li>
            <li><a href="https://www.onlyoffice.com/presentation-editor.aspx?utm_source=help&utm_medium=article&utm_campaign=docs" target="_blank">Presentation Editor</a> — build and present <code>.pptx</code>, <code>.odp</code>, and other slide formats</li>
            <li><a href="https://www.onlyoffice.com/pdf-editor.aspx?utm_source=help&utm_medium=article&utm_campaign=docs" target="_blank">PDF Editor</a> — view, annotate, and edit PDF files</li>
            <li><a href="https://www.onlyoffice.com/form-creator.aspx?utm_source=help&utm_medium=article&utm_campaign=docs" target="_blank">Form Creator</a> — create and fill in digital forms</li>
            <li><a href="https://www.onlyoffice.com/diagram-viewer.aspx?utm_source=help&utm_medium=article&utm_campaign=docs" target="_blank">Diagram Viewer</a> — view <code>.vsdx</code> and other diagram formats</li>
        </ul>
    </div>

    <div class="gs_content" id="wheretostart_block">
        <h4>Where to start</h4>
        <ul>
            <li>
                <b>I'm setting up ONLYOFFICE Docs for my organization</b>
                <p>See the <a href="#installation_block">installation table</a> below to find the right guide for your edition and environment. Once installed, the <a href="#whattoconfigurenext_block">configuration links</a> further down point you to common setup tasks.</p>
            </li>
            <li>
                <b>I want to edit and collaborate</b>
                <p>Head to the <a href="../docs/userguides" target="_blank">User guides</a> to learn about each editor's features, collaboration tools, plugins, and accessibility options.</p>
            </li>
            <li>
                <b>I'm building an integration or extending functionality</b>
                <p>Find API references, Document Builder docs, Office API, and plugin and macro guides in the <a href="../docs/development" target="_blank">Development</a> section.</p>
            </li>
        </ul>
    </div>

    <div class="gs_content" id="installation_block">
        <h4>Installation</h4>
        <p>Choose your edition and environment:</p>
        <table>
            <thead>
                <tr>
                    <th>Edition</th>
                    <th>Docker</th>
                    <th>Linux</th>
                    <th>Windows</th>
                    <th>Other</th>
                </tr>
            </thead>
            <tbody>
                <tr>
                    <td>Enterprise</td>
                    <td><a href="../docs/installation/enterprise/docker" target="_blank">Docker</a></td>
                    <td><a href="../docs/installation/enterprise/linux" target="_blank">Linux</a></td>
                    <td><a href="../docs/installation/enterprise/windows" target="_blank">Windows</a></td>
                    <td>
                        <a href="../docs/installation/enterprise/cloudron" target="_blank">Cloudron</a>,
                        <a href="../docs/installation/enterprise/cluster" target="_blank">Cluster</a>,
                        <a href="../docs/installation/enterprise/univention" target="_blank">Univention</a>,
                        <a href="../docs/installation/enterprise/hosted-solutions" target="_blank">Hosted solutions</a>
                    </td>
                </tr>
                <tr>
                    <td>Developer</td>
                    <td><a href="../docs/installation/developer/docker" target="_blank">Docker</a></td>
                    <td><a href="../docs/installation/developer/linux" target="_blank">Linux</a></td>
                    <td><a href="../docs/installation/developer/windows" target="_blank">Windows</a></td>
                    <td>
                        <a href="../docs/installation/developer/cluster" target="_blank">Cluster</a>,
                        <a href="../docs/installation/developer/hosted-solutions" target="_blank">Hosted solutions</a>
                    </td>
                </tr>
                <tr>
                    <td>Community</td>
                    <td><a href="../docs/installation/community/docker" target="_blank">Docker</a></td>
                    <td><a href="../docs/installation/community/linux" target="_blank">Linux</a></td>
                    <td><a href="../docs/installation/community/windows" target="_blank">Windows</a></td>
                    <td>
                        <a href="../docs/installation/community/cloudron" target="_blank">Cloudron</a>,
                        <a href="../docs/installation/community/hosted-solutions" target="_blank">Hosted solutions</a>
                    </td>
                </tr>
                <tr>
                    <td>Cloud</td>
                    <td>—</td>
                    <td>—</td>
                    <td>—</td>
                    <td><a href="../docs/installation/docs-cloud-registration.aspx" target="_blank">Registration</a></td>
                </tr>
            </tbody>
        </table>
    </div>

    <div class="gs_content" id="whattoconfigurenext_block">
        <h4>What to configure next</h4>
        <p>There is no required order — pick what is relevant to your setup:</p>
        <ul>
            <li><b>Set up collaboration</b> — configure <a href="../docs/userguides/document_editor/CollaborativeEditing.aspx" target="_blank">co-editing modes</a> (Fast for real-time changes, Strict for save-on-demand), sharing permissions, and real-time communication → <a href="../docs/userguides/document_editor#collaboration_block" target="_blank">Collaboration</a></li>
            <li><b>Connect an AI assistant</b> — set up a local model (LocalAI, LM Studio, Ollama) or an online provider (Anthropic, DeepSeek, Google Gemini, GroqAI, Mistral AI, and others) to get writing assistance directly inside the editors → <a href="../../ai" target="_blank">Artificial intelligence</a></li>
            <li><b>Add plugins</b> — extend editor functionality with ready-made or custom plugins, installable through the Plugin Manager without restarting the editors → <a href="../docs/userguides/plugins/PluginManager.aspx" target="_blank">Plugin Manager</a></li>
            <li><b>Customize the interface</b> — white labeling and branding options → <a href="../docs/installation/enterprise" target="_blank">Installation and configuration</a></li>
            <li><b>Secure your installation</b> — review the security guide → <a href="../docs/configuration/docs-security-checklist.aspx" target="_blank">ONLYOFFICE Docs: Security checklist</a></li>
            <li><b>Check supported formats</b> — see the full list of open and proprietary formats supported by the <a href="../docs/userguides/document_editor/supportedformats.aspx" target="_blank">Document Editor</a>, <a href="../docs/userguides/spreadsheet_editor/supportedformats.aspx" target="_blank">Spreadsheet Editor</a>, <a href="../docs/userguides/presentation_editor/supportedformats.aspx" target="_blank">Presentation Editor</a>, and <a href="../docs/userguides/pdf_editor/supportedformats.aspx" target="_blank">PDF Editor</a></li>
            <li><b>Accessibility</b> — screen reader support, hotkeys, color modes, and other accessibility features → <a href="../docs/userguides/accessibility" target="_blank">Accessibility features</a></li>
        </ul>
    </div>

    <div class="gs_content" id="whatsnewinversion93_block">
        <h4>What's new in version 9.3</h4>
        <ul>
            <li>Enhanced PDF Editor with more signature options</li>
            <li>Multipage view for documents</li>
            <li>Solver added to the Spreadsheet Editor</li>
            <li>GIF playback in Presentation Editor slideshow mode</li>
            <li>AI-powered updates across editors</li>
        </ul>
        <p>→ <a href="../docs/docs-changelog.aspx" target="_blank">Full changelog</a></p>
    </div>

</div>
</div>

Getting started

<div class="raw-html-embed">
<table class="helptable">
    <tbody>
        <tr class="headerlite">
            <td><b>Key</b></td>
            <td><b>Message</b></td>
            <td><b>Description</b></td>
        </tr>
        <tr>
            <td><code>Common.Translation.tipFileLocked</code></td>
            <td>Document is locked for editing. You can make changes and save it as local copy later.</td>
            <td>The document is currently locked by another user. The current user can still edit locally and save a copy.</td>
        </tr>
        <tr>
            <td><code>Common.UI.SynchronizeTip.textSynchronize</code></td>
            <td>The document has been changed by another user. Please click to save your changes and reload the updates.</td>
            <td>A conflict has been detected between local and remote changes. User action is required to sync.</td>
        </tr>
        <tr>
            <td><code>DE.Controllers.Main.errorDefaultMessage</code></td>
            <td>Error code: %1</td>
            <td>Generic error fallback. <code>%1</code> is replaced with the specific error code at runtime. See the error code reference for details.</td>
        </tr>
        <tr>
            <td><code>DE.Controllers.Main.errorEditingDownloadas</code></td>
            <td>An error occurred during the work with the document. Use the 'Download as' option to save the file backup copy to a drive.</td>
            <td>An unrecoverable editing session error. The user should use <b>Download as</b> to recover the file.</td>
        </tr>
        <tr>
            <td><code>DE.Controllers.Main.errorEditingSaveas</code></td>
            <td>An error occurred during the work with the document. Use the 'Save as...' option to save the file backup copy to a drive.</td>
            <td>An unrecoverable editing session error. The user should use <b>Save as</b> to recover the file.</td>
        </tr>
        <tr>
            <td><code>DE.Controllers.Main.errorServerVersion</code></td>
            <td>The editor version has been updated. The page will be reloaded to apply the changes.</td>
            <td>Server-side version change detected. The page reloads automatically — no user action required.</td>
        </tr>
        <tr>
            <td><code>DE.Controllers.Main.errorTokenExpire</code></td>
            <td>The document security token has expired. Please contact your Document Server administrator.</td>
            <td>The JWT token has expired. Check the token expiry configuration in <code>local.json</code> or regenerate the token.</td>
        </tr>
        <tr>
            <td><code>DE.Controllers.Main.errorUpdateVersion</code></td>
            <td>The file version has been changed. The page will be reloaded.</td>
            <td>A newer version of the file is available. The page reloads automatically — no user action required.</td>
        </tr>
        <tr>
            <td><code>DE.Controllers.Main.errorUserDrop</code></td>
            <td>The file cannot be accessed right now.</td>
            <td>The user's editing session was dropped, typically due to a network interruption or server-side timeout.</td>
        </tr>
        <tr>
            <td><code>DE.Controllers.Main.saveErrorText</code></td>
            <td>An error has occurred while saving the file.</td>
            <td>Save operation failed. Check the DocService logs and verify that the callback URL is reachable from the server.</td>
        </tr>
        <tr>
            <td><code>DE.Controllers.Main.unknownErrorText</code></td>
            <td>Unknown error.</td>
            <td>An unidentified error occurred. Check the server logs or contact ONLYOFFICE support.</td>
        </tr>
    </tbody>
</table></div>

Troubleshooting

<div class="raw-html-embed">
    <p class="fq_expand"><span>Expand all</span></p>
<p class="fq_collapse"><span>Collapse all</span></p>

<dl class="faq_block" id="docs_1">
    <dt class="faq_expanded_node">Is ONLYOFFICE Docs free?</dt>
    <dd style="display: block;">
        <p>Yes, it is. ONLYOFFICE is a free and open-source office suite distributed under the AGPL 3.0 license. The source code repositories are available on GitHub. Besides, we offer a range of free solutions that you can choose from based on your needs. These include absolutely free desktop editors for Windows/Linux/macOS, free mobile apps for iOS/Android, the free Startup plan of ONLYOFFICE DocSpace Cloud. Free community builds of ONLYOFFICE solutions for self-hosting can be found here.</p>
    </dd>
</dl>

<dl class="faq_block" id="docs_2">
    <dt>How to get started?</dt>
    <dd>
        <p>Create a free DocSpace account. Click <b>Documents</b> in the side menu. To create a document, click the plus sign or use a ready-made template.</p>
    </dd>
</dl>

<dl class="faq_block" id="docs_3">
    <dt>Can I edit text documents without an internet connection?</dt>
    <dd>
        <p>Yes, you can install and use free ONLYOFFICE Desktop Editors to edit local documents offline.</p>
    </dd>
</dl>

<dl class="faq_block" id="docs_4">
    <dt>Is ONLYOFFICE Docs available as a mobile app?</dt>
    <dd>
        <p>Yes, you can install the free Documents app for iOS or Android devices to work on documents on the go.</p>
    </dd>
</dl>

<dl class="faq_block" id="docs_5">
    <dt>Is it possible to use ONLYOFFICE Docs within my app under my brand?</dt>
    <dd>
        <p>Yes, you can integrate the editor into your app. Please use ONLYOFFICE Docs Developer.</p>
    </dd>
</dl>
</div>