Append to Flow Variables flow logic

  • Release version: Australia
  • Updated March 12, 2026
  • 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 Append to Flow Variables flow logic

    The Append to Flow Variables flow logic allows you to add values to an array of objects flow variable within your ServiceNow environment. This feature is essential for managing and updating collections of data dynamically, enabling you to streamline your workflows effectively.

    Show full answer Show less

    Key Features

    • Inputs: You can specify a name for the array of objects flow variable and provide the object values to append. Dynamic values can be added using the Data panel or pill picker.
    • Data Types: Accepts inputs in the form of Array of Objects, Object, or flow variable data pills, with schema matching required between the data pills and flow variables.
    • General Guidelines: Ensure that the data structure for the flow variable is predefined and that any appended data matches the expected object schema.

    Key Outcomes

    This flow logic does not produce outputs directly but enhances the selected Array.Object flow variable by appending new object values. For example, by using a subflow to gather incident details, you can compile an array of incident objects that can later be utilized in your workflows.

    Append a value to one or more array of objects flow variables. Use flow data to generate values.

    Inputs

    Provide a value for each input that your flow logic needs. To add dynamic values, you can also drag pills from the Data panel or select them from the pill picker.

    Name
    Data type: Flow Variable

    Name of the array of objects flow variable that you want to append object values into. The drop down list only shows flow variables that are of type Array.Object.

    Data
    Data type: Array of Objects, Object, or flow variable data pill

    Object or objects data pill containing the values that you want to append. If you use an existing object data pill, then the object schema must match that used by the flow variable. Alternatively, you can expand the schema of the flow variable and provide a flow variable data pill for each object property.

    Outputs

    This flow logic produces no outputs of its own, but it does add object values to the Array.Object flow variable that you selected from the Data pane.

    General guidelines

    Use these general guidelines when using the Append to Flow Variables flow logic.

    Create inputs or flow variables to provide data values
    If you have an existing array of objects, you can use this array of objects as a subflow input. Alternatively, you can use one or more flow variables to create an array of objects within your flow. For example, you can save record values in a flow variable and then append the variables values to the objects within the array of objects.
    Define an array of objects flow variable
    This flow logic depends on there being an array of objects flow variable. You must create an array of objects flow variable and that has the object schema structure that you want to update.
    Ensure that a data pill object schema matches a flow variable object schema
    If you configure the Data input to use an existing object data pill, then the object schema must match that used by the flow variable. The flow logic can not append values to a flow variable object that has a different object schema.

    Build an array of incident objects

    The Append to Flow Variables flow logic is configured to append values to the incidents flow variable. The Sys ID and short description are set from two other flow variables.

    In this example, a subflow looks up incidents where the category is Network. For each network incident, the subflow sets the value of the incident Sys ID and incident short description in a subflow variable. The subflow then appends these values to the array of objects subflow variable. The subflow then provides the array of objects as a subflow output.

    JSON output of the incidents array of objects showing five entries in the array.

    The subflow execution details show that the output value of the incidents array of objects.