Skip to main content

Merge lists

Sophie avatar
Written by Sophie
Updated over a week ago

Definition and Usage

Merge lists combines two separate lists into a single unified list. This action allows you to concatenate the elements from two different list variables, creating a new merged list that contains all items from both source lists.


Parameter Values

Input parameters

Parameter

Description

Possible Values

Required

Options / Notes

List 1

Select the first list to merge

Any list variable

Yes

The first source list that will be combined

List 2

Select the second list to merge

Any list variable

Yes

The second source list that will be combined

Error handling

Parameter Name

Description

Throw error & stop

When an error occurs, the action will trigger an error and stop the execution of the entire app.

Retry command

If an error occurs, the action will retry the command in an attempt to resolve the issue and continue the process.

Ignore error & continue

When an error occurs, the action will be ignored, and the workflow will continue without interruption.

Variables produced

This action produces a new list variable that contains all elements from both source lists combined into a single list.


Using Variables in Conditions

When configuring this action, you can use existing variables by clicking the {x} icon next to input fields. This allows you to dynamically select source lists based on variables defined earlier in your workflow. The output variable can be referenced in subsequent actions when you need to work with the merged list.


Notes

  • The items from List 1 will appear first in the merged list, followed by items from List 2.

  • Both source lists must be valid list variables; attempting to merge non-list variables will result in an error.

  • The merged list will maintain the original order of items from both source lists.

  • If either source list is empty, the merge will still work, containing only the items from the non-empty list.

  • The data types of items in both lists can be different; the merge operation simply combines the items without type checking.

Did this answer your question?