---
title: "Displaying Lists of Objects in a Data Grid"
slug: "displaying-lists-of-objects-in-a-data-grid"
description: "This document shows how to display a list of objects in Decisions via use of a Data Grid.  Data Grids essentially act as a spreadsheet for data in Decisions, with each row representing an object, and each column representing an object property. "
tags: ["Organization", "Displaying Lists"]
updated: 2025-06-27T14:44:30Z
published: 2025-06-27T14:44:30Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Displaying Lists of Objects in a Data Grid

## Overview

The **Data Grid** Form control displays a list of data objects in a grid, with each row representing an[Object](https://documentation.decisions.com/docs/validations-overview-1?highlight=object%20data%20grid) and each column representing an Object property.

---

## Example

[Import](/v9/docs/importing-and-exporting-projects) the below example file to examine the completed example build.

[PROJECT_DATA GRID-16052023-115106.zip](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/PROJECT_DATA%20GRID-16052023-115106.zip)

1. In a Designer Project, [create a new Flow](https://documentation.decisions.com/v9/docs/create-flows).
2. In the **Toolbox** panel, add the **GetAll** step under **INTEGRATION > INTERNAL SERVICES > ACCOUNTSERVICE** to the **Start**step.
3. After the GetAll step, add the **Show Form** step. On the **Properties**panel, click PICK OR CREATE FORM and [create a new Form](/v9/docs/create-forms).  
![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-06-16_15h12_00.png)
4. Click and drag the **Data Grid** control to the Form and add a **Button**control (Done).Need help editing the Grid layout?Select the Form Grid and view its Properties > Grid Setup to edit its number of column and rows. This example replaces the center Grid with a single large cell via 1* to house the Grid for easier viewing.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-07_15h37_21.png)
5. On the Properties panel, under INPUT DATA, enter "Accounts" in the **Data Name** field. Then, in the **Type**textbox search for and select **Account [Decision.Framework...]**.  
![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-07_15h38_10.png)
6. After setting the Input Data, **Column Information**appears in the Properties panel. Users can remove, add, and sort the different fields in this section. Select the pencil icon to edit a column or click the arrows to reorder the column.

| Setting Name | Default | Function |
| --- | --- | --- |
| Field Name | [chosen data type variable] | Allows selection of which data type variable's data will populate this column |
| Title | [name of chosen data type variable] | Prompts for the name of the column |
| Is Visible | True | Toggles visibility of this column by end-user |
| Can Group | True | Toggles ability to group this column with others |
| Can Sort | False | Toggles ability to sort content within this column |
| Is Read Only | False | Toggles end-user editability at runtime |
| Width | 100 | Prompts for the width of the column |
| Allow Unsafe JavaScript | False | Toggles allowing Javascript code to populate this column supporting, for example, HTML |
| Allow Text Alignment | False | Toggles allowing text alignment options to the column |

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-07_15h38_55.png)
7. Save and close the Form Designer to return to the Flow Designer.
8. Select the Form to open its Properties. Under the INPUTS category, change the **Accounts**input mapping type to **Select From Flow**then select the output for the Get All step (Get All 1_ Output) and click DONE.  
![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-06-16_15h14_59.png)
9. Connect the Done path from the Form to the **End** step.

### Passing outputs from the Data Grid

Users can pass the output from the Data Grid to the subsequent steps in a Flow. This output may include data that users have interacted with. **Grid Mode** setting under the properties tab of the [Data Grid and Advanced Data Grid](https://documentation.decisions.com/v9/docs/advanced-data-grids) gives designers the ability to pass the user-interacted data as output. For more information, refer to [Using Grid Mode in Data Grid/Advanced Data Grid](https://documentation.decisions.com/v9/docs/using-grid-mode).

---

## Debug

1. On the top action panel, click **Debug.**
2. ****Click START DEBUGGING.After the debugger runs, the Form will display a data grid of accounts.  
![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-21_09h19_00.png)

---

For further information on Forms, visit the [Decisions Forum](https://community.decisions.com/categories/Forms).
