<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.21.0/tensorflow/python/ops/string_ops.py#L551-L583) |

Perform element-wise concatenation of a list of string tensors.

#### View aliases


**Compat aliases for migration**

See
[Migration guide](https://www.tensorflow.org/guide/migrate) for
more details.

[`tf.compat.v1.string_join`](https://www.tensorflow.org/api_docs/python/tf/strings/join), [`tf.compat.v1.strings.join`](https://www.tensorflow.org/api_docs/python/tf/strings/join)

<br />

    tf.strings.join(
        inputs, separator='', name=None
    )

### Used in the notebooks

| Used in the guide | Used in the tutorials |
|---|---|
| - [Ragged tensors](https://www.tensorflow.org/guide/ragged_tensor) | - [Text generation with an RNN](https://www.tensorflow.org/text/tutorials/text_generation) - [Sending Different Data To Particular Clients With federated_language.federated_select](https://www.tensorflow.org/federated/tutorials/federated_select) - [Image captioning with visual attention](https://www.tensorflow.org/text/tutorials/image_captioning) - [Neural machine translation with attention](https://www.tensorflow.org/text/tutorials/nmt_with_attention) |

Given a list of string tensors of same shape, performs element-wise
concatenation of the strings of the same index in all tensors.

    tf.strings.join(['abc','def']).numpy()
    b'abcdef'
    tf.strings.join([['abc','123'],
                     ['def','456'],
                     ['ghi','789']]).numpy()
    array([b'abcdefghi', b'123456789'], dtype=object)
    tf.strings.join([['abc','123'],
                     ['def','456']],
                     separator=" ").numpy()
    array([b'abc def', b'123 456'], dtype=object)

The reduction version of this elementwise operation is
[`tf.strings.reduce_join`](https://www.tensorflow.org/api_docs/python/tf/strings/reduce_join)

<br />

<br />

<br />

| ## Args ||
|---|---|
| `inputs` | A list of [`tf.Tensor`](https://www.tensorflow.org/api_docs/python/tf/Tensor) objects of same size and [`tf.string`](https://www.tensorflow.org/api_docs/python/tf#string) dtype. |
| `separator` | A string added between each string being joined. |
| `name` | A name for the operation (optional). |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A [`tf.string`](https://www.tensorflow.org/api_docs/python/tf#string) tensor. ||

<br />