How to Сustomize SugarCRM Dropdown List Values

How to Сustomize SugarCRM Dropdown List ValuesAuthor: Pavel Chumachenko, Software Engineer

In keeping with the topic of SugarCRM customization, let us consider a fairly common situation: sometimes while working within SugarCRM, the latter appears to miss the simple mechanisms of standard option of displaying/hiding fields. It also lacks those mechanisms that could make the needed field non-editable, i.e. disabled, guided by the meaningful specifics of business processes. And here it is important to note that the certain rules, essential for the correct run of business processes, can require disabling only certain values within the dropdown list.

In this tutorial, we’ll consider how to customize SugarCRM to make certain values within the dropdown list not available. Going forward, the procedure will be illustrated by the particular example.

By the way, you can find more examples of SugarCRM customization in our video tutorials library. Various useful enhancements, solutions to the most important tasks are available here:

Coming down to essentials

Firstly, let us assume that there is a record attribute called “Segmentation” within “Accounts” module. This attribute can take the following values:

  • А
  • А+
  • В
  • B+
  • C

Basically, this attribute is calculated automatically by the system, but if it equals “A” or “A+”, then a user can change it from “A” to “A+” or vice versa. In other words, if the value of the field “Segmentation” is set to “A” or “A+” – then there is the dropdown list, where the values “A” and “A+” are available, but “B”, “B+” and “C” are not available, i.e. blocked, but at the same time they should be in this very dropdown list (see figure 1).

How to Сustomize SugarCRM Dropdown List Values

Figure 1. The result of the generation of the customized dropdown list of “Segmentation” field

Unveiling the secrets

In fact, the principle of operation of SugarCRM dropdown list is described in its controller. As it is known, all dropdown lists are of type “enum”. Accordingly, we need to find the controller that is in charge right of this very field type, and override it. Usually, it is placed here:

It should be noted that before overriding you should select the controller scope. We recommend to review this case for a specific module in which there is a dropdown list under discussion. If the same field with the same name is used in several modules (e.g., “Accounts”, “Countries”), it makes sense to override this controller globally.

And so, for global case you should create the following file in the appropriate directory:

Meantime, for local case you should do the following:

where <MODULE>  is the name of the needed module.

In the new file, first of all we point out that we inherit from class “EnumField”, and call the parent initialization method.

Thus, the code is the following:

Thereafter, you should override the method _query(), which will be extended by the additional logic. Here, while processing of each element we should look at the name of the dropdown list. If the needed field is currently being processed, then we should add the characteristics “disabled” to the resulting object. Right this characteristic is responsible for enabling/disabling the option of selection the specific dropdown list value. The value for this attribute is calculated by the method setListItemActive(), which is described below.

Here we have got the following code:

It’s high time to describe the method that will determine whether to disable the specific dropdown list value or not. Let’s name this method “setListItemActive()” within the current implementation case. This method returns the values “TRUE” or “FALSE”. The work of this method is based on the ordinary operator “switch” and it is completely defined by the conditions of our case.

Here the code is the following:

After all the performed actions we should set permissions to the created file/directory and run “Quick Repair and Rebuild”. Done!


In this tutorial, we’ve uncovered how to customize SugarCRM standard mechanism of generation of dropdown list that allows to set additional restrictions to the availability of the values within the dropdown list. The process is quite straight-line and is generally determined by the correct defining of the conditions of enabling/disabling the values of a particular dropdown list.

Good luck! If you need our advice on how to customize SugarCRM to make it more powerful and versatile, we are always ready to help!

Leave your details and we’ll get right back to you
First Name

Last Name



I have read the Integros privacy policy and consent to the processing of my personal data.

Other SugarCRM customization tutorials:

Leave a Reply

Your email address will not be published. Required fields are marked *