> For the complete documentation index, see [llms.txt](https://docs.emobiq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.emobiq.com/emobiq-client/006-actions-and-visual-logic/action-reference/react-native/dataset/loaddata.md).

# loadData

## Description

Loads the data from a local table, staging database or 3rd party connector.

## Input / Parameter

| Name    | Description                                                                        | Input Type | Default | Options | Required |
| ------- | ---------------------------------------------------------------------------------- | ---------- | ------- | ------- | -------- |
| dataset | The name of the local table to load data from.                                     | Text       | -       | -       | Yes      |
| fields  | Specifies which fields to retrieve from the local table.                           | List       | -       | -       | No       |
| join    | Details about any tables to be joined with the primary dataset for data retrieval. | Array/List | -       | -       | No       |
| filter  | The filters for the fields and values to retrieve.                                 | List       | -       | -       | Yes      |
| sort    | Specifies the field and direction for sorting the returned data.                   | List       | -       | -       | No       |
| limit   | The number of records to be returned from the local table.                         | Number     | -       | -       | No       |
| page    | The page number for pagination purposes.                                           | Number     | -       | -       | No       |
| extra   | Extra parameters stored and passed to callback.                                    | Any        | -       | -       | No       |

## Output

| Description                        | Output Type |
| ---------------------------------- | ----------- |
| Returns the formatted information. | Object      |

### Object

| Key     | Description                                                             | Output Type |
| ------- | ----------------------------------------------------------------------- | ----------- |
| success | Boolean value to denote whether the function was executed successfully. | Text        |
| message | The message to print.                                                   | Text        |
| data    | Any additional message or data to print.                                | Text        |

## Callback

### callback

The function to be executed if the records are loaded successfully.

### errorCallback

The function to be executed if the records are not loaded successfully.

## Example

In this example, we will load the data from the Local Table and display it in a flatlist component.

```js
Note: This example will only work after the user has created the data using `Dataset.insert` function.
```

### Steps

1. Make sure a `Local Table` component is created and filled on the services panel in the service page.

   ![](/files/JzmCMH8Z7655Mt4p1eaz)
2. Drag a button component to a page in the mobile designer.

   ![](/files/O8ag5WhlbzpaiYiA7ijX)
3. Drag a `flatlist` component to a page in the mobile designer, and drag a `label` component into the `flatlist` component.

   ![](/files/Tcey4eR6R8Dq9TGX2e4o)
4. Fill the `flatlist` component property in the page and fill the `label` component property in the `flatlist` component, make sure the `label` component `field` value matches the key of the data that is being stored in the local table.

   ![](/files/K4py5Dfa6ig9cnKm1rB2)
5. Select the event `press` and drag the `Dataset.loadData` function to the event flow. Fill in the parameters of the function.

   ![](/files/zOSflg86Yyl0tKVZMoNg)

### Result

1. The data should be loaded from the local table and displayed in the flalist component.