You're looking at an older version of Totara Learn.

Please see Totara 15 help for the latest version.

All pages


You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

Location settings

Location settings can be found within the Administration block via Site administration > Location > Location settings.

Most of the below options will only need setting during initial implementation

General Location Settings

Default timezone

This is the default timezone for displaying dates - each user can override this setting in their profile. Cron tasks and other server settings are specified in this timezone. You should change the setting if it shows as 'Invalid timezone'.

Force timezone

You can allow users to individually select their timezone, or force a timezone for everyone. 

CSV Import date format

Date format to be used in CSV imports like user uploads with date custom profile fields, or HR Import. The date format should be compatible with the formats defined in the PHP DateTime class


  • d/m/Y if the dates in the CSV are of the form 21/03/2012
  • d/m/y if the dates in the CSV have 2-digit years 21/03/12
  • m/d/Y if the dates in the CSV are in US form 03/21/2012
  • Y-m-d if the dates in the CSV are in ISO form 2012-03-21

Default country

The country entered here will be used by default on new user accounts unless an alternative country has been provided. To force users to choose a country, just leave this unset.

Default city

A city entered here will be the default city when creating new user accounts unless an alternative has been provided.  A user's city can be changed from the default if required.

IP address lookup

By default Totara LMS uses the free online NetGeo (The Internet Geographic Database) server to lookup location of IP addresses, unfortunately this database is not maintained anymore and may return wildly incorrect data. It is recommended to install local copy of free GeoLite City database from MaxMind.

IP address location is displayed on simple map or using Google Maps. Please note that you need to have a Google account and apply for free Google Maps API key to enable interactive maps.

GeoIP City data file

Setting executable and local paths disabled in config.php

Location of GeoIP City binary data file. This file is not part of Totara distribution and must be obtained separately from MaxMind. You can either buy a commercial version or use the free version. Simply download and extract it into "/var/www/data/prototype/geoip/" directory on your server.

All country codes

This is the list of countries that may be selected in various places, for example in a user's profile. If blank (the default) the list in countries.php in the standard English language pack is used. That is the list from ISO 3166-1 ( Otherwise, you can specify a comma-separated list of codes, for example 'GB,FR,ES'. If you add new, non-standard codes here, you will need to add them to countries.php in 'en' and your language pack.

Google Maps

Google Maps Javascript API key

If you use Google Map features within Totara we strongly recommend that you read and agree to the Google Maps JavaScript API Terms of Service and generate a Google Maps JavaScript API key for use within your site.

Information on obtaining a key can be found at

Please refer to the Google Maps JavaScript API Terms of Service for permitted use. For help understanding the Terms of Service refer to the Terms of Service FAQ's

If you have purchased a Premium Plan then please put your Client ID into the API key setting, Totara will recognise this as Client ID and treat it as such.

Totara LMS currently uses the Google Maps JavaScript API in the following locations:

  • Location custom fields.
  • IP Address lookup visualisation within the site log reports.

Google Maps address returns results influenced by your region/country. For example, searches for "San Francisco" may return different results if sent from a domain within the United States than one sent from Spain. This should be the ISO 3166-1 code for the appropriate region/country.

If empty, map text will be displayed using the user's browser's language. Set this setting to force all users to see map text in the specified language. Visit for a list of supported languages.

Default zoom level

Sets the initial zoom level of the map. Accepted values range from 0 (the whole world) to 21 (individual buildings). The upper limit can vary depending on the map data available at the selected location.

Check User Timezones

User Timezone settings can be found within the Administration block via Site administration > Location > Check User Timezones

This tool checks the timezones specified in the profiles of your users. In order for timezones to work correctly a location-based timezone should be specified, e.g. America/New_York, Europe/London, Asia/Singapore. Some timezone abbreviations (e.g. CET, EST) and UTC offsets (e.g +/-4.5) will not calculate Daylight Savings changes correctly.

This tool will allow you to change unsupported timezones to an approved format if required.

On this page

Provide feedback about this page using the link in the bottom right of this page. 

Still have questions? Why not post them in the forums of the Totara Community?