---
title: "Create Rows"
url: https://docs.catalyst.zoho.com/en/sdk/android/v2/cloud-scale/data-store/create-rows/
description: "You can create a new row instance for a particular table in the Data Store, and enable the methods defined in this class to access the instance object."
last_updated: 2025-11-19T15:07:41Z
service: Cloud Scale
type: general
related_links:
  - name: "Data Store"
    url: /en/cloud-scale/help/data-store/introduction
  - name: "Records"
    url: /en/cloud-scale/help/data-store/records
  - name: "Insert Row - API"
    url: /en/api/code-reference/cloud-scale/data-store/insert-new-row/#InsertNewRow
---

# Create Rows

### Create a Single Row

You can create a new row in a [Data Store](https://docs.catalyst.zoho.com/en/cloud-scale/help/data-store/introduction) table of the given instance using the `newRow()` method. You must set the values of the rows in the table, by specifying the column name and the corresponding row value as a key-value pair.

The `<ROW_INSTANCE>` used in the code syntax below is the instance defined in the [Row Instance page](https://docs.catalyst.zoho.com/en/sdk/android/v2/cloud-scale/data-store/create-row-instance).

```bash
<ROW_INSTANCE>.create(
    success: (ZCatalystRow) → Unit,
    failure: ((ZCatalystException) → Unit)?
): ZCatalystRequest<ZCatalystResponse<ArrayList<ZCatalystRow>>>?

```

> **Note:** If a column was created with the `is_unique` or `is_mandatory` property enabled, you must ensure that the value is unique or is mandatorily passed, respectively. You must also ensure that the data you pass for a column is of the column's configured data type.

A sample code snippet is shown below:

```bash
val row = ZCatalystApp.getInstance().getDataStoreInstance().getTableInstance("EmployeeDetails").newRow() //Replace this with your table name
    row.setColumnValue("Department_Name", "Marketing") //Replace this with your column name and its value
    row.setColumnValue("Employee_ID", "109223") //Replace this with your column name and its value
	row.setColumnValue("Employee_Name", "Robert Smith") //Replace this with your column name and its value
    row.create(
        {
            success ->
            println("New row created successfully $success")
        },
        {
            exception ->
            println("Failed to create a new row! $exception")
        }
    )

```

### Create Multiple Rows

Catalyst Android SDK enables you to create multiple rows at a time in a table of the given instance. This is done by passing an array containing the rows that need to be inserted in the table. The array is passed as an argument to the `createRows()` method, as shown in the code syntax below.

The `<TABLE_INSTANCE>` used in the code below is the instance defined in the [Table Instance page](https://docs.catalyst.zoho.com/en/sdk/android/v2/cloud-scale/data-store/create-table-instance).

```bash
<TABLE_INSTANCE>.createRows(
    rows: ArrayList<ZCatalystRow>,
    success: (List<ZCatalystRow>) → Unit,
    failure: ((ZCatalystException) → Unit)?
): ZCatalystRequest<ZCatalystResponse<ArrayList<ZCatalystRow>>>?

```

**Parameters**:

* `rows`: The array of rows to be created

A sample code snippet is shown below:

```bash
ZCatalystApp.getInstance().getDataStoreInstance().getTableInstance("EmployeeDetails").createRows( //Replace this with your table name
	rowsList, //Set the names and values of the columns and add them to an arrayList
        {
            rows -> println("The IDs of the rows that were successfully created are listed below:")
            for (row in rows){
                println("${row.id}")
            }
        },
        {
            exception -> println("Add Rows Failed! $exception")
        })

```