Imagine Language & Literacy

Settings file (legacy)


The information on this page is valid only for the Imagine Learning legacy app.

You can use a JavaScript Object Notation (JSON) file for mass configuration of Imagine Learning settings. This feature is available in Imagine Learning legacy version 1.55.11190 or later. The JSON settings file can be used with these apps:

  • Android
  • Mac
  • Windows
  • Windows Store

Use of the settings file for mass configuration is not supported if you are running Imagine Learning in a web browser with the Unity Web Player, or using the iPad app. See Chrome management to find out how to make a settings file for Chrome.

To create a settings file with the settings file generator

  1. Click to access the settings file generator.
  2. Enter information in the required fields.
  3. Click Generate. A configuration file is created.

To create a settings file manually

  1. Create a JSON file using a text editor of your choice.
  2. Name the file client_settings.json.
  3. Enter the desired keys and values and save the file.
  4. Validate the JSON file before you use it. You can access an online JSON validator tool by clicking here.
  5. Move the file to the proper location. Paths for each app are specified in the table below.

Use the CloudSiteCode key for cloud deployment or the EngineAddress key for on-premise server deployment. Don't use two address keys in the same JSON file.

Imagine Learning JSON keys and values




Enter any valid Site Code for cloud deployment.


Enter any valid IP address or host name for on-premise server deployment.


Enter the desired caching option. Options include CacheAsYouGoPreCache, and Streaming.


Enter the desired browser. Options include IEFirefoxSafari, and Chrome.


Enter true or false. Use this setting if you are connecting to a secure on-premise server over HTTPS. This setting is not necessary for the cloud.


Enter the username associated with the proxy server. This setting is supported in Windows and Mac standalone clients and is available in version 1.69.13809 or later.


Enter the password associated with the proxy server. This setting is supported in Windows and Mac standalone clients and is available in version 1.69.13809 or later.


Enter the IP address of your web proxy with a colon followed by your port number (e.g., This setting should be used only at sites experiencing issues related to using Imagine Language & Literacy with a proxy server and is available in version 1.69.13809 or later.

These values are case sensitive. Ensure that the syntax used in the JSON is correct. Each key should be entered within quotation marks. True and false values do not have quotation marks; all other values do. Commas are required after each value, except for the last. If you edit a JSON file using a Mac OS X text editor, smart quotes may invalidate the JSON.

Cloud deployment

                "CachingMode": "CacheAsYouGo",
                "CloudSiteCode": "1234567"
                "CustomBrowser": "Firefox",
                "EnableHttps": false,
                "ProxyUser": "user1",
                "ProxyPassword": "password1"
                "webProxy": ""

On-premise deployment

                "CachingMode": "CacheAsYouGo",
                "CustomBrowser": "Firefox",
                "EnableHttps": false,
                "EngineAddress": "",
                "ProxyUser": "user1",
                "ProxyPassword": "password1"
                "webProxy": ""

Settings file locations




\Android Device\Internal storage\Android\data\com.ImagineLearning


/Library/Application Support/Imagine Learning

Mac App Store

ILM/Data/Library/Application Support/Library/Caches/client_settings.json



Windows Store

.ImagineLearning_q6aj84ys0e2nr\ LocalState\client_settings.json


The client_settings.json file works in conjunction with Imagine Learning configuration. The local client_settings.json file will always override what it retrieves from Imagine Learning; however, values received that are not currently set in the client_settings.json file will be updated.