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 |
|---|---|
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:
Open the sidebar and select Settings
Navigate to Company Settings
Select Languages & Locations
Under Languages, click Add Language
Select the languages you want to make available
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.
Open the sidebar and select Settings
Navigate to Company Settings
Select Languages & Locations
Under Default Language, select your preferred language from the dropdown
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
Open the sidebar and select Settings
Navigate to Company Settings
Select Languages & Locations
Under Locations, click Add Location
Enter the location name (you can be as specific or general as you like—country, city, building name)
Optionally set a default language and timezone for this location
Click Save
Editing a Location
Navigate to Settings > Company Settings > Languages & Locations
Find the location you want to edit
Click Edit next to the location
Update the settings as needed
Click Save
Configuring Timezones
Setting the Company Default Timezone
The company default timezone is used when no location or individual preference overrides it.
Open the sidebar and select Settings
Navigate to Company Settings
Select Languages & Locations
Under Timezone, select your company's primary timezone
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:
Manual invite – You can set a language when inviting a single user (step 6 of the invite flow)
Bulk import – Include a 'language' column in your CSV file
SSO integration – Okta and Azure AD support setting a primary language via default mappings
HRIS integration – HiBob, Personio and other HRIS systems can sync timezone during provisioning
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 |
|---|---|
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 |