---
title: "select field values · RUAL Documentation"
description: "returns an array with values of the given field in this array of objects."
canonical: https://docs.rual.nl/block-types/array/array_get_values_from_bp_field
language: en
---

# select field values

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

### Field Selection Required

This block relies on a field that you select to perform its data actions. You must manually select the field you want to use in your flow using the field selector modal. To access the modal, click the white button on the block.

returns an array with values of the given field in this array of objects.

- Array required `array` Array of objects to extract field values from.

- Array `array` The resulting array containing the values of the specified field.

Collects the selected field's value from each object item into a flat array, preserving order and keeping duplicates. Items that are not objects, lack the field, or hold null are SKIPPED, so the output can be shorter than the input.

| `grab key` |
| --- |

A typical wiring for [select field values](https://docs.rual.nl/block-types/array/array_get_values_from_bp_field): [search](https://docs.rual.nl/block-types/storage/function_search) feeds the `array` pin; the `array` out pin feeds [flatten](https://docs.rual.nl/block-types/array/array_nested_join).

![Studio canvas example for the select field values block: typical wiring for select field values.](https://docs.rual.nl/canvas-examples/array_get_values_from_bp_field.png)

### Commonly used with

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

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

- [flatten](https://docs.rual.nl/block-types/array/array_nested_join): this block feeds into it. Accepts a nested array and returns a flattened array.

- [match with any](https://docs.rual.nl/block-types/query/query_terms_field): this block feeds into it.

- [new object](https://docs.rual.nl/block-types/object/object_new_fields): this block feeds into it. Builds a new object filled with the given fields.

- [concat](https://docs.rual.nl/block-types/array/array_concat): this block feeds into it. Returns a joined array of two or more arrays.

- [find by field exists](https://docs.rual.nl/block-types/array/array_get_objects_by_field_exists): feeds into this block. Returns the matching objects of they include the given field.

### Version history

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