> For the complete documentation index, see [llms.txt](https://docs.hala.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hala.ai/key-concepts/skills-kit/output-in-nodes/output-tables.md).

# Tables (beta)

## Overview (Beta version) 

With Hala, you can include the table in the response. It can be useful when you are making an API request to external application, and then you want to represent the API response in the table view for the user. Also, you can use tables with mockup data, if you need to represent the information with columns and lines.

For example: 

![](/files/-LrE5WKmT_dY1zQ_uMvU)

## Adding the tables in Expert mode

You can use the expert mode to add the tables. The expert mode becomes available by pressing the button next to the word "Output."  

<div align="left"><img src="/files/-LrDaVc-cu_vp0TTNdz0" alt="Access the Expert mode"></div>

Here is the JSON format for the tables that generated based on the API response:&#x20;

```javascript
[
 {
        "type": "smart-table",
        "view": "horizontal",
        "name":"Example table",
        "filters": {
          "Country": [
            "Estonia"
          ]
        },
        "sourceData": "{{context.responseFromAPI}}",
        "requiredFields": [
          "Country",
          "Company",
          "Address",
          "Phone number",
          "Email"
        ],
        "transformFromDb": true
}
]
```

Example for the table with mockup data:

```javascript
{
            "type": "smart-table",
            "view": "horizontal",
            "name": "Table name",
            "transformFromDb": false,
            "sourceData": [{
                "Country": "Estonia",
                "Company": "Hala Digital OU",
                "Address": "Erika 14",
                "Phone number": "+37259823235",
                "Email": "rudchuk@hala.ai"
            }, {
                "Country": "Latvia",
                "Company": "Hala Digital SIA",
                "Address": "Puces 10",
                "Phone number": "+37259823235",
                "Email": "support@hala.ai"
            }]
        }
```

The views of the table in the chat based on mockup data above:

![](/files/-Ls0ojicPO-SQkY-B83R)

The following table describes the parameters that can be used to build the table:

| Parameter         | Type    | Description                                                                                                                                                                                                                                     |
| ----------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `type`            | string  | String value, specifying the format.                                                                                                                                                                                                            |
| `view`            | string  | View of the tables. `horizontal` - columns are displayed horizontally. `vertical` - columns are displayed vertically                                                                                                                            |
| `name`            | string  | Optional. The name of your table that is displaying for the user in output.                                                                                                                                                                     |
| `filters`         | array   | Optional. Array with Objects. Each object represents a filter. The key of the Object denotes the field that should be filtered, and the Array of Strings represents the criteria.                                                               |
| `sourceData`      | array   | Array with all the data records to be displayed in the Table. It can be described as `{{context.context_name}}` or with the mockup data.                                                                                                        |
| `requiredFields`  | array   | Optional. Array with String values representing the keys that the table should use to populate the columns. If it is empty, the SmartTable will use the first five fields in the "sourceData" object.                                           |
| `transformFromDb` | boolean | A boolean value indicating if the keys in the "sourceData" objects should be replaced with longer and more explicit ones from the database (API response), if set `false`, the keys will be shown in the columns of the table just as they are. |