Working with Widgets > 2D > Data Grid
Data Grid
What Does This Widget Do?
The Data Grid widget allows you to select columns to display data in a grid.
Data must be bound to the Data Grid.
When Should I Use This Widget?
Use a Data Grid when you want to display your data in a grid format.
Are There Any Special Properties, Services, Events, or Actions?
To view a list of common widget properties, services, and events, see Common Widget Properties, Services, and Events.
The following tables list properties, services, and events that are specific to this widget.
When the Data property is bound to a service result, you can select columns to display in the Data Grid widget.
Enable State-Based Formatting
Allows you to format the widget based on state definitions that have been defined in ThingWorx.
If the checkbox is selected the following properties appear:
Dependent Field
State Definition
For example, if a label has a State Definition value of error, the label turns red.
For more information about style and state definitions in ThingWorx, see Style and State Definitions in the ThingWorx Help Center.
Header Class
The CSS class assigned to the header of the widget.
Horizontal Alignment
(Column property)
Specifies the horizontal alignment of a column.
Vertical Alignment
(Column property)
Specifies the vertical alignment of a column.
The Widget in Action
Here’s an example of what your widget might look like!
Minimum Steps Required for Use
What It Looks Like
1. Drag and drop a Data Grid widget onto the canvas.
2. From the Data pane, add a service from the entity you wish to retrieve the data from.
3. Once the service has been added, drag and drop All Items onto the widget and select Data on the Select Binding Target window.
4. In the DETAILS pane, under Data, select the columns you want to display.
Style the Widget with CSS
You can use CSS to style the widget! The following is an example:
Keep in mind that it’s best to give your classes unique names so they do not conflict with other classes or OOTB properties.
CSS Example
What It Looks Like
.ptc-DataGrid th {
background-color: yellow;
font-size: 22px;
opacity: 1;
font-family: Century Gothic;

.ptc-DataGrid tr {
background-color: #00acc8;
border: none;
font-family: Century Gothic;

.ptc-DataGrid .item-row:hover {
background-color: #fff;

.ptc-DataGrid .item-row.selected {
background-color: #fff;
For more information, see Application Styles.