# combine

## Description

Combining separate pieces of text or characters to create a larger, unified string of text.

## Input / Parameter

| Name           | Description                 | Input Type | Default | Options | Required |
| -------------- | --------------------------- | ---------- | ------- | ------- | -------- |
| text1          | The first value to combine. | Text       | -       | -       | No       |
| text2...text10 | Next value to combine with. | Text       | -       | -       | No       |

## Output

| Description                          | Output Type |
| ------------------------------------ | ----------- |
| Returns the combined string of text. | String/Text |

## Example

In this example, we will attempt to combine few chunks of words into a single string of text.

### Steps

1. Drag a `button` component into the canvas and open the `Action` tab. Select the `press` event of the button.
2. Add `Log.write` function and add a subflow on its value, then put `Text.combine` inside it. Subsequently, add some words in the parameter list starting from `text1` and up until needed.

   * Use **Add new parameter** button to include the next fields to fill on.

   ![](https://399701567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwmJ1RKjM2uNFaL6fO3Xu%2Fuploads%2Fgit-blob-af09e8c2240465b60d983acf1cc467f7f5a959a5%2Fcombine-step-1.png?alt=media)

### Result

1. The console on preview will show the combined string in a single line of text.

   ![](https://399701567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwmJ1RKjM2uNFaL6fO3Xu%2Fuploads%2Fgit-blob-eef1c7b3ed9e7a70d32f221f68369e251ec75ebb%2Fcombine-result-1.png?alt=media)

## Links

### Related Information