Loading

Lookup field in flow throws error: 'An unhandled fault has occurred in this flow'

Publish Date: Jun 3, 2026
Description

You can link Contracts and Orders with Opportunities using the following standard lookup fields:

  • Contract on Opportunity
  • Contract on Quote
  • Opportunity on Order
  • Quote on Order
  • Quote Line Item on Order Product

When Salesforce introduced these standard lookup fields, the default Field Level Security (FLS) for these fields was set to Hidden. Because Salesforce Flows respect Field Level Security, attempting to access a hidden field in a Flow causes an unhandled fault error. You may encounter this error when creating an Order or Contract that references these fields in a Flow:

An unhandled fault has occurred in this flow. An unhandled fault has occurred while processing the flow. Please contact your system administrator for more information.
Resolution

How to Fix: Adjust Field Level Security for Lookup Fields

To resolve this error, update the Field Level Security (FLS) for the affected lookup field to Visible for the relevant Profile or Permission Set. This allows the Flow to access the field value during execution.

Steps in Lightning Experience

  1. Go to Setup.
  2. In the Quick Find box, type Field Accessibility.
  3. Select the Object that contains the lookup field.
  4. Select the Field.
  5. Change Field Level Security to Visible for the affected Profile.

Steps in Salesforce Classic

  1. Go to Setup.
  2. Navigate to Security Controls > Field Accessibility.
  3. Locate the Object and the Field.
  4. Set Field Level Security to Visible for the affected Profile.

For more information on handling Flow errors, see Customize What Happens When a Flow Fails.

Knowledge Article Number

000386529

 
Loading
Salesforce Help | Article