Change Number Format

You can use the API to set custom thousands and decimal separators, with values up to 8 characters in length. These settings can be applied at the organizational, workspace, or user level to best suit your organization’s preferences.

Two screenshots of the sameheadline visualization displayed using different number separators.

Organization

To change the number format for your entire organization, follow these steps.

UI
API

Steps:

  1. Go to Settings > Localization.

  2. Next to Number separators click Change.

    Screenshot of the Number separators option in Settings.

    Dialog opens:

    Screenshot of the Number separators dialog.
  3. Select a number format and click Apply.

If none of the listed options fit your use case, you can use the API to create your own custom number separators.

Make the following API call:

curl $HOST_URL/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": {
    "attributes": {
      "content": {
        "thousand": " ",
        "decimal": ","
      },
      "type": "SEPARATORS"
    },
    "id": "<your_custom_id>",
    "type": "organizationSetting"
  }
}' | jq .

Workspace

To change the number format for workspace, make the following API call:

curl $HOST_URL/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": {
    "attributes": {
      "content": {
        "thousand": " ",
        "decimal": ","
      },
      "type": "SEPARATORS"
    },
    "id": "<your_custom_id>",
    "type": "workspaceSetting"
  }
}' | jq .

User

To change the number format for an individual user, make the following API call:

curl $HOST_URL/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": {
    "attributes": {
      "content": {
        "thousand": " ",
        "decimal": ","
      },
      "type": "SEPARATORS"
    },
    "id": "<your_custom_id>",
    "type": "userSetting"
  }
}' | jq .