> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/flow/actions/data-conversion-and-formatting/join-text-collection.md).

# Join Text Collection

## Overview

This action combines multiple text values from a collection into a single text string. You can specify a delimiter to separate the values and options for enclosing and escaping special characters.

***

## How it Helps

Imagine you have a collection of product names gathered from a multi-select picklist and want to display them in a single sentence. This action lets you easily join those names with a comma and a space, creating a user-friendly output like "You selected: Apples, Bananas, and Oranges."

***

## When to Use It

This action is ideal for:

* **Creating comma-separated lists or formatted strings from text collections.**
* **Displaying multiple values in a user-friendly way.**
* **Preparing data for use in other flow elements or integrations.**
* **Avoiding manual string manipulation with formulas or code.**

***

## Example

To display a list of selected hobbies:

1. **Create a Text Collection:** Have a Text Collection variable storing a list of hobbies selected by a user.
2. **Configure the Action:** Select the hobby collection, use a comma (",") as the delimiter, and optionally add a space (" ") after the comma for better readability.
3. **Display the Text:** Use the output of the action to display the formatted list of hobbies in a text component.

***

## Key Considerations

* **Source Collection:** Ensure you have a valid collection of text values.
* **Delimiter:** Choose a delimiter to separate the joined values (e.g., comma, space, newline).
* **Enclosure:** Optionally enclose each value in characters like quotes (").
* **Escape Characters:** Specify an escape character to handle special characters within the values


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.avonnicomponents.com/flow/actions/data-conversion-and-formatting/join-text-collection.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.