---
schema_version: "1"
id: 8430dd1d481761f78c307b4c0033ea2fc219ee73d6d5f3dac57c0e4eb8b11b57
title: divideBy
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/dataweave/2.12/dw-objects-functions-divideby.md
canonical_url: https://docs.mulesoft.com/dataweave/2.12/dw-objects-functions-divideby
source_site: docs.mulesoft.com
content_type: documentation
content_hash: e480c94ba6d111b19b1817b0b8efd03125e678fb0b653978976f16dfb2365e37
description: MuleSoft Documentation Site
release: "2.12"
latest: false
---
---
product: DataWeave
version: 2.12
---

# divideBy

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

## divideBy(items: Object, amount: Number): Array<Object>

Breaks up an object into sub-objects that contain the specified number of key-value pairs.

If there are fewer key-value pairs in an object than the specified number, the function will fill
the object with those pairs. If there are more pairs, the function will fill another object with the
extra pairs.

### Parameters

<table><colgroup><col> <col></colgroup><thead><tr><th>Name</th><th>Description</th></tr></thead><tbody><tr><td><p><code>items</code></p></td><td><p>Key-value pairs in the source object.</p></td></tr><tr><td><p><code>amount</code></p></td><td><p>The number of key-value pairs allowed in an object.</p></td></tr></tbody></table>

### Example

This example breaks up objects into sub-objects based on the specified `amount`.

#### Source

```DataWeave
%dw 2.0
import divideBy from dw::core::Objects
output application/json
---
{ "divideBy" : {"a": 1, "b" : true, "a" : 2, "b" : false, "c" : 3} divideBy 2 }
```

#### Output

```JSON
{
  "divideBy": [
    {
      "a": 1,
      "b": true
    },
    {
      "a": 2,
      "b": false
    },
    {
      "c": 3
    }
  ]
}
```