Customization

Description

The customization section allows to customize the editor interface so that it looked like your other products (if there are any) and change the presence or absence of the additional buttons, links, change logos and editor owner details.

Example

The example.com is the name of the server where document manager and document storage service are installed. See the How it works section to find out more on Document Server service client-server interactions.

If you have any further questions, please contact us at integration@onlyoffice.com.


Please note that only the following parameters are available for the mobile editors: feedback, goback, help, macrosMode, mobileForceView.
Parameters
Name Description Type Example
Adds a request for the anonymous name:
  • request - defines if the request is sent or not. The default value is true,
    type: boolean,
    example: true;
  • label - a postfix added to the user name. The default value is Guest,
    type: string,
    example: "Guest";
object { "request": true, "label": "Guest" }
Defines if the Autosave menu option is enabled or disabled. If set to false, only Strict co-editing mode can be selected, as Fast does not work without autosave. The default value is true. boolean true
Please note that in case this setting is changed in the editor interface, it will be stored in the browser local storage and will overwrite any values sent as the editorConfig.customization.autosave parameter.
Defines if the Chat menu button is displayed or hidden. Please note that in case you hide the Chat button, the corresponding chat functionality will also be disabled. The default value is true. Deprecated since version 7.1, please use the document.permissions.chat parameter instead. boolean true
Defines if the user can edit and delete only his comments. The default value is false. Deprecated since version 6.3, please use the document.permissions.editCommentAuthorOnly and document.permissions.deleteCommentAuthorOnly fields instead. boolean true
Defines if the Comments menu button is displayed or hidden. Please note that in case you hide the Comments button, the corresponding commenting functionality will be available for viewing only, adding and editing comments will be unavailable. The default value is true. boolean true
Defines if the additional action buttons are displayed in the upper part of the editor window header next to the logo (false) or in the toolbar (true) making the header more compact. The default value is false. boolean false
Defines if the top toolbar type displayed is full (false) or compact (true). The default value is false. boolean false
Please note that in case this setting is changed in the editor interface, it will be stored in the browser local storage and will overwrite any values sent as the editorConfig.customization.compactToolbar parameter.
Defines the use of functionality only compatible with the OOXML format. For example, do not use comments on the entire document. The default value is false. boolean false
Contains the information which will be displayed in the editor About section and visible to all the editor users. The object has the following parameters:
  • address - postal address of the company or person who gives access to the editors or the editor authors,
    type: string,
    example: "My City, 123a-45";
  • info - some additional information about the company or person you want the others to know,
    type: string,
    example: "Some additional information";
  • logo - the path to the image logo (there are no special recommendations for this file, but it would be better if it was in the .png format with transparent background). The image must have the following size: 432x70,
    type: string,
    example: "https://example.com/logo-big.png".
  • logoDark - the path to the image logo for the dark theme (there are no special recommendations for this file, but it would be better if it was in .png format with transparent background). The image must have the following size: 432x70,
    type: string,
    example: "https://example.com/dark-logo-big.png".
  • mail - email address of the company or person who gives access to the editors or the editor authors,
    type: string,
    example: "john@example.com".
  • name - the name of the company or person who gives access to the editors or the editor authors,
    type: string,
    example: "John Smith and Co.";
  • phone - the phone of the company or person who gives access to the editors or the editor authors,
    type: string,
    example: "123456789";
  • www - home website address of the above company or person,
    type: string,
    example: "example.com".
object { "address": "My City, 123a-45", "info": "Some additional information", "logo": "https://example.com/logo-big.png", "logoDark": "https://example.com/dark-logo-big.png", "mail": "john@example.com", "name": "John Smith and Co.", "phone": "123456789", "www": "example.com" }
Defines the parameters that the user can disable or customize if possible:
  • spellcheck - defines if the spell checker is automatically switched on or off when the editor is loaded. If this parameter is a boolean value, then it is set as the initial spell checker value and the spell checker setting will not be hidden. The default value is true,
    type: object or boolean,
    example: true;
  • spellcheck.mode - defines if the spell checker is automatically switched on or off when the editor is loaded. This parameter will only be available for the document editor and the presentation editor,
    type: boolean,
    example: true;
object { "spellcheck": { "mode": true } }
Please note that in case spellcheck setting is changed in the editor interface, it will be stored in the browser local storage and will overwrite any values sent as the editorConfig.customization.features.spellcheck parameter.
Defines settings for the Feedback & Support menu button. Can be either boolean (simply displays or hides the Feedback & Support menu button) or object. In case of object type the following parameters are available:
  • url - the absolute URL to the website address which will be opened when clicking the Feedback & Support menu button,
    type: string,
    example: "https://example.com";
  • visible - shows or hides the Feedback & Support menu button,
    type: boolean,
    example: true.
The default value is false.
boolean or object true
Please note that this parameter is also available for the mobile editors.
Adds the request for the file force saving to the callback handler when saving the document within the document editing service (e.g. clicking the Save button, etc.). The default value is false. boolean false
Please note that in case this setting is changed in the editor interface, it will be stored in the browser local storage and will overwrite any values sent as the editorConfig.customization.forcesave parameter.
Defines settings for the Open file location menu button and upper right corner button. The object has the following parameters:
  • blank - opens the website in the new browser tab/window (if the value is set to true) or the current tab (if the value is set to false) when the Open file location button is clicked. The default value is true,
    type: boolean,
    example: true;
  • requestClose - defines that if the Open file location button is clicked, events.onRequestClose event is called instead of opening a browser tab or window. The default value is false,
    type: boolean,
    example: false;
  • text - the text which will be displayed for the Open file location menu button and upper right corner button (i.e. instead of Go to Documents),
    type: string,
    example: "Open file location";
  • url - the absolute URL to the website address which will be opened when clicking the Open file location menu button,
    type: string,
    example: "https://example.com".
boolean or object true
Please note that this parameter is also available for the mobile editors.
Defines if the Help menu button is displayed or hidden. The default value is true. boolean true
Please note that this parameter is also available for the mobile editors.
Defines if the note panel is displayed or hidden on first loading. The default value is false. This parameter is available for the presentation editor only. boolean false
Please note that in case this setting is changed in the editor interface, it will be stored in the browser local storage and will overwrite any values sent as the editorConfig.customization.hideNotes parameter.
Defines if the right menu is displayed or hidden on first loading. The default value is false. boolean false
Please note that in case this setting is changed in the editor interface, it will be stored in the browser local storage and will overwrite any values sent as the editorConfig.customization.hideRightMenu parameter.
Defines if the editor rulers are displayed or hidden. This parameter is available for the document and presentation editors. The default value is false for the document editor and true for presentations. boolean false
Defines the mode of embedding editors into the web page. The embed value disables scrolling to the editor frame when it is loaded as the focus is not captured. string embed
Changes the image file at the top left corner of the editor header. The recommended image height is 20 pixels. The object has the following parameters:
  • image - path to the image file used to show in the common work mode (i.e. in view and edit modes for all editors) or in the embedded mode (see the config section to find out how to define the embedded document type). The image must have the following size: 172x40,
    type: string,
    example: "https://example.com/logo.png";
  • imageDark - path to the image file used for the dark theme. The image must have the following size: 172x40,
    type: string,
    example: "https://example.com/dark-logo.png";
  • imageEmbedded - path to the image file used to show in the embedded mode (see the config section to find out how to define the embedded document type). The image must have the following size: 248x40. Deprecated since version 7.0, please use the image field instead,
    type: string,
    example: "https://example.com/logo_em.png";
  • url - the absolute URL which will be used when someone clicks the logo image (can be used to go to your web site, etc.). Leave as an empty string or null to make the logo not clickable,
    type: string,
    example: "https://example.com".
object { "image": "https://example.com/logo.png", "imageDark": "https://example.com/dark-logo.png", "url": "https://example.com" }
Defines if document macros will be automatically run when the editor opens. The default value is true. The false value hides the macros settings from the user. boolean true
Defines the macros run mode when autostart is enabled. Can take the following values:
  • disable - don't run macros at all;
  • enable - run all macros automatically;
  • warn - warn about macros and ask permission to run them.
The default value is warn.
string warn
Please note that in case this setting is changed in the editor interface, it will be stored in the browser local storage and will overwrite any values sent as the editorConfig.customization.macrosMode parameter.
Please note that this parameter is also available for the mobile editors.
Defines the hint that describes the event after mentions in a comment. If true, a hint indicates that the user will receive a notification and access to the document. If false, a hint indicates that the user will receive only a notification of the mention. The default value is true. boolean true
Please note that it will only be available for the comments if the onRequestSendNotify event is set.
Defines if the mobile document editor is opened in the view/edit mode on launch. The default value is true. boolean true
Please note that this parameter is only available for the mobile editors.
Defines if plugins will be launched and available. The default value is true. boolean true
Contains the information about the review mode. The object has the following parameters:
  • hideReviewDisplay - defines if the Display mode button is displayed or hidden on the Collaboration tab. The default value is false,
    type: boolean,
    example: false;
  • hoverMode - defines the review display mode: show reviews in tooltips by hovering the changes (true) or in balloons by clicking the changes (false). The default value is false.
    type: boolean,
    example: false;
  • reviewDisplay - defines the review editing mode which will be used when the document is opened for viewing. It will only be available for the document editor if mode is set to view. Can take the following values:
    markup - the document is displayed with proposed changes highlighted;
    simple - the document is displayed with proposed changes highlighted, but the balloons are turned off;
    final - the document is displayed with all the proposed changes applied;
    original - the original document is displayed without the proposed changes.
    The default value is original,
    type: string,
    example: "original";
  • showReviewChanges - defines if the review changes panel is automatically displayed or hidden when the editor is loaded. The default value is false,
    type: boolean,
    example: false;
  • trackChanges - defines if the document is opened in the review editing mode (true) or not (false) regardless of the document.permissions.review parameter (the review mode is changed only for the current user). If the parameter is undefined, the document.permissions.review value is used (for all the document users),
    type: boolean,
    example: true.
object { "hideReviewDisplay": false, "showReviewChanges": false, "reviewDisplay": "original", "trackChanges": true, "hoverMode": false }
The showReviewChanges, reviewDisplay, trackChanges parameters are deprecated since version 7.0. Please use the review parameter instead.
Please note that in case this setting is changed in the editor interface, it will be stored in the browser local storage and will overwrite any values sent as the editorConfig.customization.review.hoverMode and the editorConfig.customization.review.reviewDisplay parameters.
Defines the review editing mode in the document editor. This parameter can take the following values:
  • markup - the document is displayed with proposed changes highlighted;
  • simple - the document is displayed with proposed changes highlighted, but the balloons are turned off;
  • final - the document is displayed with all the proposed changes applied;
  • original - the original document is displayed without the proposed changes.
The default value is original for viewer and markup for editor.
string original
Deprecated since version 7.0. Please use the review.reviewDisplay parameter instead.
Please note that in case this setting is changed in the editor interface, it will be stored in the browser local storage and will overwrite any values sent as the editorConfig.customization.reviewDisplay parameter.
Defines if the review changes panel is automatically displayed or hidden when the editor is loaded. The default value is false. boolean false
Deprecated since version 7.0. Please use the review.showReviewChanges parameter instead.
Defines if the spell checker is automatically switched on or off when the editor is loaded. Spell checker will only be available for the document editor and the presentation editor. The default value is true. boolean true
Deprecated since version 7.1. Please use the features.spellcheck parameter instead.
Please note that in case this setting is changed in the editor interface, it will be stored in the browser local storage and will overwrite any values sent as the editorConfig.customization.spellcheck parameter.
Defines if the Submit button is displayed or hidden on the top toolbar. Button will only be available for the pdf format. The default value is false. boolean true
Submit button
Defines if the document title is visible on the top toolbar (false) or hidden (true). The default value is false. boolean false
Please note that this setting is used when the compactHeader and toolbarNoTabs parameters are set to true.
Defines if the top toolbar tabs are distinctly displayed (false) or only highlighted to see which one is selected (true). The default value is false. boolean false
Defines if the document is opened in the review editing mode (true) or not (false) regardless of the document.permissions.review parameter (the review mode is changed only for the current user). If the parameter is undefined, the document.permissions.review value is used (for all the document users). boolean true
Deprecated since version 7.0. Please use the review.trackChanges parameter instead.
Defines the editor theme settings. It can be set in two ways:
  • theme id - the user sets the theme parameter by its id (theme-light, theme-classic-light, theme-dark, theme-contrast-dark),
  • default theme - the default dark or light theme value will be set (default-dark, default-light). The default light theme is theme-classic-light.
The first option has higher priority.

Apart from the available editor themes, the user can also customize their own color themes for the application interface.
string theme-dark
Please note that in case this setting is changed in the editor interface, it will be stored in the browser local storage and will overwrite any values sent as the editorConfig.customization.uiTheme parameter.
Defines the measurement units used on the ruler and in dialog boxes. Can take the following values:
  • cm - centimeters,
  • pt - points,
  • inch - inches.
The default value is centimeters (cm).
string cm
Please note that in case this setting is changed in the editor interface, it will be stored in the browser local storage and will overwrite any values sent as the editorConfig.customization.unit parameter.
Defines the document display zoom value measured in percent. Can take values larger than 0. For text documents and presentations it is possible to set this parameter to -1 (fitting the document to page option) or to -2 (fitting the document page width to the editor page). The default value is 100. integer 100
Please note that in case this setting is changed in the editor interface, it will be stored in the browser local storage and will overwrite any values sent as the editorConfig.customization.zoom parameter.
* - available for editing only for ONLYOFFICE Developer Edition