---
schema_version: "1"
id: 2786b6cfbc90b30e47096f027e8934afa1fb2a61e2c755443e50dbd6a5f7ae73
title: divideBy
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/dataweave/latest/dw-objects-functions-divideby.md
canonical_url: https://docs.mulesoft.com/dataweave/latest/dw-objects-functions-divideby
source_site: docs.mulesoft.com
content_type: documentation
content_hash: d0b4c422cf5e4f224d79d1f38f6a82ffa671e43070bbdc09b32e1e89589b0b69
description: MuleSoft Documentation Site
release: "2.13"
latest: true
---
---
product: DataWeave
version: 2.13
is-latest-version: true
---

# 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
    }
  ]
}
```