Remove value from a multiple-value field
The "Remove value from a multiple-value field" robot removes a specific value from a multiple-value CRM field (deal, contact, company, or lead) in Bitrix24 business processes and robots while preserving the other values. All matching occurrences are removed. It returns a Success Y/N flag, the number of occurrences removed, and the resulting number of elements in the field.
The robot cuts a given value out of a multiple-value CRM field and leaves all other values untouched — it is a targeted removal, not a rewrite of the whole list. The input is the entity type (deal, contact, company, or lead), its ID, the field code, and the value to remove; matching occurrences are taken out and the rest are kept. Typical use cases: drop a temporary tag from a deal on a stage change; remove an outdated address from a contact multiple-value field; clear a specific label from a list as the process runs. If the entity is not found or the parameters are invalid, Success = N is returned. It returns Success Y/N, the number of occurrences removed, 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 | string | yes | |
| Value to remove | string | yes |
What does the robot return?
| Parameter | Type |
|---|---|
| Success (Y/N) | string |
| Number of occurrences removed | int |
| Resulting number of elements in the field | int |
Scenario: drop the new tag on first contact
- A deal enters the In progress stage
- The robot removes the value new from the deal tag multiple-value field
- When Success = Y the process continues and the number of occurrences removed is used downstream