---
title: "select custom fields from · RUAL Documentation"
description: "Returns an object with the given fields only"
canonical: https://docs.rual.nl/block-types/object,fields/object_get_by_custom_fields
language: en
---

# select custom fields from

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

Returns an object with the given fields only

- Fields required `array`

- Object required `object`

- Object `object`

Builds a NEW object containing only the dot paths listed in fields, preserving nesting. Example: fields ["a.b"] on {a:{b:1,c:2}} -> {a:{b:1}}. Missing paths are omitted (no nulls). Empty fields list or non-object input yields {}. Values are copied by REFERENCE; the input is not modified.

| `grab fields` |
| --- |
| `grab custom fields` |

A typical wiring for [select custom fields from](https://docs.rual.nl/block-types/object/object_get_by_custom_fields): [with values](https://docs.rual.nl/block-types/array/array_of_values) feeds the `fields` pin; the `object` out pin feeds [custom field](https://docs.rual.nl/block-types/object/object_get_custom_field).

![Studio canvas example for the select custom fields from block: typical wiring for select custom fields from.](https://docs.rual.nl/canvas-examples/object_get_by_custom_fields.png)

### Version history

Introduced in [`v12.0.3`](https://docs.rual.nl/core-versions/120003).