--- schema_version: "1" id: 9512346ca6d533ef6020673ab6e57a9075c78c2185aa74df1efbc7c6accc58d1 title: Update Salesforce Records from a Flow collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/flow_build_data_update.md canonical_url: https://help.salesforce.com/s/articleView?id=platform.flow_build_data_update.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: 7d111c5e731b33088f3e000a06768a8165b2d075d6f4a5469f05d8260ea95675 description: To update field values on existing Salesforce records, use either the Update Records element or a Quick Action core action. The right element depends on what the rest of your flow is doing. products: - Flow Builder - Salesforce Platform release: "264" --- # Update Salesforce Records from a Flow To update field values on existing Salesforce records, use either the Update Records element or a Quick Action core action. The right element depends on what the rest of your flow is doing. ### Required Editions

On an opportunity record, when a user clicks the “Won” button, a flow updates the opportunity’s stage. To update fields on one or more existing Salesforce records, your flow: - Identifies the records to update. - Identifies the new field values for those records. - Saves those changes to the Salesforce database. (In other words, until the changes are saved to the database, the changes exist only within the flow.) How do I choose between flow elements that update records? The main difference between the elements is how it knows which records to update, how it knows the new field values to apply, and how many records it can update. Quick Action elements can update only one record at a time, while Update Records elements can update multiple records.

	To identify records to update	To identify new field values for the records	Number of records it updates
Update Records, where you chose to specify conditions and set fields individually	In the same element, use filter criteria.	In the same element, map each field to be updated with a variable or other resource. All resources are supported, so long as the resource’s data type matches the selected field’s data type.	At least one.
Update Records, where you chose to use the IDs and field values from a record variable or record collection variable	Populate a record variable or record collection variable in another element.	In another element, such as an Assignment element, update the values in the record variable or record collection variable.	If a record variable: one. If a record collection variable: at least one.
Quick Action	Populate a single-value variable with the ID in another element. Use this ID for the Related Record ID parameter.	In the same element, map each field to be updated with a variable or other resource. All resources are supported, so long as the resource’s data type matches the selected field’s data type.	Exactly one.

To identify records to update

To identify new field values for the records

Number of records it updates

Update Records, where you chose to specify conditions and set fields individually

In the same element, use filter criteria.

In the same element, map each field to be updated with a variable or other resource.

All resources are supported, so long as the resource’s data type matches the selected field’s data type.

At least one.

Update Records, where you chose to use the IDs and field values from a record variable or record collection variable

Populate a record variable or record collection variable in another element.

In another element, such as an Assignment element, update the values in the record variable or record collection variable.

If a record variable: one.

If a record collection variable: at least one.

Quick Action

Populate a single-value variable with the ID in another element. Use this ID for the Related Record ID parameter.

In the same element, map each field to be updated with a variable or other resource.

All resources are supported, so long as the resource’s data type matches the selected field’s data type.

Exactly one.

If all the following statements are true, use a Quick Action element. - Update exactly one record - You’ve already populated a variable with the record’s ID - The Quick Action’s layout includes all the fields to update If any of those statements aren’t true, use an Update Records element. Here’s how you’d update an opportunity’s stage by using each of the update elements. Update Records, where you chose to specify conditions and set fields individually ![How you identify which records to update and what the new field values should be in a Update Records element](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/platform_automation/images/flow/flow_recordupdate.png) Update Records, where you chose to use the IDs and field values from a record variable or record collection variable ![How you identify which records to update and what the new field values should be in a Update Records element](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/platform_automation/images/flow/flow_fastupdate.png) Assumes {!varOpportunity} is already populated with the right fields. Quick Action (of type Update)

How you identify which records to update and what the new field values should be in a Quick Action (Update) element

Two fields are required by the associated action layout, so they’re required in this element. Related Record ID identifies which opportunity to update.

This video explains when to use fast field (before-save) updates and when to update actions and related records. View this [video](https://play.vidyard.com/xxvrx6bZu6rSVwUYLdbANB?) in a separate tab.