# 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: 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:

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

The question should be specific, self-contained, and written in natural language.
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.