Change Display Language

Overview

By default, GoodData displays the user interface in English.

You can enable a different display language for your organization, workspace, or even for individual users. Dashboards and Analytical Designer are then displayed in the language that you select.

The GoodData user interface is available in the following languages: Chinese, Dutch, French, German, Japanese, Portuguese (Brazil), Portuguese (Portugal), Russian, Spanish.

Change the Language

To change the display language:

  1. Create the locale setting.
  2. Enable the language that you want to use.

The following table shows the IDs that you can use to enable the languages:

LanguageLanguage ID
Chinesezh-Hans
Dutchnl-NL
English (default)en-US
Frenchfr-FR
Germande-DE
Japaneseja-JP
Portuguese (Brazil)pt-BR
Portuguese (Portugal)pt-PT
Russianru-RU
Spanishes-ES

Organization

To change the display language for the whole organization, follow these instructions:

API (Bash)
API (Powershell)

To create the locale organization settings, send the following POST request /api/v1/entities/organizationSettings:

curl $ENDPOINT/api/v1/entities/organizationSettings \
  -H "Content-Type: application/vnd.gooddata.api+json" \
  -H "Accept: application/vnd.gooddata.api+json" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -X POST \
  -d '{
    "data":
    {
        "type": "organizationSetting",
        "id": "locale",
        "attributes": {
            "content": {"value": "{LANGUAGE_ID}"}
        }
    }
}' | jq .

To enable a different language, send the following PUT request /api/v1/entities/organizationSettings/locale:

curl $ENDPOINT/api/v1/entities/organizationSettings/locale \
  -H "Content-Type: application/vnd.gooddata.api+json" \
  -H "Accept: application/vnd.gooddata.api+json" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -X POST \
  -d '{
    "data":
    {
        "type": "organizationSetting",
        "id": "locale",
        "attributes": {
            "content": {"value": "{LANGUAGE_ID}"}
        }
    }
}' | jq .

To create the locale organization settings, send the following POST request /api/v1/entities/organizationSettings:

Invoke-RestMethod -Method Post -Uri '$ENDPOINT/api/v1/entities/organizationSettings' `
-ContentType 'application/vnd.gooddata.api+json' `
-H @{ 
    'Accept' = 'application/vnd.gooddata.api+json'
    'Authorization' = 'Bearer {API_TOKEN}' 
} `
-Body '{
    "data":
    {
        "type": "organizationSetting",
        "id": "locale",
        "attributes": {
            "content": {"value": "{LANGUAGE_ID}"}
        }
    }
}' | ConvertTo-Json

To enable a different language, send the following PUT request /api/v1/entities/organizationSettings/locale:

Invoke-RestMethod -Method Post -Uri '$ENDPOINT/api/v1/entities/organizationSettings/locale' `
-ContentType 'application/vnd.gooddata.api+json' `
-H @{ 
    'Accept' = 'application/vnd.gooddata.api+json'
    'Authorization' = 'Bearer {API_TOKEN}' 
} `
-Body '{
    "data":
    {
        "type": "organizationSetting",
        "id": "locale",
        "attributes": {
            "content": {"value": "{LANGUAGE_ID}"}
        }
    }
}' | ConvertTo-Json

Workspace

To change the display language for individual workspaces, follow these instructions:

API (Bash)
API (Powershell)

To create the locale workspace settings, send the following POST request /api/v1/entities/workspaceSettings:

curl $ENDPOINT/api/v1/entities/workspaces/{WORKSPACE_ID}/workspaceSettings \
  -H "Content-Type: application/vnd.gooddata.api+json" \
  -H "Accept: application/vnd.gooddata.api+json" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -X POST \
  -d '{
    "data":
    {
        "type": "workspaceSetting",
        "id": "locale",
        "attributes": {
            "content": {"value": "{LANGUAGE_ID}"}
        }
    }
}' | jq .

To enable a different language, send the following PUT request /api/v1/entities/workspaceSettings/locale:

curl $ENDPOINT/api/v1/entities/workspaces/{WORKSPACE_ID}/workspaceSettings/locale \
  -H "Content-Type: application/vnd.gooddata.api+json" \
  -H "Accept: application/vnd.gooddata.api+json" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -X PUT \
  -d '{
    "data":
    {
        "type": "workspaceSetting",
        "id": "locale",
        "attributes": {
            "content": {"value": "{LANGUAGE_ID}"}
        }
    }
}' | jq .

To create the locale workspace settings, send the following POST request /api/v1/entities/workspaceSettings:

Invoke-RestMethod -Method Post -Uri '$ENDPOINT/api/v1/entities/workspaces/{WORKSPACE_ID}/workspaceSettings' `
-ContentType 'application/vnd.gooddata.api+json' `
-H @{ 
    'Accept' = 'application/vnd.gooddata.api+json'
    'Authorization' = 'Bearer {API_TOKEN}' 
} `
-Body '{
    "data":
    {
        "type": "workspaceSetting",
        "id": "locale",
        "attributes": {
            "content": {"value": "{LANGUAGE_ID}"}
        }
    }
}' | ConvertTo-Json

To enable a different language, send the following PUT request /api/v1/entities/workspaceSettings/locale:

Invoke-RestMethod -Method Put -Uri '$ENDPOINT/api/v1/entities/workspaces/{WORKSPACE_ID}/workspaceSettings/locale' `
-ContentType 'application/vnd.gooddata.api+json' `
-H @{ 
    'Accept' = 'application/vnd.gooddata.api+json'
    'Authorization' = 'Bearer {API_TOKEN}' 
} `
-Body '{
    "data":
    {
        "type": "workspaceSetting",
        "id": "locale",
        "attributes": {
            "content": {"value": "{LANGUAGE_ID}"}
        }
    }
}' | ConvertTo-Json

User

To change the display language for individual users, follow these instructions:

API (Bash)
API (Powershell)

To create the locale user settings, send the following POST request /api/v1/entities/userSettings:

curl $ENDPOINT/api/v1/entities/users/{USER_ID}/userSettings \
  -H "Content-Type: application/vnd.gooddata.api+json" \
  -H "Accept: application/vnd.gooddata.api+json" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -X POST \
  -d '{
    "data":
    {
        "type": "userSetting",
        "id": "locale",
        "attributes": {
            "content": {"value": "{LANGUAGE_ID}"}
        }
    }
}' | jq .

To enable a different language, send the following PUT request /api/v1/entities/userSettings/locale:

curl $ENDPOINT/api/v1/entities/users/{USER_ID}/userSettings/locale \
  -H "Content-Type: application/vnd.gooddata.api+json" \
  -H "Accept: application/vnd.gooddata.api+json" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -X PUT \
  -d '{
    "data":
    {
        "type": "userSetting",
        "id": "locale",
        "attributes": {
            "content": {"value": "{LANGUAGE_ID}"}
        }
    }
}' | jq .

To create the locale user settings, send the following POST request /api/v1/entities/userSettings:

Invoke-RestMethod -Method Post -Uri '$ENDPOINT/api/v1/entities/users/{USER_ID}/userSettings' `
-ContentType 'application/vnd.gooddata.api+json' `
-H @{ 
    'Accept' = 'application/vnd.gooddata.api+json'
    'Authorization' = 'Bearer {API_TOKEN}' 
} `
-Body '{
    "data":
    {
        "type": "userSetting",
        "id": "locale",
        "attributes": {
            "content": {"value": "{LANGUAGE_ID}"}
        }
    }
}' | ConvertTo-Json

To enable a different language, send the following PUT request /api/v1/entities/userSettings/locale:

Invoke-RestMethod -Method Put -Uri '$ENDPOINT/api/v1/entities/users/{USER_ID}/userSettings/locale' `
-ContentType 'application/vnd.gooddata.api+json' `
-H @{ 
    'Accept' = 'application/vnd.gooddata.api+json'
    'Authorization' = 'Bearer {API_TOKEN}' 
} `
-Body '{
    "data":
    {
        "type": "userSetting",
        "id": "locale",
        "attributes": {
            "content": {"value": "{LANGUAGE_ID}"}
        }
    }
}' | ConvertTo-Json