MathType for OxygenXML Web Author

  • Oxygen XML Web Author 18.x or 19.x Installed
  • A valid license to install the integration in a production environment; otherwise, you can use the downloaded file just for demo purposes.
There are two ways to install MathType integration depending on Oxygen version.

Install MathType integration adding it to the Oxygen XML Web author (method 1)

  1. Go to your Oxygen's Administration Page.
  2. Select "Plugins" and click Add integration and choose a integration file to upload.
  3. Click OK to upload a file. The integration should appear in the list on this page.
  4. Restart the server.
  5. Enable the integration on Plugins Oxygen's Administration Page.
  6. Try that works.

For further information see Oxygen's Documentation.

Install MathType integration copying the files (method 2,only for Oxygen18.x)

  1. Stop the Java server.
  2. Unzip MathType integration for Oxygen XML inside Oxygen XML file. By default, file are on your oxygenwebapp/WEB-INF directory.
  3. Restart the Java server.

Compatible documents with MathType integration

Currently MathType integration for Oxygen is compatible with DITA documents, as well as xhtml, DocBook and JATS. If you want MathType integration working with another type of document please contact us at

In order to customize default MathType toolbar, one can call WirisAction.setCustomToolbar(toolbar) method. With this method MathType toolbar can be customize at any application level: from application level to document level.

WirisAction.setCustomToolbar admits a string as parameter:

- A string with a predefined toolbar: default, quizzes, evaluate, PARCC_Grade3_5, PARCC_Grade6_8 and PARCC_Grade9_12.

- A XML string containing a custom toolbar definition. For further information about custom toolbar definitions see the Custom toolbar section


The following example shows how to use a predefined toolbar. It's important call WirisAction.setCustomToolbar(toolbar) method once Oxygen editor has been loaded. For that porpouse we use the Oxygen's event BEFORE_EDITOR_LOADED with the Google Closure Library:, sync.api.Editor.EventTypes.BEFORE_EDITOR_LOADED, function(e) {

The following example shows how to use a custom toolbar defined by an xml. As in the example above we use BEFORE_EDITOR_LOADED event to call WirisAction.setCustomToolbar() method., sync.api.Editor.EventTypes.BEFORE_EDITOR_LOADED, function(e) {
    var xml = '<toolbar ref="general"><tab ref="advanced" before="contextual"/></toolbar>';
By default, MathType inserts a Math Editor icon and a Chemistry Editor icon into Oxygen's specific document toolbar (like DITA toolbar or DocBook toolbar). In order to disable a specific icon, disableToolbar(editor) method should be used. It's important call disableToolbar(editor) method once Oxygen WEB XML editor is loaded.

1.- Disable MathType icon:

sync.api.Workspace.EventType.BEFORE_EDITOR_LOADED, function(e) {

2- DisableMathTypeChemistry icon:

sync.api.Workspace.EventType.BEFORE_EDITOR_LOADED, function(e) {