---
title: "Create a New Table Instance"
url: https://docs.catalyst.zoho.com/en/sdk/flutter/v2/cloud-scale/data-store/create-table-instance/
description: "You can create a table 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: "Tables"
    url: /en/cloud-scale/help/data-store/tables
  - name: "Data Store - API"
    url: /en/api/code-reference/cloud-scale/data-store/insert-new-row/#InsertNewRow
---

# Create a New Table Instance

You can create a table instance for a particular table in the [Data Store](https://docs.catalyst.zoho.com/en/cloud-scale/help/data-store/introduction), and enable the methods defined in this class to access the instance object. This prevents unnecessary server calls.

A table instance can be created by calling the `getTableInstance()` method in either of the two ways mentioned below.

The `<DATA_STORE_INSTANCE>` used in both the methods is the instance defined in the [Data Store Instance page](https://docs.catalyst.zoho.com/en/sdk/flutter/v2/cloud-scale/data-store/create-data-store-instance).

### Create a Table Instance by its ID

You can create a table instance by passing the particular table ID as the argument to the `getTableInstance()` method, as shown in the code syntax below:

```bash
ZCatalystTable <DATA_STORE_INSTANCE>.getTableInstance(String identifier)
```

**Parameters**:

* `identifier`: The [unique table ID](https://docs.catalyst.zoho.com/en/cloud-scale/help/data-store/tables) of the specific table the instance needs to be created for

A sample code snippet is shown below:

```bash
var table = ZCatalystApp.getInstance().getDataStoreInstance().getTableInstance("2823000000017011")
```

### Create a Table Instance by its Name

Alternatively, you can create a table instance by passing the particular table's name as the argument to the `getTableInstance()` method, as shown in the code syntax below:

```bash
<DATA_STORE_INSTANCE>.getTableInstance(
 String identifier
)
```

**Parameters**:

* `identifier`: The name of the specific table the instance needs to be created for

A sample code snippet is shown below:

```bash
var table = ZCatalystApp.getInstance().getDataStoreInstance().getTableInstance(identifier: "Products"); 
```