Properties of a Tile control

The Tile control displays the total returned from a query in a compact way to display this information on a dashboard.

Note The Tile control is available for Desktop, Phone and Tablet forms.

Use the following tabs to configure the properties of a Tile control.


Name Description


The type of the control.


A unique name for the tile. (Default: Tile1)

Security token

Makes the information in the form secure. See Security tokens.


Makes the control visible at runtime. (Default: Selected)

Session ID

Global or form variable or form control that is used as session ID.


Optional. The query that is used by the tile control at runtime. Available options: Workqueue query, Job query, System query.

  • If you do not set a query and load the form at runtime, the control appears but the number is not displayed.

  • If you set the query dynamically, the control appears at runtime and the query is applied when the action executes and displays the total returned from the query result in the tile.


The title of the tile control to display at runtime. (Optional)

Item description

The description of the tile control to display at runtime.


The image to display on the tile at runtime. Select an image from the store such as home.png. (Optional)

Image width

The width of the image on the tile. (Default: 40%)

Default color

The default color used for the tile. (Default: Blue)

Conditional color

Allows the user to define multiple rules to apply to change the color based on the query result. For example:

  • Count greater than 10 = Green

  • Count greater than 40 = Amber

  • Count greater than 70 = Red

To add a conditional color rule for the tile control:

  1. Click

  2. On the Count greater than list, select a value.

  3. On the Color list select a color.

  4. Click Add.

    Note If a conditional color rule is not applicable, the default color is applied.

Refresh interval

The interval at which the tile control should be refreshed automatically. (Default: 5 minutes)

  • When you click the Tile, the Clicked event is fired and the configured actions are executed. For example, when you configure a Redirect action, you are redirected to a form that has a Job, Work queue or Workload control with the query details and count on the tile.

  • You must use the Update control properties action to set the DynamicQueryName, DynamicQueryID, DynamicFilterField, DynamicFilterValue or DynamicQueryType properties.

  • When you add a form with the Tile control to a package with associations, the queries used by the control are added to the package.