---
title: "get fields · RUAL Documentation"
description: "Gets the selected fields from the given object."
canonical: https://docs.rual.nl/block-types/object/object_field_getter_multiple
language: en
---

# get fields

This block is part of the [`object`](https://docs.rual.nl/block-types/object) group and was last modified in core [`v15.0.0`](https://docs.rual.nl/core-versions/150000).

### Fields Selection Required

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

### Field Selection Required

This block requires field selection (out). You must manually select the fields you want to work with using the field selector modal. To access the modal, click the white button on the block.

Gets the selected fields from the given object.

- object required `object` Object to select the selected fields from.

- convert type `v15.0.0` `condition` When true, value out-pins stringify non-string sources (numbers, booleans, arrays, objects). Other pin types are unaffected. Defaults to false so existing blueprints keep their raw-passthrough behavior. • Hidden when unused

Default `false`

Emits one out-pin per selected field with the value at that dot path, coerced to the pin's chosen type (numbers parsed from strings, conditions via JS truthiness, dates from unix seconds; value pins pass the raw value through unconverted). Missing or null paths emit nil, never type-zero defaults. With convert_type=true, value pins additionally stringify non-string sources (objects/arrays as JSON).

| `get multiple from object` |
| --- |

[get fields](https://docs.rual.nl/block-types/object/object_field_getter_multiple) takes the document from [get document](https://docs.rual.nl/block-types/storage/function_get_document) and outputs one pin per selected field; here name is compared with a fixed [value](https://docs.rual.nl/block-types/value/value_default) using [==](https://docs.rual.nl/block-types/condition/condition_equal), and the comparison drives a [branch](https://docs.rual.nl/block-types/flow/branch). This getter-plus-compare pair is the most common wiring in real blueprints.

![Studio canvas example for the get fields block: reading fields off a document.](https://docs.rual.nl/canvas-examples/object_field_getter_multiple.png)

### Commonly used with

One of the most-used blocks across production blueprints. It is most often wired together with:

- [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.

- [get document](https://docs.rual.nl/block-types/storage/function_get_document): wired in both directions with this block. get a specific document based on the given GUID.

- [set fields](https://docs.rual.nl/block-types/mutations/mutations_set_bp_field_multiple): this block feeds into it. Generates an array of mutations based on the given filled fields.

- [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.

- [==](https://docs.rual.nl/block-types/condition/condition_equal): this block feeds into it. returns true if the two values are equal.

- [execute](https://docs.rual.nl/block-types/function%20execution/function_custom_execute): this block feeds into it. Executes the given funcion and waits for it to be executed.

### Version history

Introduced in [`v15.0.0`](https://docs.rual.nl/core-versions/150000).