Imagine Español

Settings file (legacy)

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

  • Android
  • Mac
  • Windows (standalone)
  • Windows Store

Use of the settings file for mass configuration is not supported if you are running Imagine Español 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_espanol.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 EngineAddress key for Imagine Español deployment. Don't use two address keys in the same JSON file.

Imagine Learning JSON keys and values




Enter any valid IP address or host name for Imagine Español 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.


Enter the username associated with the proxy server. This setting is supported in Windows and Mac standalone clients.


Enter the password associated with the proxy server. This setting is supported in Windows and Mac standalone clients.


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 Español with a proxy server.

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.

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.IL\files\


/Library/Application Support/Imagine Learning

Mac App Store

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



Windows Store

.ImagineLearning_q6aj84ys0e2nr\ LocalState\client_settings.json


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