---
title: "add suffix to values · RUAL Documentation"
description: "Appends a suffix to each value in the array."
canonical: https://docs.rual.nl/block-types/array/array_add_suffix
language: en
---

# add suffix to values

This block is part of the [`array`](https://docs.rual.nl/block-types/array) group and was last modified in core [`v14.0.4`](https://docs.rual.nl/core-versions/140004).

Appends a suffix to each value in the array.

- array required `array`

- suffix required `value` The value to append to each item

- array `array`

Returns a new array where each element is the element coerced to text with JS String() rules (null becomes "null", objects become "[object Object]", arrays comma-join) followed by the suffix string. Every output element is a string. A missing or non-array input yields an empty array.

| `append` |
| --- |

A typical wiring for [add suffix to values](https://docs.rual.nl/block-types/array/array_add_suffix): [concatenate values](https://docs.rual.nl/block-types/value/value_concatenate) feeds the `suffix` pin; [get meta guids](https://docs.rual.nl/block-types/array/array_guid_map) feeds the `array` pin; the `array` out pin feeds [map values to guid seeds](https://docs.rual.nl/block-types/array/array_map_guid_seed).

![Studio canvas example for the add suffix to values block: typical wiring for add suffix to values.](https://docs.rual.nl/canvas-examples/array_add_suffix.png)

### Commonly used with

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

- [concatenate values](https://docs.rual.nl/block-types/value/value_concatenate): feeds into this block.

- [get meta guids](https://docs.rual.nl/block-types/array/array_guid_map): feeds into this block. Returns an array of values with _meta.guid's of each object in the given array.

- [map values to guid seeds](https://docs.rual.nl/block-types/array/array_map_guid_seed): this block feeds into it. Maps each value in the array through the deterministic GUID seed hash. Produces an array of GUIDs where each GUID is derived from the corresponding value. Much faster than using array map with a custom function.

- [search](https://docs.rual.nl/block-types/storage/function_search): feeds into this block. searches in the given storage based on a query.

- [storage left join exists](https://docs.rual.nl/block-types/storage/function_storage_left_join_exists): this block feeds into it. Left joins a boolean field into the given array based on whether a document exists in the storage for each corresponding GUID. Sets the field to true when found, false when not.

### Version history

Introduced in [`v14.0.4`](https://docs.rual.nl/core-versions/140004).