---
url: https://gudhub.com/docs/gh-elements/string-join/
title: "String Join\n                #"
description: "String Join is a gh element that allows you to join values of different fields and the entered value into one string. This element is used to concatenate select"
lang: uk
updated: 2026-09-08T15:59:02.669Z
---

# String Join [#](https://gudhub.com/docs/gh-elements/string-join/#string-join)

**String Join** is a gh-element that allows you to join values of different fields and the entered value into one string.

## Functional Characteristics [#](https://gudhub.com/docs/gh-elements/string-join/#functional-characteristics)

This element is used to concatenate selected fields. For example, when the user enters his or her first and last name separately in different fields, this element will join them into one line. The String join element is very similar to the [text element](https://gudhub.com/docs/gh-elements/text/), so it can be used in the same ways.

## Value Format [#](https://gudhub.com/docs/gh-elements/string-join/#value-format)

The string join does not contain any value until the [Persistent Value](#persistent-value) option is disabled.

Copy

```json
{
    "field_value": "Hello World"
}
```

## Element Options [#](https://gudhub.com/docs/gh-elements/string-join/#element-options)

String join has two groups of settings. One of them configures its value and the second one configures the element.

### Field Settings [#](https://gudhub.com/docs/gh-elements/string-join/#field-settings)

This is the main settings group. It allows you to customize the field and contains standard and advanced options.

![Settings of string join field](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/string-join-field-settings.jpg "String join field settings")

| Name | Description |
| :-- | :-- |
| Persistent value | allows to save the generated value; [details...](#persistent-value) |
| One time generation | allows you to generate a value only once; [details...](#one-time-generation) |

#### **Persistent Value** [#](https://gudhub.com/docs/gh-elements/string-join/#persistent-value)

As long as this function is not enabled, the join string does not save the generated value. So, it allows to save value in the field.

#### **One Time Generation** [#](https://gudhub.com/docs/gh-elements/string-join/#one-time-generation)

This function allows you to fix the first generated value and display it in the application. This value can only be updated with the [Update Button](#update-button).

### Expression Generator [#](https://gudhub.com/docs/gh-elements/string-join/#expression-generator)

The last group allows you to make an expression that join strings.

![Generator of the string join value](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/string-join-generator.jpg "String join generator")

| Name | Description |
| :-- | :-- |
| Field | allows to select the field from which the value will be selected; [details...](#field) |
| Word | allows to enter the text in settings; [details...](#word) |
| ID | allows to select the certain ID; [details...](#id) |
| + | allows to concatenate all elements of expression; [details...](#concatenation) |
| Clear | allows to clear the full expression; [details...](#clear) |
| < | allows you to select only one sign of the expression; [details...](#clear-element) |

#### **Field** [#](https://gudhub.com/docs/gh-elements/string-join/#field)

This button allows to take the field whose value will be used in the expression. It also allows you to configure which part and how many characters of a given value are used.

![Configuring the source field](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/string-join-field.jpg "String join field")

#### **Word** [#](https://gudhub.com/docs/gh-elements/string-join/#word)

This button opens a popup window in which you can enter your own value to be used in the expression.

![Entering window](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/string-join-word.jpg "String join word")

#### **ID** [#](https://gudhub.com/docs/gh-elements/string-join/#id)

This is the button that allows to select one of four values.

![ID configuring popup window](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/string-join-id.jpg "String join ID")

-   Index number of item
-   Current year
-   Current month
-   Current day of month

#### **Concatenation** [#](https://gudhub.com/docs/gh-elements/string-join/#concatenation)

The concatenation button allows to enter the plus sign and connect all the parts of the expression.

#### **Clear** [#](https://gudhub.com/docs/gh-elements/string-join/#clear)

This button allows to clear the full expression.

#### **Clear Element** [#](https://gudhub.com/docs/gh-elements/string-join/#clear-element)

This button allows to clear one element of sign. It has '<' as a name.

## Element Style [#](https://gudhub.com/docs/gh-elements/string-join/#element-style)

The string join element has quite standard set of [style settings](https://gudhub.com/docs/understanding-gudhub/gh-elements-structure/setting-overview/) and only one [interpretation type](#interpretation). The only additional setting is located in general group of settings.

![Style of string join element](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/string-join-element-style.jpg "String join element style")

### General Settings [#](https://gudhub.com/docs/gh-elements/string-join/#general-settings)

Almost all style settings are set by default instead of the only one.

![General settings of string join style](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/string-join-general-settings.jpg "String join general style settings")

| Name | Description |
| :-- | :-- |
| Update button | allows to add the updating button |

#### **Update Button** [#](https://gudhub.com/docs/gh-elements/string-join/#update-button)

This is the button that allows you to update the value when [One Time Generation](#one-time-generation) is enabled.

## Data Model [#](https://gudhub.com/docs/gh-elements/string-join/#data-model)

The data model of this element contains all its settings, including configuration options.

Copy

```json
{
    "data_model": {
        "arguments": [{
            "word": "Hello World"
        },
        {
            "app_id": "28752",
            "field_id": "679043",
            "field_settings": {
                "count": 2,
                "display": "first_characters",
                "name": "first characters"
            }
        },
        {
            "type": "Current day of month"
        }],
        "expression": "WORD()+FIELD_STRING()+ITEM_INDEX()",
        "interpretation": [],
        "is_generate_once": 0,
        "is_persistent_value": 0,
        "tooltip": {
            "filter_valuesArray": ["string_join", "string_join"],
            "settings_file_id": "30233"
        }
    }
}
```

| Name | Type | Description |
| :-- | :-- | :-- |
| arguments | `array` | _contains all the connection generation settings_ |
| word | `string` | _contains the entered text_ |
| app\_id | `string` | _contains ID of the source application_ |
| field\_id | `string` | _contains ID of the source field_ |
| field\_settings | `object` | _contains additional string settings_ |
| count | `number` | _contains number of sign that will be displayed for joining_ |
| display | `string` | _shows which part of the selected field value_ |
| name | `string` | _contains the name of the selected part_ |
| type | `string` | _contains type of ID_ |
| expression | `string` | _contains the final expression by which the value will be joined_ |
| interpretation | `array` | _contains all interpretation types and their settings_ |
| is\_generate\_once | `boolean` | _show whether the One Time Generation is used or not_ |
| is\_persistent\_value | `boolean` | _shows whether the generated value will be saved or not_ |
| tooltip | `object` | _contains tooltip settings_ |
| filter\_valuesArray | `array` | _contains all value filters_ |
| settings\_file\_id | `string` | _contains ID of the file with the tooltip text_ |

## Filtration [#](https://gudhub.com/docs/gh-elements/string-join/#filtration)

This element can be filtered using filters that compare strings:

-   [Contains(or)](https://gudhub.com/docs/core-api/filter/contains/)
-   [Contains(and)](https://gudhub.com/docs/core-api/filter/contains/)
-   [Not contains(or)](https://gudhub.com/docs/core-api/filter/contains/)
-   [Not contains(and)](https://gudhub.com/docs/core-api/filter/contains/)
-   [Equals(or)](https://gudhub.com/docs/core-api/filter/equals/)
-   [Equals(and)](https://gudhub.com/docs/core-api/filter/equals/)
-   [Not equals(or)](https://gudhub.com/docs/core-api/filter/equals/)
-   [Not equals(and)](https://gudhub.com/docs/core-api/filter/equals/)
-   [Value](https://gudhub.com/docs/core-api/filter/value/)

## Interpretation [#](https://gudhub.com/docs/gh-elements/string-join/#interpretation)

The current element has only two interpretation types.

![Types of string join interpretation](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/string-join-interpretation-types.jpg "String join interpretation types")

### Default [#](https://gudhub.com/docs/gh-elements/string-join/#default)

The default interpretation allows to display the result of the join.

### Value [#](https://gudhub.com/docs/gh-elements/string-join/#value)

The last interpretation displays the raw value of the field.