Skip to content
Translate your Go program into multiple languages.
Go Shell
Branch: master
Clone or download

Latest commit

patgrasso Add a nil pointer check before dereferencing an identifier's Obj (#211)
When walking the AST during extraction, if an identifier in a composite
literal is encountered that does not define in that file, the `Obj`
field of the `ast.Ident` will be nil.

Rather than panicking in this case, have the literal string extraction
function return false (no string found).

Also, add a test case representing this scenario.
Latest commit 949485d Feb 28, 2020


Type Name Latest commit message Commit time
Failed to load latest commit information.
v2 Add a nil pointer check before dereferencing an identifier's Obj (#211) Feb 29, 2020
.codecov.yml Update (#177) May 19, 2019
.gitignore fix automatic release Jun 13, 2019
.golangci.yml remove comment Jun 11, 2019
.travis.yml remove go.mod Jun 13, 2019 Revert "change package" May 10, 2019
LICENSE Revert "update license for 2015" Jul 1, 2015 Move code to v2 subfolder for greater compatibility (#187) Jun 11, 2019 Move code to v2 subfolder for greater compatibility (#187) Jun 11, 2019

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.

Package i18n GoDoc

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

import ""

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)

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 GoDoc

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

go get -u
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.

  2. Run goi18n merge active.en.toml to populate with the mesages to be translated.

    hash = "sha1-5b49bfdad81fedaeefb224b0ffc2acc58b09cff5"
    other = "Hello {{.Name}}"
  3. After has been translated, rename it to

    hash = "sha1-5b49bfdad81fedaeefb224b0ffc2acc58b09cff5"
    other = "Hola {{.Name}}"
  4. Load 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 file for more info.

You can’t perform that action at this time.