Add value to a multiple-value field
The "Add value to a multiple-value field" robot appends a new value to a multiple-value CRM field (deal, contact, company, or lead) in Bitrix24 (Alaio) business processes and robots without overwriting the existing values. Duplicates are skipped by default. It returns a Success Y/N flag and the resulting number of elements in the field.
The robot adds a single value to a multiple-value CRM field while keeping all previously entered values — unlike a plain field update, which overwrites the whole list. The input is the entity type (deal, contact, company, or lead), its ID, the field code (e.g. UF_CRM_TAGS or PHONE), and the value to add; the Skip if already present flag (default Y) prevents duplicates. Typical use cases: append a tag to a deal when an event occurs; add an extra phone to a contact without losing the main one; accumulate values in a custom multiple-value field as the process runs. If the entity is not found or the parameters are invalid, Success = N is returned. It returns Success Y/N and the resulting number of elements in the field — use them in the next steps of the business process.
What input parameters does the robot accept?
| Parameter | Type | Required? | Default |
|---|---|---|---|
| Entity type: deal / contact / company / lead | string | yes | |
| Entity ID | int | yes | |
| Field code (e.g. UF_CRM_TAGS or PHONE) | string | yes | |
| Value to add | string | yes | |
| Skip if already present (Y/N, default Y) | string | — |
What does the robot return?
| Parameter | Type |
|---|---|
| Success (Y/N) | string |
| Resulting number of elements in the field | int |
Scenario: tag a deal on payment
- A deal enters the Paid stage
- The robot adds the value paid to the deal tag multiple-value field
- When Success = Y the process continues and the resulting element count is used downstream