---
title: "Create form control - Configurable grid"
slug: "create-form-control-configurable-grid"
description: "Learn how to add a configurable grid to your form, customize its properties, and define queries for effective data management in mobile applications."
tags: ["Task", "Anywhere Mobility Studio"]
updated: 2026-03-20T12:47:00Z
published: 2026-03-20T17:46:51Z
canonical: "docs.staedean.com/create-form-control-configurable-grid"
---

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

# Create form control - Configurable grid

You can add a control of type **Configurable grid** to a form.

Compared to the data grid, a configurable grid uses a configurable query to query the data.

### Steps

1. Click **Mobility design**.
2. Click the **Forms** tab.
3. In the list, find and select the desired record.
4. Click **Edit**.
5. If you add a control, it is positioned before the selected control on the form.

On the preview, select the desired control.

> [!NOTE]
> **Note**
> 
> If the control list is shown instead of the preview, in the list, find and select the desired control.
6. On the **Properties** tab, click **Add**.
7. Click **Configurable** grid.
8. Sub-task: Define control properties.
  1. In the **Control** field, type the configurable grid name.

> [!NOTE]
> **Note**
> 
> Only use letters and numbers, no spaces.
  2. You can use an index to indicate which row in the grid must be selected when the grid is shown on a mobile device.

In the **Selected index** field, enter a number.

> [!NOTE]
> **Note**
> 
> Index numbering starts from 0. So, if the index is 0, the first row is selected.
  3. By default, the configurable grid is shown on the form.

If you want to hide the configurable grid on the form, select **No** in the **Visible** field.
  4. By default, the configurable grid can be used on the form.

If the configurable grid must be unavailable on the form, select **Yes** in the **Read-only** field. As a result, the configurable grid appears dimmed.
  5. By default, the next control is positioned on the same line.

If the next control must be positioned on a new line, select **Yes** in the **Append new line** field.
  6. On a configurable grid, you can use a variable as defined for the application or for the form.

By default, this field is empty. So, in the **Linked variable name** field, you can link an application variable to the configurable grid.

To link a form variable, in the **Linked variable form** field, enter or select the current form.
  7. You can link an application variable or a form variable to the check box.

In the **Linked variable name** field, enter or select a value.

> [!NOTE]
> **Note**
> 
> Make sure, the extended data type of the variable has the same type as the control.
  8. You can use the Preview field to enter some example data. This data is only used to be shown in the preview.

Use commas to separate the preview values for the columns. To show several records with preview data in the configurable grid, start a new line for each configurable grid record.

**Example**:

The configurable grid has these columns: Item, Quantity, Unit.

Preview values:

In the **Preview value** field, type the example values.
    - ItemA, 12, pcs
    - ItemB, 7, pcs
  9. Define the query for the configurable grid. The query gets the data to be shown in the configurable grid.

In the **Query** field, enter or select a value.
9. In the **Documentation** section, write the configurable grid control documentation. For example, describe the purpose and characteristics of the configurable grid control.
10. To show the added control on the preview, on the **Design** tab, click **Refresh**.

> [!NOTE]
> **Notes**
> 
> - In general, if you add a form control, it is positioned before the selected control on the form.
> - Where the control is exactly positioned on the preview, also depends on:
>   - The Append new line property of the previous control and of the added control.
>   - The preview style sheet.
> - You can use the **Up** and **Down** buttons on the **Properties** tab to move a form control to another position on the form.