Modules

Modules allow apps to extend the Crowdin Enterprise user interface, create integrations with external services, etc.

Supported Modules

• Integrations module – insert a new integration page in Crowdin Enterprise.
• Crowdsource-panels module – create additional panels on the crowdsourcing public page.
• Editor-panels module – create additional panels in the Editor.
• Resources module – create an additional panel in the organization’s resources.
• Organization menu module – create a new section in the left panel of the Workspace home page.
• Project menu module – create a new section in the left panel of the Project home page.
• Custom MT (Machine Translation) Module – connect machine translation engines, that aren’t supported in Crowdin by default yet.

More Crowdin Apps modules are coming soon.

Integrations Module

Integrations module provides a possibility to create and insert a new integration within the Crowdin Enterprise project. You can find it in the Resources > Integrations & API. This module is available to project members with manager permissions (or higher).

Integration module structure:

{
  "integrations": [
    {
      "key": "my-module-key",
      "name": "Module name",
      "description": "Module description",
      "logo": "/logo.png",
      "url": "/integration-page"
    }
  ]
}

Properties:

Crowdsource-panels Module

Crowdsource-panels module provides a possibility to create additional tabs on the crowdsourcing public page of the project. To work with this module, make sure that your project meets the following requirements:

• The project’s workflow contains the Crowdsourcing step.
• The project is published on the Crowdsourcing settings page.

This module is available to all authorized users.

Crowdsource-panel module structure:

{
  "crowdsource-panels": [
    {
      "key": "my-module-key",
      "name": "Module name",
      "url": "/crowdsource-page"
    }
  ]
}

Properties:

Editor-panels Module

Editor-panels module provides a possibility to create additional tabs in the Editor. When using this module in your Crowdin app, you can choose the Editor mode where you’d like the additional tabs to be displayed. Editor-panels module is available only to the project members that have access to the Editor.

Editor-panel module structure:

{
  "editor-panels": [
    {
      "key": "my-module-key",
      "position": "right",
      "name": "Module name",
      "modes": ["translate", "proofread"],
      "url": "/editor-page"
    }
  ]
}

Properties:

Resources Module

Resources module provides a possibility to create an additional panel in the organization’s resources. This module is available to project members with manager permissions (or higher).

Resource module structure:

{
  "resources": [
    {
      "key": "my-module-key",
      "name": "Module name",
      "url": "/resource-page"
    }
  ]
}

Properties:

Organization Menu Module

Organization menu module provides a possibility to create a new section in the left panel of the Workspace home page. This module is available only to organization admins.

Organization menu module structure:

{
  "organization-menu": [
    {
      "key": "my-module-key",
      "name": "Module name",
      "url": "/organization-page",
      "icon": "/images/icon.png"
    }
  ]
}

Properties:

Project Menu Module

Project menu module provides a possibility to create a new section in the left panel of the Project home page. This module is available to project members with manager permissions (or higher).

Project menu module structure:

{
  "project-menu": [
    {
      "key": "my-module-key",
      "name": "Module name",
      "url": "/project-page"
    }
  ]
}

Properties:

Custom MT (Machine Translation) Module

This module helps you connect machine translation engines that are not supported by Crowdin yet. Once you create this kind of app, you’ll be able to pre-translate your content with the connected MT or enable translation suggestions made by it to be shown in the editor for translators.

Custom MT module structure:

{
   "custom-mt": [
     {
            "key": "custom-mt",
            "name": "Custom MT",
            "url": "/translate"
      }
    ]
}

Properties:

Add Modules to Your Crowdin App

To use a module in your app, declare the module in your App Descriptor file under modules, including any required properties. The properties you include will control the customization options for your module.

Basic module structure:

{
  "{module_type}": [
    {
      "key": "my-module-key",
      "name": "Module Name"
    }
  ]
}

Properties: