Configuring Languages, Locations and Timezones

Configuring Languages, Locations and Timezones

Overview

This guide explains how to configure language, location and timezone settings at the company level. These settings establish defaults for all users, though individuals can override them with their own preferences.


Pre-requisites

Before configuring these settings, ensure you have:

  • Access to Company Settings

  • Knowledge of which languages your organisation requires

  • Details of your office locations and their timezones

Role Requirements

Action

Required Role

Action

Required Role

Add or remove languages

Owner, Admin

Set default language

Owner, Admin

Add or edit locations

Owner, Admin

Set company timezone

Owner, Admin


Quick Start Guide

Configuring Languages

Adding Available Languages

To enable languages for your users:

  1. Open the sidebar and select Settings

  2. Navigate to Company Settings

  3. Select Languages & Locations

  4. Under Languages, click Add Language

  5. Select the languages you want to make available

  6. Click Save

The languages you add will appear in the language switcher in the sidebar, allowing users to switch between them.

Setting the Default Language

The default language determines what new users see when they first access the platform, and what language emails are sent in when no user preference is set.

  1. Open the sidebar and select Settings

  2. Navigate to Company Settings

  3. Select Languages & Locations

  4. Under Default Language, select your preferred language from the dropdown

  5. Click Save


Configuring Locations

Locations help you organise users by physical site, office or region. Each location can have its own default language and timezone.

💡 Tip: Users can be assigned to multiple locations, with one marked as their primary location. This is useful for users who work across multiple offices.

Adding a Location

  1. Open the sidebar and select Settings

  2. Navigate to Company Settings

  3. Select Languages & Locations

  4. Under Locations, click Add Location

  5. Enter the location name (you can be as specific or general as you like—country, city, building name)

  6. Optionally set a default language and timezone for this location

  7. Click Save

Editing a Location

  1. Navigate to Settings > Company Settings > Languages & Locations

  2. Find the location you want to edit

  3. Click Edit next to the location

  4. Update the settings as needed

  5. Click Save


Configuring Timezones

Setting the Company Default Timezone

The company default timezone is used when no location or individual preference overrides it.

  1. Open the sidebar and select Settings

  2. Navigate to Company Settings

  3. Select Languages & Locations

  4. Under Timezone, select your company's primary timezone

  5. Click Save

Setting Location-Specific Timezones

When adding or editing a location, you can set a timezone that overrides the company default for all users in that location.

This is useful for organisations with offices in multiple time zones—each office can have its own default without requiring every user to set their preference manually.


SSO Language and Timezone Sync

If your organisation uses Single Sign-On (SSO), language and timezone preferences can be automatically synced when users sign in.

Okta Integration

Okta can sync the following attributes to Learn Amp:

  • preferredLanguage or locale – Sets the user's primary language

  • city – Can be mapped to a Learn Amp location

Azure AD Integration

Azure AD can sync:

  • preferredLanguage – Sets the user's primary language

  • Mailbox Settings – Can sync the user's timezone from their Microsoft 365 mailbox settings

  • officeLocation – Can be mapped to a Learn Amp location

💡 Tip: Contact your Customer Success Manager if you'd like to configure SSO attribute mapping for language or timezone.


How New Users Get Their Settings

When a new user joins the platform, their language and timezone are determined by:

  1. Manual invite – You can set a language when inviting a single user (step 6 of the invite flow)

  2. Bulk import – Include a 'language' column in your CSV file

  3. SSO integration – Okta and Azure AD support setting a primary language via default mappings

  4. HRIS integration – HiBob, Personio and other HRIS systems can sync timezone during provisioning

  5. Default fallback – If not specified, new users inherit the company default language


FAQs

Q: Can I assign a user to multiple locations?
Yes. Users can be assigned to multiple locations, with one marked as their primary location. The primary location determines their default timezone if they haven't set a personal preference.

Q: Will SSO overwrite a user's language preference each time they sign in?
This depends on your SSO configuration. Contact your Customer Success Manager to discuss the best approach for your organisation.


Troubleshooting

Issue

Solution

Issue

Solution

Language not syncing from SSO

Check that the preferredLanguage attribute is mapped correctly in your SSO configuration

Location not appearing for selection

Ensure the location has been created in Company Settings > Languages & Locations

Timezone mismatch after SSO sync

Verify the timezone format in your SSO provider matches Rails timezone names