---
title: Overview
description: "As stated earlier, the configuration attribute called **lstDomains** is an array containing one or more domain definition objects. The *domain definition data object* contains the following attributes for each data object. | Name | Optional | Type | Description |…"
url: "https://i2b2.org/docs/1-4-2-domain-configuration/"
updated: "2026-09-15"
category: i2b2 Installation Guide / Chapter 5. Client Installation / 4. i2b2 Classic Web Client Install (optional) / 1.4 Configuration / 1.4.2 Domain Configuration
---

# Overview

As stated earlier, the configuration attribute called **lstDomains** is an array containing one or more domain definition objects. The *domain definition data object* contains the following attributes for each data object.

| Name | Optional | Type | Description |
| --- | --- | --- | --- |
| domain | N | String | A short code used by the proxy server for the domain / group ID. |
| name | N | String | A human-readable string containing the domain's name. This is visible to users when logging into the i2b2 Web Client. |
| urlCellPM | N | String | The full path URL for the Project Management Cell. |
| allowAnalysis | Y | Boolean | Defines whether or not the plug-in viewer is available to users. The plugin viewer is used to access the optional plug-ins (Analysis Tools). This setting will affect **all users**. - ***Y*** = Analysis Tools **will appear** as an option on the menu bar. Users can access the optional plugins via the *Plugin Viewer*. - ***N*** = Analysis Tools **will not appear** as an option on the menu bar. Users will not be able to access the optional plug-ins. |
| debug | Y | Boolean | Defines whether or not debugging messages are logged. (uses additional memory). |
| registrationMethod | Y | String | **NEW 1.7.13!** Defines an information source for the new user registration tool. *(If showRegistration is true, this parameter must be present.)* - "SAML" = The tool will register users based on SAML EPPNs. - Any other value = The tool will register users with information entered in the registration form that pops up. |
| showRegistration | Y | Boolean | **NEW 1.7.13!** Determines whether a link to register new users appears. - true = A link to pop up the user registration tool will appear. (Note that new users will not be assigned to projects and so cannot log in without administrator approval.) - false = The registration tool will not appear. |
| loginType | N | String | **NEW 1.7.13!** Determines whether the local login screen or the SAML login screen appears. Parameter value is a required for the webclient to display the appropriate screens - "local" = local login screen - "federated" = SAML authentication screen |

# Steps to update domain

WARNING

Make sure you are editing the files in your **web server directory** and not the ones that reside in *YOUR_I2B2_WC_DIR*.

1. Go to the **web client folder** in your **web server directory**.

***Linux Example:***   /var/www/html

***Windows Example:***   C:\inetpub\wwwroot

2. Open the **i2b2_config_data.js** file to edit the domain information.

3. Edit or add additional domains for your environment.

Important

- If you are installing the i2b2 demo environment you want to add the "i2b2demo" domain and update the *urlCellPM* with the host and port with the location of your PM Cell.
- If you are setting up your own i2b2 environment with test or production data then you can copy the domain section and edit it to reflect your environment.
- You can comment out or remove the HarvardDemo domain. However, we highly recommend you leave it during the installation process so you can use it for troubleshooting whether an issue is with your local setup. You can remove it after everything is installed and is working.

  **i2b2_config_data.js**

4. If you have multiple domains (demo / test / production) you can copy the **{domain} section** and edit it to reflect the other domains in your environment.

  **i2b2_config_data.js**

5. Save the changes and close the file.