---
title: "with objects · RUAL Documentation"
description: "Returns an array of objects."
canonical: https://docs.rual.nl/block-types/array/array_of_objects
language: en
---

# with objects

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

Returns an array of objects.

- object required `object` First object to include in the array.

- object required `object` Second object to include in the array.

- array `array ` The array with objects output.

Collects the wired object pins into an array in pin order. Only plain objects are kept - null and any non-object value are dropped, so the output can have fewer entries than wired pins.

| `array of objects` |
| --- |
| `array objects` |

A typical wiring for [with objects](https://docs.rual.nl/block-types/array/array_of_objects): [new object](https://docs.rual.nl/block-types/object/object_new_fields) feeds the `object_1` pin; the `array` out pin feeds [reply in JSON](https://docs.rual.nl/block-types/json/httpconnection_set_json).

![Studio canvas example for the with objects block: typical wiring for with objects.](https://docs.rual.nl/canvas-examples/array_of_objects.png)

### Commonly used with

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

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

- [reply in JSON](https://docs.rual.nl/block-types/json/httpconnection_set_json): this block feeds into it. Reply to any httpconnection as JSON body.

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

- [filter empty](https://docs.rual.nl/block-types/array/array_filter_empty): this block feeds into it. Returns an array of all non-empty items. Empty is defined as: null or undefined.

### Version history

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