Skip to main content
Pentaho Documentation

Pentaho Server and Thin Client Message Bundles

Note: Stop the Pentaho application server before editing anything inside of the Pentaho WAR file.

You can localize the Pentaho User Console, Pentaho Analyzer, and Dashboard Designer by creating locale- and language-specific message bundles within the Pentaho Web application. Message bundles are dynamically adjusted according to browser locale, so you can create localized message bundles for every language you want to support, and let each individual user's system language settings determine which one is loaded.

Localization language packs have been created through a community initiative that uses an installer built by Webdetails, a Pentaho company. The language packs apply to both EE and CE, and are maintained by community members. The packs are not officially supported by Pentaho.

For brevity's sake, only the default Pentaho User Console files will be explained in detail. The file naming convention is identical among all message bundles in Pentaho Business Analytics. The following files are located in the /mantle/messages/ directory:

  • The default message bundle for the Pentaho User Console. In its initial condition, it is a copy of If you want to change the default language and dialect, copy your preferred message bundle file over this one.
  • The English-language version of the standard message bundle. This is an identical copy of
  • The French-language version of the standard message bundle.
  • The German-language version of the standard message bundle.
  • Contains a list of localized message bundles and the native language names they correspond to; this relieves the BA Server of the burden of having to discover them on its own. A file should be created for every message bundle that you intend to localize.
Example of

New files are created in the following format: where xx represents a lowercase two-letter language code, and YY represents a two-letter locale code, where applicable. So, for instance, U.S. and British English could have two separate message bundles if you wanted to draw a distinction between the two dialects:


The language and country codes must be in standard ISO format. You can look up both sets of codes on these pages:

You can edit the default message bundle directly if you need to make surgical changes to the content inside of it. If you plan to translate it into another language, it makes more sense to copy the file and change the name appropriately, then translate it line by line. Be sure to update with the new country and dialect code and the native language name that it corresponds to.

Note: All message bundles must be UTF-8 encoded.