---
title: "concatenate values · RUAL Documentation"
description: "RUAL value block."
canonical: https://docs.rual.nl/block-types/value/value_concatenate
language: en
---

# concatenate values

This block is part of the [`value`](https://docs.rual.nl/block-types/value) group and was last modified in core [`v10.4.28`](https://docs.rual.nl/core-versions/100428).

- value_0 required `value`

- value_1 required `value`

- value_2 required `value`

- Combined `value`

Joins all input pins into one string in LEXICOGRAPHIC pin-id order (value_10 sorts before value_2). Nil and empty-string inputs are SKIPPED; other values are coerced JS-style: numbers without trailing zeros, booleans as true/false, arrays comma-joined, objects as [object Object].

[concatenate values](https://docs.rual.nl/block-types/value/value_concatenate) glues its value pins together in order. Two [value](https://docs.rual.nl/block-types/value/value_default) blocks provide the parts here, and the combined text lands in a [custom text](https://docs.rual.nl/block-types/state ui/state_text) element on the page.

![Studio canvas example for the concatenate values block: joining texts into one.](https://docs.rual.nl/canvas-examples/value_concatenate.png)

### Commonly used with

In production blueprints, this block is most often wired together with:

- [value](https://docs.rual.nl/block-types/value/value_default): feeds into this block. Simply returns the provided value.

- [get fields](https://docs.rual.nl/block-types/object/object_field_getter_multiple): feeds into this block. Gets the selected fields from the given object.

- [generate guid](https://docs.rual.nl/block-types/value/value_guid): this block feeds into it. Generates a unique GUID. When a seed is provided, the GUID is deterministic (same seed always produces the same GUID) — the sha256 of the seed, the same derivation the document blocks apply to their guid_seed pin. Wire this output into verbatim guid pins (get / update / remove) to address seed-created documents. Never wire it into a guid_seed pin: that would hash the already-hashed value again and address a different document — give guid_seed pins the raw seed instead.

- [create](https://docs.rual.nl/block-types/globals/trigger_custom_function): feeds into this block. Creates a new function that can be executed using the given name.

- [concatenate values](https://docs.rual.nl/block-types/value/value_concatenate): wired in both directions with this block.

- [substring](https://docs.rual.nl/block-types/value/value_substr): feeds into this block.

### Version history

Introduced in [`v10.4.28`](https://docs.rual.nl/core-versions/100428).