Skip to content
Workflows

Workflow Action - Update Opportunity

Learn how to use the Update Opportunity action in GHL Customer Care workflows to change pipeline stages, values, and more—based on contact activity or triggers.

6 min read1,322 words14 explained images
View as markdownOpen in ClaudeOpen in ChatGPT
Each image has a one line explanation. Switch to full detail for the step it belongs to, the fields and buttons involved, examples and the whole procedure.
On this page
  1. Key Benefits of the Update Opportunity Action
  2. How to Use the Update Opportunity Action
  3. Navigate to Workflow Builder
  4. Create or Use Existing Workflow
  5. Choose Workflow Trigger
  6. Add the Update Opportunity Action
  7. Name the Action Step
  8. Enable/Disable Backward Stage Movement
  9. Duplicate Opportunity Setting
  10. Add Fields to Update
  11. Pipeline Filter
  12. Pipeline Stage
  13. Status
  14. Opportunity Source
  15. Opportunity Value
  16. Save Action
  17. Frequently Asked Questions

This article explains how to use the Update Opportunity action in GHL Customer Care workflows. You’ll learn how to dynamically update opportunity records—including pipeline stages, opportunity names, and values—based on workflow logic or contact behavior.


TABLE OF CONTENTS


What is the Update Opportunity Action?

The Update Opportunity workflow action allows you to programmatically modify an existing opportunity in your CRM pipeline. You can change the name, value, pipeline, or stage of the opportunity based on dynamic inputs or other workflow actions like Find Opportunity.


Key Benefits of the Update Opportunity Action

Automatically modifying opportunity records within a workflow makes your sales process more efficient and tailored.

Here’s why this action is a valuable addition to your automation toolkit:

  • Automatically move deals to the correct pipeline stage based on triggers or contact activity
  • Customize opportunity names using merge fields for better context
  • Adjust opportunity values dynamically as lead engagement increases
  • Eliminate manual updates to pipeline stages or values
  • Maintain accurate CRM records during automated lead follow-up
  • Prevent backward movement in pipelines unless explicitly allowed


How to Use the Update Opportunity Action

Learn how to properly configure the Update Opportunity action and connect it to your workflow logic for consistent and reliable updates.

Start by going to the Automation section in the left-hand menu, then click on the Workflows tab at the top. This opens your Workflow List, where you can view, create, or manage existing automation workflows.

This is the central hub for building automations like the "Update Opportunity" action you'll set up shortly.

Navigate to Workflow Builder (image 1 of 14) What this shows This is the central hub for building automations like the "Update Opportunity" action you'll set up shortly. What this shows Illustrates the "Navigate to Workflow Builder" section of "Workflow Action - Update Opportunity". This screenshot appears in the "Navigate to Workflow Builder" section of "Workflow Action - Update Opportunity". The text alongside this image reads: This is the central hub for building automations like the "Update Opportunity" action you'll set up shortly. Immediately after, the guide continues: Click the + Create Workflow button in the top-right to start a new automation from scratch or a template. This is ideal if you’re building a new workflow specifically for updating opportunities. Image 1 of 14 What this coversThis is the central hub for building automations like the "Update Opportunity" action you'll set up shortly. Next stepClick the + Create Workflow button in the top-right to start a new automation from scratch or a template. This is ideal if you’re building a new workflow specifically for updating opportunities.

Create or Use Existing Workflow

Click the + Create Workflow button in the top-right to start a new automation from scratch or a template. This is ideal if you’re building a new workflow specifically for updating opportunities.

? Tip: If you already have a workflow set up (e.g., for lead follow-up), you can simply select it from the list instead of creating a new one. Then, add the Update Opportunity action into that existing workflow.

Create or Use Existing Workflow (image 2 of 14) What this shows ? What this shows Illustrates the "Create or Use Existing Workflow" section of "Workflow Action - Update Opportunity". This screenshot appears in the "Create or Use Existing Workflow" section of "Workflow Action - Update Opportunity". The text alongside this image reads:? Tip: If you already have a workflow set up (e.g., for lead follow-up), you can simply select it from the list instead of creating a new one. Then, add the Update Opportunity action into that existing workflow. Immediately after, the guide continues: Click Add New Trigger, then choose the appropriate trigger from the list. In this example, we have used "Opportunity Status Changed" trigger. This trigger activates the workflow whenever the status of an existing opportunity (deal) is…. Image 2 of 14 What to choose? Tip: If you already have a workflow set up (e.g., for lead follow-up), you can simply select it from the list instead of creating a new one. Then, add the Update Opportunity action into that existing workflow.
Buttons and menus referenced + Create Workflowselect it from the listUpdate Opportunity
Next stepClick Add New Trigger, then choose the appropriate trigger from the list. In this example, we have used "Opportunity Status Changed" trigger. This trigger activates the workflow whenever the status of an existing opportunity (deal) is updated.

Choose Workflow Trigger

Click Add New Trigger, then choose the appropriate trigger from the list. In this example, we have used "Opportunity Status Changed" trigger. This trigger activates the workflow whenever the status of an existing opportunity (deal) is updated.

Why this trigger?
We’re using this as an example because it ensures the workflow starts with an opportunity already in context—making it directly compatible with the Update Opportunity action. Since the opportunity that triggered the workflow is known, no extra lookup is required.
Tip: You’re not limited to this trigger. You can use any trigger of your choice, such as a tag being added or a form being submitted. Just remember: if your trigger isn’t opportunity-based, you’ll need to add a Find Opportunity step early in the workflow to locate the correct deal to update.
Choose Workflow Trigger (image 3 of 14) What this shows Tip: You’re not limited to this trigger. What this shows Illustrates the "Choose Workflow Trigger" section of "Workflow Action - Update Opportunity". This screenshot appears in the "Choose Workflow Trigger" section of "Workflow Action - Update Opportunity". The text alongside this image reads: Tip: You’re not limited to this trigger. You can use any trigger of your choice, such as a tag being added or a form being submitted. Just remember: if your trigger isn’t opportunity-based, you’ll need to add a Find Opportunity step early in the workflow to locate the correct deal to update. Immediately after, the guide continues: After selecting your trigger, click the + icon under it and search for or scroll to Update Opportunity in the Opportunity section of the Actions list. Image 3 of 14 What this coversTip: You’re not limited to this trigger. You can use any trigger of your choice, such as a tag being added or a form being submitted. Just remember: if your trigger isn’t opportunity-based, you’ll need to add a Find Opportunity step early in the workflow to locate the correct deal to update.
Buttons and menus referenced Add New TriggerUpdate Opportunityany trigger of your choiceFind Opportunity
Next stepAfter selecting your trigger, click the + icon under it and search for or scroll to Update Opportunity in the Opportunity section of the Actions list.

Add the Update Opportunity Action

After selecting your trigger, click the + icon under it and search for or scroll to Update Opportunity in the Opportunity section of the Actions list.

This action allows you to automatically change key details—like pipeline, stage, value, or name—of the opportunity that triggered the workflow (or the one found by a Find Opportunity step).

Add the Update Opportunity Action (image 4 of 14) What this shows This action allows you to automatically change key details—like pipeline, stage, value, or name—of the opportunity that triggered the… What this shows Illustrates the "Add the Update Opportunity Action" section of "Workflow Action - Update Opportunity". This screenshot appears in the "Add the Update Opportunity Action" section of "Workflow Action - Update Opportunity". The text alongside this image reads: This action allows you to automatically change key details—like pipeline, stage, value, or name—of the opportunity that triggered the workflow (or the one found by a Find Opportunity step). Immediately after, the guide continues: In the Action Name field, enter a label that clearly describes what this action is doing (e.g., “Move to Proposal Stage” or “Update Deal Info”). Image 4 of 14 What this coversThis action allows you to automatically change key details—like pipeline, stage, value, or name—of the opportunity that triggered the workflow (or the one found by a Find Opportunity step).
Buttons and menus referenced + iconUpdate Opportunity
Next stepIn the Action Name field, enter a label that clearly describes what this action is doing (e.g., “Move to Proposal Stage” or “Update Deal Info”).

Name the Action Step

In the Action Name field, enter a label that clearly describes what this action is doing (e.g., “Move to Proposal Stage” or “Update Deal Info”).

This name appears in the workflow builder and helps you stay organized—especially in workflows with multiple steps. It’s just for internal use and won’t be visible to contacts.

Name the Action Step (image 5 of 14) What this shows This name appears in the workflow builder and helps you stay organized—especially in workflows with multiple steps. What this shows Illustrates the "Name the Action Step" section of "Workflow Action - Update Opportunity". This screenshot appears in the "Name the Action Step" section of "Workflow Action - Update Opportunity". The text alongside this image reads: This name appears in the workflow builder and helps you stay organized—especially in workflows with multiple steps. It’s just for internal use and won’t be visible to contacts. Immediately after, the guide continues: Toggle Allow Opportunity to Move to Any Previous Stage to ON if you want to move the opportunity to an earlier stage in the pipeline. Image 5 of 14 What this coversThis name appears in the workflow builder and helps you stay organized—especially in workflows with multiple steps. It’s just for internal use and won’t be visible to contacts.
Buttons and menus referenced Action Name
Next stepToggle Allow Opportunity to Move to Any Previous Stage to ON if you want to move the opportunity to an earlier stage in the pipeline.

Enable/Disable Backward Stage Movement

Toggle Allow Opportunity to Move to Any Previous Stage to ON if you want to move the opportunity to an earlier stage in the pipeline.

By default, opportunities can only move forward or remain in the same stage. Enabling this option gives you more flexibility—especially when reverting deals that were prematurely advanced.

Enable/Disable Backward Stage Movement (image 6 of 14) What this shows By default, opportunities can only move forward or remain in the same stage. What this shows Illustrates the "Enable/Disable Backward Stage Movement" section of "Workflow Action - Update Opportunity". This screenshot appears in the "Enable/Disable Backward Stage Movement" section of "Workflow Action - Update Opportunity". The text alongside this image reads: By default, opportunities can only move forward or remain in the same stage. Enabling this option gives you more flexibility—especially when reverting deals that were prematurely advanced. Immediately after, the guide continues: You’ll notice a Duplicate Opportunity toggle inside the Update Opportunity action—but here’s the key: it doesn’t actually create a new opportunity. This action only updates an existing one, so even if this toggle is enabled, nothing new…. Image 6 of 14 What this coversBy default, opportunities can only move forward or remain in the same stage. Enabling this option gives you more flexibility—especially when reverting deals that were prematurely advanced. Next stepYou’ll notice a Duplicate Opportunity toggle inside the Update Opportunity action—but here’s the key: it doesn’t actually create a new opportunity. This action only updates an existing one, so even if this toggle is enabled, nothing new will be created.

Duplicate Opportunity Setting

You’ll notice a Duplicate Opportunity toggle inside the Update Opportunity action—but here’s the key: it doesn’t actually create a new opportunity. This action only updates an existing one, so even if this toggle is enabled, nothing new will be created.

When you click the preview icon next to the toggle, you’ll be taken to Settings > Business Profile, where you’ll see a prompt to manage duplicate opportunity rules. Clicking “Go to Opportunity Settings” brings you to the configuration screen where you can turn on “Allow Multiple Opportunities per Contact.” This setting is useful if the same contact might move through the pipeline more than once—like for renewals or repeat purchases. Just keep in mind: this setting doesn’t affect the behavior of the Update Opportunity action itself—it never creates duplicates.

Duplicate Opportunity Setting (image 7 of 14) What this shows When you click the preview icon next to the toggle, you’ll be taken to Settings > Business Profile, where you’ll see a prompt to manage… What this shows Illustrates the "Duplicate Opportunity Setting" section of "Workflow Action - Update Opportunity". This animation appears in the "Duplicate Opportunity Setting" section of "Workflow Action - Update Opportunity". The text alongside this image reads: When you click the preview icon next to the toggle, you’ll be taken to Settings > Business Profile, where you’ll see a prompt to manage duplicate opportunity rules. Clicking “Go to Opportunity Settings” brings you to the configuration screen where you can turn on “Allow Multiple Opportunities per…. The navigation path used here is Settings > Business Profile. Immediately after, the guide continues: Click the Add field button to choose which opportunity details you want to modify. You can update fields like pipeline, stage, name, value, and more. Path: Settings > Business ProfileImage 7 of 14 What to chooseWhen you click the preview icon next to the toggle, you’ll be taken to Settings > Business Profile, where you’ll see a prompt to manage duplicate opportunity rules. Clicking “Go to Opportunity Settings” brings you to the configuration screen where you can turn on “Allow Multiple Opportunities per Contact.” This setting is useful if the same contact might move through the pipeline more than once—like for renewals or repeat purchases. Just keep in mind: this setting doesn’t affect the behavior of the Update Opportunity action itself—it never creates duplicates.
Buttons and menus referenced Duplicate OpportunitySettings > Business Profile“Go to Opportunity Settings”
Next stepClick the Add field button to choose which opportunity details you want to modify. You can update fields like pipeline, stage, name, value, and more.

Add Fields to Update

Click the Add field button to choose which opportunity details you want to modify. You can update fields like pipeline, stage, name, value, and more.

This is where you define exactly what changes the Update Opportunity action will apply. You can also use dynamic merge fields here to personalize values based on contact data.

Add Fields to Update (image 8 of 14) What this shows This is where you define exactly what changes the Update Opportunity action will apply. What this shows Illustrates the "Add Fields to Update" section of "Workflow Action - Update Opportunity". This screenshot appears in the "Add Fields to Update" section of "Workflow Action - Update Opportunity". The text alongside this image reads: This is where you define exactly what changes the Update Opportunity action will apply. You can also use dynamic merge fields here to personalize values based on contact data. Immediately after, the guide continues: Select the pipeline you want the opportunity to move into. This is helpful when shifting a deal into a different process—like routing renewals or upsells to a dedicated pipeline. Image 8 of 14 What this coversThis is where you define exactly what changes the Update Opportunity action will apply. You can also use dynamic merge fields here to personalize values based on contact data.
Buttons and menus referenced Add field
Next stepSelect the pipeline you want the opportunity to move into. This is helpful when shifting a deal into a different process—like routing renewals or upsells to a dedicated pipeline.

Pipeline Filter

Select the pipeline you want the opportunity to move into. This is helpful when shifting a deal into a different process—like routing renewals or upsells to a dedicated pipeline.

Updating this field helps reorganize your sales flow dynamically without manual pipeline changes.

Pipeline Filter (image 9 of 14) What this shows Updating this field helps reorganize your sales flow dynamically without manual pipeline changes. What this shows Illustrates the "Pipeline Filter" section of "Workflow Action - Update Opportunity". This screenshot appears in the "Pipeline Filter" section of "Workflow Action - Update Opportunity". The text alongside this image reads: Updating this field helps reorganize your sales flow dynamically without manual pipeline changes. Immediately after, the guide continues: Choose the stage within the selected pipeline where you want the opportunity to go. This helps move deals forward—or even backward if you’ve enabled that option—to reflect their current progress in your sales cycle. Image 9 of 14 What this coversUpdating this field helps reorganize your sales flow dynamically without manual pipeline changes. Next stepChoose the stage within the selected pipeline where you want the opportunity to go. This helps move deals forward—or even backward if you’ve enabled that option—to reflect their current progress in your sales cycle.

Pipeline Stage

Choose the stage within the selected pipeline where you want the opportunity to go. This helps move deals forward—or even backward if you’ve enabled that option—to reflect their current progress in your sales cycle.

Pipeline Stage (image 10 of 14) What this shows Choose the stage within the selected pipeline where you want the opportunity to go. What this shows Illustrates the "Pipeline Stage" section of "Workflow Action - Update Opportunity". This screenshot appears in the "Pipeline Stage" section of "Workflow Action - Update Opportunity". The text alongside this image reads: Choose the stage within the selected pipeline where you want the opportunity to go. This helps move deals forward—or even backward if you’ve enabled that option—to reflect their current progress in your sales cycle. Immediately after, the guide continues: Set the opportunity’s current status—like Open, Won, or Lost. Updating this field helps you keep the deal’s progress aligned with real-time changes, which is especially helpful when triggering or advancing workflows. Image 10 of 14 What to chooseChoose the stage within the selected pipeline where you want the opportunity to go. This helps move deals forward—or even backward if you’ve enabled that option—to reflect their current progress in your sales cycle. Next stepSet the opportunity’s current status—like Open, Won, or Lost. Updating this field helps you keep the deal’s progress aligned with real-time changes, which is especially helpful when triggering or advancing workflows.

Status

Set the opportunity’s current status—like Open, Won, or Lost. Updating this field helps you keep the deal’s progress aligned with real-time changes, which is especially helpful when triggering or advancing workflows.

Status (image 11 of 14) What this shows Set the opportunity’s current status—like Open, Won, or Lost. What this shows Illustrates the "Status" section of "Workflow Action - Update Opportunity". This screenshot appears in the "Status" section of "Workflow Action - Update Opportunity". The text alongside this image reads: Set the opportunity’s current status—like Open, Won, or Lost. Updating this field helps you keep the deal’s progress aligned with real-time changes, which is especially helpful when triggering or advancing workflows. Immediately after, the guide continues: Use this field to update or track where the opportunity came from—like a lead form, ad campaign, or specific landing page. Image 11 of 14 What this coversSet the opportunity’s current status—like Open, Won, or Lost. Updating this field helps you keep the deal’s progress aligned with real-time changes, which is especially helpful when triggering or advancing workflows.
Buttons and menus referenced OpenWonLost
Next stepUse this field to update or track where the opportunity came from—like a lead form, ad campaign, or specific landing page.

Opportunity Source

Use this field to update or track where the opportunity came from—like a lead form, ad campaign, or specific landing page.

You can set this manually or use a custom value like {{contact.source}} to pull dynamic data from the contact record. Just click the tag icon next to the input field to browse and insert custom values. This is especially helpful for keeping source data accurate when contacts enter your pipeline from different channels.

Opportunity Source (image 12 of 14) What this shows You can set this manually or use a custom value like {{contact.source}} to pull dynamic data from the contact record. What this shows Illustrates the "Opportunity Source" section of "Workflow Action - Update Opportunity". This screenshot appears in the "Opportunity Source" section of "Workflow Action - Update Opportunity". The text alongside this image reads: You can set this manually or use a custom value like {{contact.source}} to pull dynamic data from the contact record. Just click the tag icon next to the input field to browse and insert custom values. This is especially helpful for keeping source data accurate when contacts enter your pipeline…. Immediately after, the guide continues: This field lets you assign or update the monetary value of a deal in your pipeline. You can enter a fixed amount (like 500) or use a custom value based on the contact record or other workflow logic (for example, {{contact.quoted_price}}). Image 12 of 14 What to fill inYou can set this manually or use a custom value like {{contact.source}} to pull dynamic data from the contact record. Just click the tag icon next to the input field to browse and insert custom values. This is especially helpful for keeping source data accurate when contacts enter your pipeline from different channels.
Buttons and menus referenced custom valuetag icon
Next stepThis field lets you assign or update the monetary value of a deal in your pipeline. You can enter a fixed amount (like 500) or use a custom value based on the contact record or other workflow logic (for example, {{contact.quoted_price}}).

Opportunity Value

This field lets you assign or update the monetary value of a deal in your pipeline. You can enter a fixed amount (like 500) or use a custom value based on the contact record or other workflow logic (for example, {{contact.quoted_price}}).

Use this to track potential revenue more accurately and automate pipeline forecasting based on where the opportunity is in the sales cycle.

Opportunity Value (image 13 of 14) What this shows Use this to track potential revenue more accurately and automate pipeline forecasting based on where the opportunity is in the sales cycle. What this shows Illustrates the "Opportunity Value" section of "Workflow Action - Update Opportunity". This screenshot appears in the "Opportunity Value" section of "Workflow Action - Update Opportunity". The text alongside this image reads: Use this to track potential revenue more accurately and automate pipeline forecasting based on where the opportunity is in the sales cycle. Immediately after, the guide continues: Once you’ve filled in all the opportunity fields you want to update—like pipeline, stage, status, and more—just click Save Action to lock it in. This tells the workflow to apply your updates when the trigger conditions are met. Image 13 of 14 What this coversUse this to track potential revenue more accurately and automate pipeline forecasting based on where the opportunity is in the sales cycle.
Buttons and menus referenced custom value
Next stepOnce you’ve filled in all the opportunity fields you want to update—like pipeline, stage, status, and more—just click Save Action to lock it in. This tells the workflow to apply your updates when the trigger conditions are met.

Save Action

Once you’ve filled in all the opportunity fields you want to update—like pipeline, stage, status, and more—just click Save Action to lock it in. This tells the workflow to apply your updates when the trigger conditions are met.

Save Action (image 14 of 14) What this shows Once you’ve filled in all the opportunity fields you want to update—like pipeline, stage, status, and more—just click Save Action to lock it in. What this shows Illustrates the "Save Action" section of "Workflow Action - Update Opportunity". This screenshot appears in the "Save Action" section of "Workflow Action - Update Opportunity". The text alongside this image reads: Once you’ve filled in all the opportunity fields you want to update—like pipeline, stage, status, and more—just click Save Action to lock it in. This tells the workflow to apply your updates when the trigger conditions are met. Immediately after, the guide continues: Q: What happens if no opportunity exists in the workflow? Image 14 of 14 How to confirmOnce you’ve filled in all the opportunity fields you want to update—like pipeline, stage, status, and more—just click Save Action to lock it in. This tells the workflow to apply your updates when the trigger conditions are met.
Buttons and menus referenced Save Action
Next stepQ: What happens if no opportunity exists in the workflow?

Frequently Asked Questions

Q: What happens if no opportunity exists in the workflow?

The action is skipped. Ensure your workflow is triggered by or includes a Find Opportunity step.

Q: Can I move an opportunity backward in the pipeline?

Yes, but only if the “Allow Opportunity to Move to Any Previous Stage” toggle is enabled.

Q: What if I use a Create Opportunity action earlier in the workflow — will that opportunity be updated?

No. Creating an opportunity earlier in the workflow does not automatically provide context for the Update Opportunity step. To update an opportunity later in the workflow, you need to either use a Find Opportunity action to locate the specific record or pass the correct reference through custom values when creating the opportunity. This ensures the update targets the right record with the appropriate context.

Q: Can I update the owner of the opportunity?

Not with this action. Use the Assign User or Update Contact action to modify ownership.

Was this guide helpful?

Related guides