K
Docs
API ReferencePiecesJoin List
🔗

Join List

base.text.joinBase SetUtility

Joins list items into a single string with a separator between each item. Perfect for building comma-separated lists, bullet lines, or one big message from many sparks.

On the canvas

This is what Join List looks like when you place it on your flow. Each field below is something you configure in the inspector panel.

🔗
Join List
base.text.join
Utility
listrequired
{{parts}}
separator
,
asrequired
joined

Config fields

FieldTypeReqWhat it does
list
{{parts}}
textyesList to join 📋
separator
,
textBetween items
as
joined
textyesSave text as ✨

Sparks this piece adds

After this piece runs, these values are available as sparks in every node downstream.

{{joined}}stringJoined text

Output ports

outputText spark is ready downstream
📐

In TypeScript, this would be…

Not something you need to write — just a look at what Kitcord does for you.

TypeScript
const joined = list.join(", ");
// separator ", " — {{joined}}