Wait For Condition activity

  • Release version: Yokohama
  • Updated January 30, 2025
  • 2 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Wait For Condition activity

    The Wait For Condition activity in ServiceNow playbooks allows you to pause the playbook execution until a specified record meets defined field value conditions. This helps ensure that subsequent playbook actions only proceed when required data states are achieved, providing controlled and conditional workflow progression.

    Show full answer Show less

    Key Features

    • Role Access: Available as a common activity for users with admin, playbook.admin, or pdauthor roles.
    • Configurable Inputs:
      • Label and Description: Set titles and informational text for the activity display.
      • Run Condition: Use a condition builder to define criteria that must be met to run the activity or stage, leveraging data from prior activities.
      • Start Rule: Choose when the activity or stage starts—immediately when the process or stage starts, or after specific stages or activities complete.
      • Start with Delay: Optionally delay the start of the activity or stage by a specified duration.
      • Record Reference and Table: Specify the record and table to monitor for condition matching.
      • Conditions Template: Define the exact field value criteria that the record must satisfy to continue the playbook.
    • Advanced Inputs:
      • Enable Timeout: Optionally configure a timeout period after which the activity will skip if conditions are not met.
      • Duration and Schedule: Set how long to wait before timeout and which schedule to use for duration calculation.

    Key Outcomes

    • Playbooks can intelligently wait for real-time record state changes before proceeding, ensuring accurate and conditional workflow execution.
    • Timeout settings allow for graceful handling if conditions are not met, preventing indefinite waits.
    • Flexible scheduling and start rules enable precise control over when the waiting activity begins.

    Pause the playbook until a record has field values that match a set of conditions.

    Roles and availability

    • This activity is available as a common activity. Users with the admin, playbook.admin, or pd_author can add this activity to a playbook.

    Inputs

    Open the activity properties panel and configure your activity to add values for the following inputs. If the input value varies, use the pill-picker to show where to get the value. To learn more about the pill-picker, see Dot-walking examples.
    Input Type Description
    Label String Title to display as activity and playbook card.
    Description String Information to display about activity usage or outcome.
    Run condition Condition Builder Conditions that must be met to run an activity or stage. You can use data from prior activities to build conditions.
    Note:
    Show additional options to see this field.
    Start Rule Choice Under Schedule > Start Rule, select a start rule for when your stage should start running:
    • When process starts: Your stage starts running as soon as the playbook starts.
    • After specific stages: Your stage starts running after specified stage(s) have finished running.
    Under Schedule > Start Rule, select a start rule for when your activity should start running:
    • When stage starts: Your activity starts running as soon as its stage starts running. Your stage starts running when your playbook is triggered.
    • After specific activities: Your activity starts running after specified activities have finished running.
    Start with delay True/False Option to wait for a duration of time before running an activity or stage. When enabled, this input displays the Start with delay input properties.
    Note:
    Show additional options to see this field.
    Record Reference Reference to the record that pauses the playbook until conditions match.
    Table Table Name Table containing the record to update.
    Conditions Template Value Criteria that a record must meet for the playbook to continue.

    Advanced inputs

    After configuring the required inputs for your activity, you can also choose to configure additional inputs. In the side panel, select Show additional options to display these advanced inputs. For more information, see Activity experience.
    Input Type Description
    Enable timeout Choice Option to time out the Wait for Condition activity if the conditions aren't met after a specified Duration.
    Duration Date/Time Amount of time to wait before the activity times out and its state is set to Skipped. This input requires setting the Enable timeout input.
    Schedule Choice Schedule used to compute duration values. This input requires setting the Enable timeout input.

    Outputs

    The Wait for Condition activity has no outputs.