# Data Add Record

{% hint style="info" %}
**Block Information**

Available in: Page Flow and Cloud Flow

Toolbox Category: Data - Edit

Block Type: [Regular](/app-editor/page-flow/block-anatomy.md#regular-block)
{% endhint %}

**`Data Add Record`** is a [regular block](/app-editor/page-flow/block-anatomy.md#regular-block) that initiates the addition of a [record](/app-editor/data/database-tables.md#table-records) into a [database table](/app-editor/data/database-tables.md).

<div align="left"><figure><img src="/files/j51MiAtnGd6ddoq5PAEI" alt="" width="212"><figcaption><p>Data Add Record block</p></figcaption></figure></div>

The block consists of the following (from top to bottom):

* *Table:* [Value Parameter](/app-editor/page-flow/block-anatomy.md#value-parameters) that accepts a [*text*](/app-editor/page-flow/references/value-types.md) value representing the name of the [Database Table](/app-editor/data/database-tables.md) .
* *Dataset Name:* [Value Parameter](/app-editor/page-flow/block-anatomy.md#value-parameters) that accepts a [*text*](/app-editor/page-flow/references/value-types.md) value representing the name of the dataset. This can be any [*text*](/app-editor/page-flow/references/value-types.md) value and can later be used to track the completion.
* *Dataset Refresh*: [Value Parameter](/app-editor/page-flow/block-anatomy.md#value-parameters) that accepts a [boolean](/app-editor/page-flow/references/value-types.md) (true/false) value to indicate if you want the system to refresh the records in the same dataset after successful completion.
* *Record Data*: [Value Parameter](/app-editor/page-flow/block-anatomy.md#value-parameters) that accepts an [object](/app-editor/page-flow/references/value-types.md) value representing the record to be added. The Object block is pre-attached by default and its properties are automatically populated based on the fields of the selected table.

{% hint style="success" %}
**NOTE**: This block initiates the database record addition, which will occur in the background. To track the status and to take an action upon completion, use the [Data Status](/app-editor/page-flow/toolbox-blocks/data-status.md) block.&#x20;
{% endhint %}

***

## Usage Example

{% hint style="info" %}
**NOTE: Please refer to the prerequisite information shown** [**here**](/app-editor/page-flow/references/prerequisite-for-data-examples.md) **before seeing the example.**&#x20;
{% endhint %}

The image below shows an example of **`Data Add Record`** the block.

<figure><img src="/files/qeSJY01qaC52Uo159EL1" alt=""><figcaption><p>Example for Data Add Record block</p></figcaption></figure>

Here is a summary of the above example:

* The [Event Action](/app-editor/page-flow/toolbox-blocks/event-action.md) block is used to handle a [click](/app-editor/page-flow/toolbox-blocks/event-action.md#event-names) event for a button.
* The **`Data Add Record`** block is used to add a new record into the *Customers* database table. The record is for the name *Jane Max* .
* The [Data Status](/app-editor/page-flow/toolbox-blocks/data-status.md) block is used to track the completion of the database add operation.
* Upon a successful completion, the [Show Information Popup](/app-editor/page-flow/toolbox-blocks/show-information-popup.md) block is used to display the [record identifier](/app-editor/data/database-tables.md#id-field) of the newly added record along with the value of the *FirstName* field.

The result for the above example is shown in the image below. The record identifier for the newly added record (*64f1018ab5ed96040cc633b3*) is displayed along with the value of the *FirstName* field.

<div align="left"><figure><img src="/files/ylW7KjcyTj3swBs9YRIm" alt="" width="563"><figcaption><p>Result of the above example for Data Add Record block</p></figcaption></figure></div>

The *Customers* database table now contains the following, with the record we added highlighted:

<figure><img src="/files/BVjOub0eWZE54kIrWkCw" alt=""><figcaption><p>Database records after the above example completes</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zingy.ai/app-editor/page-flow/toolbox-blocks/data-add-record.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.