--- title: "List Boxes" slug: "list-boxes" updated: 2024-03-25T19:09:41Z published: 2024-03-25T19:09:41Z canonical: "skthelp.syniti.com/list-boxes" --- > ## Documentation Index > Fetch the complete documentation index at: https://skthelp.syniti.com/llms.txt > Use this file to discover all available pages before exploring further. # List Boxes ## About List Boxes List Boxes provide an opportunity to support check tables or drop-down lists for fields within Syniti Migrate. There is a significant list of defaulted list boxes based upon the system, but users are allowed to add new list boxes based upon needs for Migration fields. View the following page by navigating to **Administer > Advanced > List Boxes** from the Syniti Migrate Homepage. ![null](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/List Boxes.png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A21%3A09Z&se=2026-11-17T20%3A21%3A09Z&sr=b&sp=r&sig=kxp65EZlkzoGCiNc3qZlaR7MGaTPt9P%2BWI%2FB4pcuqY4%3D)List Boxes: Display The system defaulted list boxes are fixed. These system default details may be displayed using the **Edit** ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/b0037228-b665-495b-a184-abdea254aca7.png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A21%3A09Z&se=2026-11-17T20%3A21%3A09Z&sr=b&sp=r&sig=nPOMzHCOcCDIHQoKw8cNzzcitAQxqzrIxlkHnket4u4%3D) icon, but the user cannot edit fields within an existing system defaulted list box. The Add icon displays a Listbox Key if the Listbox is configurable. Therefore, depending upon the configuration for the List Box, Listbox Keys may be editible, deleted, or added. The image below confirms that since the keys are not configurable, there is no **Add** ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/864f74d2-d38b-4100-92c3-2b08db0257c3.png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A21%3A09Z&se=2026-11-17T20%3A21%3A09Z&sr=b&sp=r&sig=OOczczpphC2zhgPXbkTPDhNku9jQ6G7%2FZjJWe4pePUY%3D) icon visible in the Listbox Key panel for this Listbox row. ![null](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/List Boxes_1.png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A21%3A09Z&se=2026-11-17T20%3A21%3A09Z&sr=b&sp=r&sig=SiLuJ3gmt9QrVdn8ER0KFDDxC%2FNCfd3x5%2BIwShPgNgk%3D)List Boxes: Edit ## Listbox Key Each Listbox contains a list of Key fields. The system defaulted list boxes also contain lists of Key fields. Most of the Listbox Key fields are set to Locked - no changes. However, a small number of these key fields are allowed for changes to mark as Active/Inactive, Edit field values, and even to Delete the Listbox Key value. An example is for the Listbox DATASOURCE_ENVIRONMENT. In this situation, there may be a need to Add new, Edit, or Delete current Instances for a Datasource, and so these Listbox Key fields may be updated as well as displayed. Each Listbox should be checked to determine if the icons for Edit, Add, and Delete are active and in use. ![null](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/List Boxes_2.png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A21%3A09Z&se=2026-11-17T20%3A21%3A09Z&sr=b&sp=r&sig=eVD1r8W6TJISTo17Au0qY3iqsuKqZ9jv55MC1ZqyTZE%3D)List Boxes: Listbox Keys ## Add a List Box Although there is a significant list of list boxes already defaulted to the system and built within the core database tables, users may need to create additional list boxes. The Syniti Migrate system allows users to build these new list boxes. Click the **Add** ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/864f74d2-d38b-4100-92c3-2b08db0257c3.png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A21%3A09Z&se=2026-11-17T20%3A21%3A09Z&sr=b&sp=r&sig=OOczczpphC2zhgPXbkTPDhNku9jQ6G7%2FZjJWe4pePUY%3D) icon within Listbox panel to open a dialog box for a new Listbox. ![null](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/List Boxes_2(1).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A21%3A09Z&se=2026-11-17T20%3A21%3A09Z&sr=b&sp=r&sig=5%2B501zr790oN%2Fn8lLQSlvRB%2Ba4QvNHbYmQQuRw%2Fz9lI%3D)List Boxes: Add | Field | Definition | | --- | --- | | Listbox Name* | The unique name to identify this Listbox. (Required) | | Description* | Short description of the Listbox. (Required) | | Title Format* | Select from the drop-down list the format of the key fields. (KEY, TITLE, KEY - TITLE, or TITLE (KEY) | | Key Configurable | Toggle switch to determine if this listbox is key configurable. (Display Only and allows marked as Active) | When finished with edits, click the **Save** ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/be18bc48-1f95-4f70-a429-ad4be8fd121b.png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A21%3A09Z&se=2026-11-17T20%3A21%3A09Z&sr=b&sp=r&sig=GmWPnKzeRC9B6w%2F8xdKgWWE2fVFmdK5XnePa74OFJUQ%3D) icon to complete. > [!NOTE] > Note > > *The newly added non system defaulted listbox displays as Active for Edit and Delete as they are user entered.* ## Add a Listbox Key Once the List Box is added and saved, the user can then add Listbox Key fields for use in this listbox. Click the **Add** ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/864f74d2-d38b-4100-92c3-2b08db0257c3.png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A21%3A09Z&se=2026-11-17T20%3A21%3A09Z&sr=b&sp=r&sig=OOczczpphC2zhgPXbkTPDhNku9jQ6G7%2FZjJWe4pePUY%3D) icon within the right side panel for Listbox Key to open a dialog box for the new value. ![null](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/List Boxes_4.png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A21%3A09Z&se=2026-11-17T20%3A21%3A09Z&sr=b&sp=r&sig=Bz2y9r1S49jdCmQnxwbaG4ZlsKFnMqmdZoTLifCATxQ%3D)List Boxes: Add List Box Key | Field | Definition | | --- | --- | | Sort Order | The sequence of where data appears in the list. | | Key* | The unique identifier for each value in this list that will populate automatically. (Required) | | Title | The name for the Key field. | | Subtitle | Additional title or description. | | Description | Short description of the Listbox Key usage. | | Active | Toggle the status of the list box as active\inactive. > [!NOTE] > Note > > *Defaults as Active.* | When finished with edits, click the **Save** ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/be18bc48-1f95-4f70-a429-ad4be8fd121b.png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A21%3A09Z&se=2026-11-17T20%3A21%3A09Z&sr=b&sp=r&sig=GmWPnKzeRC9B6w%2F8xdKgWWE2fVFmdK5XnePa74OFJUQ%3D) icon to complete. ## Edit the List Box Key After the Listbox and Listbox Key Fields are entered and saved, the list box is complete and ready for use. ![null](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/List Boxes_4(1).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A21%3A09Z&se=2026-11-17T20%3A21%3A09Z&sr=b&sp=r&sig=%2Fng2rOjwREnZnK6O31GV1mFMQFHIbcU%2FCFyWSmAHMZE%3D)List Boxes: Edit ## Delete a List Box Only the manually created list boxes may be deleted, and only if they are not actively used in a page. Click the **OK** button to proceed. ![null](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/List Boxes_4(2).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A21%3A09Z&se=2026-11-17T20%3A21%3A09Z&sr=b&sp=r&sig=Kik4kXheJ5RYSwU2ol0BmYEDCdL3tBeiXpvOIVD78pY%3D)List Boxes: Delete