Important Information: By reading this Help page, you will get to know about the Master List in the Old Board Layout. If you want to configure the same in the New Board layout, see this Help page.

Master Lists are used to create a field, which will contain certain attributes related to this field. There are a few default Master Lists such as Class Of Service with values such as Expedite, Fixed Delivery Date, Standard Class, and Intangible Class.

You can create your own Master Lists with the list of values (LOVs) based on your needs. These fields and field attributes can be activated or deactivated based on your requirements.

Moreover, you can even map the relationship between two Master Lists by defining one as Parent and another as Child Master List. To know more about relationship mapping, jump to this section.

Note: You can also create Master List values for the Reason Code for Risk, Issue and Block flags at the board level. To know more click here.

Tips: We have an exciting in-app Learning Enabler, called Challenges that would help you learn and create a Master List interactively. Please navigate to Help & Support > Challenges from the top-level menu and try out the Challenges.

Creating a Master List

Navigate to Admin > Settings and click the Master Lists icon on the toolbar. The List of Master List page displays the existing Master Lists.

  1. Click the Create icon on the toolbar.
  2. In the New Master List page, enter the name of the new Master List.
  3. Click Save to save the new Master List.
  4. To add and update the attribute values to the Master List, see steps for Updating Master list.

You may make changes to the Master List such as change the name of the Master List, add or delete an attribute value, deactivate an attribute value, and change the name of the attribute value.

Updating the Master List

  1. In the List of Master List page, click the Master List that you want to modify.
  2. Double-click the required Master List. The Master List View displays two panes i.e. the Master List Details and LOV Details.

  1. To change the name of the Master List, edit the name and click the Save icon in the Master List Details pane. You cannot rename a system-created Master List, but can add new LOVs to it, and update the system-created LOVs.
  2. In the LOV Details section, you may make the following changes, and then click Save on its toolbar:
    • To add an attribute value to the field, click the Add icon on the LOV Details toolbar. A new Item row appears.
      • Double-click the Label cell and enter the label which you want to display for a field.
      • Double-click the Current Status to select Active to activate the attribute value.
      • Double-click the Icon text box and select an icon that best represents the attribute value. Click OK to Save.

  • To delete an attribute value, double-click the Current State value for the required attribute value. Click the Deleted value from the list and click OK. An asterisk before a value indicates that it is deactivated if already used on boards.
  • To modify an attribute value, double-click the label, make changes and click OK.

To add a child attribute value, click the Add Child ( ) icon by the side of the parent attribute value. A new Item row is displayed. Double click the label cell and type the label which you want to be displayed for a field. Double click the current status to select Active to activate the attribute value. Click Save to save the child attribute value.

In the following example, attribute value Technology has been appended with the child attribute values like Complex Technology, which has further child value Tech Not Supported in the Master List.

After you set the above hierarchy of LOVs in the Risk Codes Master List, you can then select that child attribute value as a Risk Code for a Kanban card. Once you save that Risk Code with your comment on that Kanban card, the child attribute value appears with a comment as a hover text on the highlighted Risk icon.

Note: Currently adding child attribute-value option is available for Risk Codes, Blocking Reason and Issue Code only. You can remove a child attribute value by clicking the Remove Child icon only before it is saved.

Mapping the Master List

You can map a relationship between two Master lists and apply it to a custom or custom common field. This can be extremely beneficial if you want to populate separate combinations of parent-child field values for a card, like Country-State, City- Localities and so on.

Note: You must have the Admin access to access to map such a relationship.

To create a relationship between two Master Lists, perform the following steps:

  1. Go to Admin > Card Settings > Master List. On the Master List page, click the Master List Mapping icon that would open the screen displayed below.

  1. Click Add Mapping icon the would open the Build Relationship screen.
  2. Enter a unique name and description (optional). For example, let’s consider we need to build a Country-City relationship.
  3. Select the Parent Master list from the available list of master lists and assign a child master list to build a Parent-Child relationship. For example, let the Parent Master list be Country and the Child Master list be City.
  4. Click Save to set the parent-child master list and the second section of your screen gets updated.
  5. The values of Parent Master list is generated in the first column of the table. In the second column, you have the option to link child values.

  1. To link child values to each parent value, click the Link child values icon.
  2. Select the child values from the available list that you want to link for the specific parent value and drag-n-drop the value in the empty box. For example, as shown in the following screen, all the parent master list values are listed in the first column. Now when you try to link the child values for the specific parent value India, all the city child values are listed from which specific city values of India can be drag-n-dropped in the empty box.

  1. Click Save and similarly set the child values for each parent value.

  1. Once the mapping gets created, apply the master list mapping in your card. To know more, refer to the Apply Master List Mapping section below.

Important Points to Remember

  • Master List Mapping option is not available if the Org-Sub Org license is enabled.
  • Parent and Child master List cannot be the same.
  • If any Master List is used in the Master List mapping, then it can not be deleted from the Master list page.
  • Once a Master List mapping is created, then the Parent or Child Master List cannot be updated.
  • Any value of a Child Master List can only be mapped to a single value of the Parent Master List.
  • Once a value of a Master List is deleted, then the same will not be available for the Relationship Mapping.
  • If you are de-selecting a value from the Child Value list in a Relationship Mapping, if that value has already been used in any card, then it will be pretended with a * mark. Moreover, this value will no more be available while adding or updating a card.
  • If a field has a parent field via the Relationship Mapping, then this field cannot be set Mandatory and no default
    value cannot be set for it.
  • The relationship can be mapped only between Common fields or in between Custom Common fields.
  • If you delete the parent field, then its association with the child field will also be removed.

Apply Master List Mapping

  1. Open the fields section of the card type on which you want to apply the Master List Mapping.
  2. Select or create field labels, which you want to set as Parent and child Master list.
    Note: The parent-child linking feature works only for fields having their Input method as a Static list.
  3. Next, set the parent master list on the Master List Name column for the field label that you want to consider as Parent.
  4. Click Save.
  5. Set the child master list on the Master List Name column for the field label that you want to consider as Child.
    For example, let’s set the Master List Name as Country for the field label Country, which will be the parent for the field label as City. Next, click Link hyperlink on Linked Field column of the child field label. In the Link Relationship window, the relationship name and the parent field are auto-populated. You can change it from the available lists.
    Relationship Name is available only when the Master List selected for this custom field is used as a Child Master List in any of the existing Relationships.
    Based on the selected Relationship Name, Parent Field will display all those fields assigned with the Master List, which is used as a Parent in the selected Relationship Name.
  6. Once the parent-child master list are mapped, you can validate it by navigating to your board and creating the card for which you have applied this mapping. For ease, refer the following GIF.


  • Was this helpful?
  • Yes   No