Feature Availability
Vtiger Editions: One Growth | One Pilot | One Professional | One Enterprise | One AI
Introduction
The Update Fields workflow action is used to update the fields in a record when the entry criteria are met. For a workflow to execute actions, it must be active and triggered, and the entry criteria must be met. To learn about these workflow components, click here.
Destination and Source Fields
The Destination field is the field that must be updated. The Source field is the field that must be used to update the destination field.
Different types of Source fields
The following types of Source fields are available when you are adding a function:
- Raw text: You must manually enter the value that the destination field must take.
- Field: When you select this option, you choose a field from which the value must be copied to the destination field.
- Expression: This option lets you use fields to form an arithmetic expression, the value of which will be updated in the destination field. You can also use ready-made functions from the Use Functions drop-down.
Example Let us take the example of calculating the weighted revenue of a deal from the deal amount.
Weighted Revenue = Amount * Probability / 100
This workflow calculates and updates the weighted revenue of a deal every time the deal amount is updated and saved. To learn more about deals, click here.
Note: There is already a default workflow available with the name Calculate or Update Weighted Revenue to perform the action explained in the example.
In this article, you will learn about:
- Setting up Update Field action
Key Terminology
| Field Name | Description |
| Workflow | A workflow is a sequence of automated actions that run when specific conditions are met. |
| Workflow Components | Workflow components are the essential parts that make up a workflow and define how a process operates from start to finish. |
| Workflow Trigger | A workflow trigger is an event or condition that starts a workflow. |
Setting up the Update Fields Action
Follow these steps to set up a Workflow with the Update Fields action:
- Log in to the CRM.
- Click the User Menu in the top right corner of the screen.
- Click Settings. The Settings page opens.
- Look for the Automation section.
- Select Workflows.

- Click the +New Workflow button.
- Select Standard. The Standard page opens.
- Enter or select the following information:
- Basic Information section
- Workflow Name: Enter a name for the workflow, such as Calculate Weighted Revenue.
- Target Module: Select Deals as the module on which the workflow must execute.
- Status: Set the workflow status to Active. The workflow will not execute when the status is set to Inactive.
- Description: Enter a brief description of the workflow, such as Calculates and updates the weighted revenue based on the Deal Amount and Probability.
- Workflow trigger section
- Workflow Trigger: Select this Workflow Trigger - Deal updated (Includes Creation).
- Recurrence: Choose this condition - Every time conditions are met.
- Note: No specific entry criterion is required in this workflow.

- Action: Set up the action.
- Click the Add Action drop-down.
- Select Update Fields.
- Action Title - Enter a title.
- Click the +Add Record Field button.
- Set the field values: Choose the destination and source fields.
- The Destination field is the field that must be updated.
- The Source field is the field that must be used to update the destination field.
- Select Field (for the Destination field): Choose Weighted Revenue as the destination field.
- Source Field: Click inside the space provided on the right side. This opens a pop-up window. Enter the source field here.
- Note: After selecting the function, you must enter field names in the function placeholders from the Use Field drop-down. For example, contact (first name, last name) is a function that connects the first and last names.
- Select Expression from the drop-down. This allows you to enter the expression to calculate the weighted revenue.
- Click on the Use Field drop-down and select Amount and Probability. This drop-down allows you to select fields from the CRM records to use them in calculations.
- Form this expression using the symbols on your keyboard: Amount * Probability / 100.
- Click Save to save the expression. This closes the pop-up window.
- Click Save to save the workflow action.
- Click Save to save the workflow.
Note: When the destination fields are updated with the source field values via workflows or
approvals, the CRM account owner’s preferences are applied. The preferences are set up under
My Preferences and
Calendar Settings.
Consider this example: If a deal’s Description field (destination) is updated with the deal’s Expected Close Date (source) via a workflow, then the date format in the Description field takes the CRM account owner’s format.
Copying Co-owner Field from Parent to Child Module
- You can copy the Co-Owner field value from the parent module to a child module.
- You can select a parent record's co-owner field when you are creating a workflow with an update field task and setting values for the co-owner field.
This benefits you in the following ways:
- Automatically copying the Co-owner field keeps parent and child records consistent and reduces manual work and errors.
- Improved Collaboration: Aligning the Co-owner field across related records ensures clear shared ownership and accountability.
- Flexibility in Automation: Having the option to select extra values or use the parent record's Co-owner field makes it easier to handle different customer needs.
Note: You can compute different values under Expression using the readily available functions in Vtiger. To learn more about them,
click here.
References