Programming language: Go
License: MIT License
Latest version: v2.1.1

go-i18n alternatives and similar packages

Based on the "Natural Language Processing" category.
Alternatively, view go-i18n alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of go-i18n or a related project?

Add another 'Natural Language Processing' Package


go-i18n Build status Report card codecov Sourcegraph

go-i18n is a Go package and a command that helps you translate Go programs into multiple languages.

[English](README.md) · [简体中文](.github/README.zh-Hans.md)

Package i18n


The i18n package provides support for looking up messages according to a set of locale preferences.

import "github.com/nicksnyder/go-i18n/v2/i18n"

Create a Bundle to use for the lifetime of your application.

bundle := i18n.NewBundle(language.English)

Load translations into your bundle during initialization.

bundle.RegisterUnmarshalFunc("toml", toml.Unmarshal)
// If use go:embed
//go:embed locale.*.toml
var LocaleFS embed.FS

bundle.RegisterUnmarshalFunc("toml", toml.Unmarshal)
bundle.LoadMessageFileFS(LocaleFS, "locale.es.toml")

Create a Localizer to use for a set of language preferences.

func(w http.ResponseWriter, r *http.Request) {
    lang := r.FormValue("lang")
    accept := r.Header.Get("Accept-Language")
    localizer := i18n.NewLocalizer(bundle, lang, accept)

Use the Localizer to lookup messages.

    DefaultMessage: &i18n.Message{
        ID: "PersonCats",
        One: "{{.Name}} has {{.Count}} cat.",
        Other: "{{.Name}} has {{.Count}} cats.",
    TemplateData: map[string]interface{}{
        "Name": "Nick",
        "Count": 2,
    PluralCount: 2,
}) // Nick has 2 cats.

Command goi18n


The goi18n command manages message files used by the i18n package.

go get -u github.com/nicksnyder/go-i18n/v2/goi18n
goi18n -help

Extracting messages

Use goi18n extract to extract all i18n.Message struct literals in Go source files to a message file for translation.

# active.en.toml
description = "The number of cats a person has"
one = "{{.Name}} has {{.Count}} cat."
other = "{{.Name}} has {{.Count}} cats."

Translating a new language

  1. Create an empty message file for the language that you want to add (e.g. translate.es.toml).
  2. Run goi18n merge active.en.toml translate.es.toml to populate translate.es.toml with the messages to be translated.
   # translate.es.toml
   hash = "sha1-5b49bfdad81fedaeefb224b0ffc2acc58b09cff5"
   other = "Hello {{.Name}}"
  1. After translate.es.toml has been translated, rename it to active.es.toml.
   # active.es.toml
   hash = "sha1-5b49bfdad81fedaeefb224b0ffc2acc58b09cff5"
   other = "Hola {{.Name}}"
  1. Load active.es.toml into your bundle.
   bundle.RegisterUnmarshalFunc("toml", toml.Unmarshal)

Translating new messages

If you have added new messages to your program:

  1. Run goi18n extract to update active.en.toml with the new messages.
  2. Run goi18n merge active.*.toml to generate updated translate.*.toml files.
  3. Translate all the messages in the translate.*.toml files.
  4. Run goi18n merge active.*.toml translate.*.toml to merge the translated messages into the active message files.

For more information and examples:


go-i18n is available under the MIT license. See the [LICENSE](LICENSE) file for more info.

*Note that all licence references and agreements mentioned in the go-i18n README section above are relevant to that project's source code only.