Skip to main content

Join text

Sophie avatar
Written by Sophie
Updated over 2 weeks ago

Definition and Usage

Converts a list into a text value by separating its items with a specified delimiter. This action allows you to combine multiple items from a list into a single text string using various delimiter options.


Parameter Values

Input parameters

Parameter

Description

Possible Values

Required

Options / Notes

Text list

Enter a list or select a variable containing the list to join

Any valid list

Yes

Can use variable input

Delimitter type

Specify whether to use a standard or a custom delimiter, or use no delimeter

None, Standard, Custom

Yes

Controls which delimiter options are available

Delimitter

Specify the delimeter to use

Space, Tab, Line break, Comma

Yes (if Standard is selected)

Only available when Standard delimiter type is selected

Times

Specify how many times to use the specified delimiter

Numeric value

Yes

Determines repetition of the delimiter

Custom delimitter

Specify the character(s) to use as delimiter

Any text

Yes (if Custom is selected)

Only available when Custom delimiter type is selected

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

Store joined text into a new variable. The output is a text string containing all list items combined with the specified delimiter.


Using Variables in Conditions

When you see {x} icon next to a field, you can insert variables that were previously defined in your workflow. This allows you to dynamically provide input values based on earlier actions. For example, you can use a variable that contains a list of items as the "Text list" parameter.


Notes

  • The "None" delimiter type will join list items without any separator between them.

  • If the input is not a valid list, the action may fail or produce unexpected results.

  • The "Times" parameter allows you to repeat the delimiter multiple times between each list item, which can be useful for creating specific formatting.

  • This command is particularly useful for data transformation and text formatting tasks where you need to convert structured data into a specific string format.

Did this answer your question?