DSpace Language Packs to support multiple languages.

dspace, i18n, internationalization, language-packs


DSpace API and JSPUI Language Packs

Layout of the source tree

The files for each language are stored in the src/main/resources directory.

The file naming conventions are as follows:

Messages_<ISO 639-1>_<ISO 3166-1>.properties

  • ISO 639-1: language code, in lower case.
  • ISO 3166-1: codes for country, if required. For example:

For example:

  • `src/main/resources/``
    • - file for default (English)
    • - file for Greek
    • - file for French (France)
    • - file for French (Canada)

For languages that can be fully represented using the Latin-1 character set, the appropriate file is placed in the relevant directory:


For languages that require other encodings, they are stored in this tree in their native encoding for ease of editing, patching and so forth. The filename extension representing the encoding, for example:


The Maven build process supports native2ascii conversion on packaging of the UTF-8 files prior to packaging the jar.

Release tags

Language packs are versioned according to the main DSpace version, but also include an incrementing sequence-number which allows language packs to be updated more frequently than DSpace releases.

So, DSpace software releases are of the format: [major].[minor] (e.g. 4.0, 4.1, 5.0, 5.1, etc.)

Whereas, DSpace language packs use the format: [major].[minor].[sequence-number] (e.g. 5.0.0, 5.0.1, 5.0.2 for 5.0 releases of the language packs).

Language packs are automatically installed into DSpace via Maven dependencies. In the case of the API and JSPUI language packs, they are installed as a JAR (e.g. dspace-api-lang-[version].jar) dependency.

Other tools

This is a handy Perl tool for determining which message keys are present in one properties file versus another. This is useful for determining whether a translation is complete. If you run:

the tool will tell you which keys are missing from, and which (if any) are in but not in the core

In a complete translation for a particular version, there should be no missing or extra keys.


Additional documentation on language packs and I18N (internationalization) may be found at Internationalization Support

Documentation for each release may be viewed online or downloaded via our Documentation Wiki.


DSpace is a community built and supported project. We do not have a centralized development or support team, but have a dedicated group of volunteers who help us improve the software, documentation, resources, etc.

We welcome contributions of any type. Here's a few basic guides that provide suggestions for contributing to DSpace:

We also encourage GitHub Pull Requests (PRs) at any time. Please see our Development with Git guide for more info.

In addition, a listing of all known contributors to DSpace software can be found online at:

Getting Help

DSpace provides public mailing lists where you can post questions or raise topics for discussion. We welcome everyone to participate in these lists:

Additional support options are listed at

DSpace also has an active service provider network. If you'd rather hire a service provider to install, upgrade, customize or host DSpace, then we recommend getting in touch with one of our Registered Service Providers.

Issue Tracker

The DSpace Issue Tracker can be found at:


DSpace source code is freely available under a standard BSD 3-Clause license. The full license is available at