Item-Specific App Properties

Last updated: September 24, 2026Applies to current supported NIM releases

NIM Apps · Item reference

Select a form item in the App designer to configure the properties specific to that item type.

All form items can also expose shared settings. See Generic App Properties for shared appearance, data processing, rendering, and validation settings.

Button

Property	Description
Button size	Displays a small, medium, or large button.
Button style	Selects a preset style from App Settings.
Button text	Sets the text shown on the button.
Cancel button	Makes the button the form's default cancel action; pressing Esc runs its actions.
Default button	Makes the button the form's default action; pressing Enter runs its actions.
Fit column	Stretches the button to the full column width.
Icon left/right	Adds an icon before or after the button text.
Progress message	Controls whether a progress message appears, plus its title, contents, and delay in milliseconds. Contents can use the JavaScript editor and variables.
Solid background	Enables a solid button background.
Disabled if form invalid	Prevents click, Enter, and Esc actions while required form validation is invalid.

Card

Cards are intended for Reports. Configure Report Categories before using category-based card colors.

Property	Description
Number categories	Uses a Report Category and its assigned chart color.
Numeric variable	Uses a variable value when no number category is selected.
Color background/border	Selects preset background and border colors from App Settings.
Line 1–4 text	Sets the text for each card line; double-click to use the JavaScript editor.
Line 1–4 color/enabled/heading	Controls color, visibility, and heading size from H1 through H6 for each line.
Line 1–4 evaluation/example	Evaluates line text with JavaScript and supplies fallback text until a variable has a value.
Text layout	Displays enabled lines as Stacked rows or Columns.

Checkboxes

Property	Description
Boolean variables	Generates an output variable for every checkbox instead of only the selected value.
Boolean variables prefix	Adds a prefix to each generated checkbox variable, such as cb_1.
Table based	Uses a filter, auditing query, or lookup-table result instead of static values.
Table display/value column	Chooses the displayed column and the value written by the App when Table based is enabled.
Values	Supplies static comma-separated values when Table based is disabled.
Button styles/label styles	Opens CSS editors for checkbox buttons and labels.
Checkbox margin/padding TRBL	Sets top, right, bottom, and left spacing with a four-digit value from 0000 through 5555.
Column count	Sets the number of columns used to arrange the checkboxes.
Group/group button color	Presents checkboxes as a Bootstrap button group and controls its color.

Chart

Property	Description
Data series	Configures the data shown by the chart.
Card	Adds a card-style border around the chart.
Chart type	Selects bar, doughnut, line, or pie.
Height	Sets chart height with CSS units such as px, em, or rem.
Legend show/position	Shows or hides the legend and places it at the top, bottom, left, or right.
Segment border color/opacity	Configures the line between chart segments. Opacity ranges from 0 to 1; the default is 0.6.

Dashboard navigation & search

Item	Property	Description
Dashboard Navigation	Target Dashboard	The ID of the target dashboard; available only in a dashboard-style App.
Dashboard Search	Target Dashboard	The ID of the target dashboard; available only in a dashboard-style App.

Date & empty column

Item	Property	Description
Date	—	Uses the shared generic properties.
Empty Column	Height	Sets the column height with CSS units such as px, em, or rem.

Dropdown

Property	Description
Multiple select	Lets users select multiple options and stores the result as an array.
Table based	Uses a filter, auditing query, or lookup-table result instead of static values.
Table display/value column	Chooses the displayed column and the value written by the App when Table based is enabled.
Values	Supplies static comma-separated values when Table based is disabled.

Grid

Property	Description
DND Grid	Enables drag-and-drop movement between selected drag-and-drop grids.
Key column	Defines the key column for each grid row.
Selection	Allows a single selected row or multiple selected rows; multiple selections produce arrays.
Border radius elements/grid	Sets CSS border radius for grid elements or the outer grid.
Border size bottom/top	Sets the spacing between column headers and the border below them.
Data-heavy theme	Reduces row and column spacing to show more data without scrolling.
Font/header color & weight	Sets grid and header text colors, plus header weight from light through bold.
Height	Sets grid height with CSS units such as px, em, rem, or vh.
Link styles	Opens a CSS editor for items configured as table-view navigation links.
Padding inside TRBL	Sets spacing between the outer grid border and its content.
Search enable/columns/padding TRBL	Shows the search bar and controls its width and spacing. Width uses a 1–12 grid scale.
Spacing	Sets spacing between and around grid elements.
Title enable/text/columns/styles	Shows a title and controls its text, maximum width, and CSS styling.

Grid control & grid search

Item	Property	Description
Grid Control	Target Grid	The ID of the grid it controls.
Grid Control	Link styles	CSS editor for grid navigation links.
Grid Search	Target Grid	The ID of the grid it searches.
Grid Search	Rounded look	Rounds the search bar corners.

Icon & image

Item	Property	Description
Icon	Size	Selects an icon size from XXS through X9L.
Icon	Icon	Selects an icon from the preset list.
Icon	Settings	Configures primary and secondary colors, opacity, icon type, and background shape.
Image	Image	Selects an image; use Add to import an image.

Input text

Property	Description
Auto complete	Shows the first 20 results from a table.
Number	Restricts input to numbers and permitted symbols: ., +, and -.
AC delay/display/list columns	Controls the autocomplete delay, displayed columns through JavaScript, and whether the full referenced table is shown.
Multiline/line count	Turns the input into a multi-line field and sets the number of visible lines. Multiline overrides autocomplete.
Password/password visible toggle	Masks input and can provide an icon to show or hide it.
Placeholder	Shows text before a user enters a value.
Email, max/min length, pattern	Validates email format, length limits, or a regular expression.

Name-value list

Property	Description
Items	Configures each name, value type, and value. Value type can be text or JavaScript.
Border	Adds a border around the list.
Item name/value columns	Sets widths on a 1–12 scale. The combined widths cannot exceed 12.
Item name/value font settings	Sets font size, weight, italic, and underline for names and values.

Panel

Property	Description
Apps	Displays all Apps in the panel and supports another dashboard-style App.
Icon settings	Available when Apps is enabled; applies icon settings to every App displayed in the panel.

Progress bar

Property	Description
Display text	Uses the JavaScript editor to show workflow progress text.
Type evaluated/fixed	Sets the style through JavaScript or a fixed success, info, warning, or danger color.
Value/value maximum	Sets current progress against the completion maximum. For example, use 5 for a five-form workflow.

Separator

Property	Description
Line height	Sets the distance between the row border and separator line.
Margin top/bottom/left/right	Sets separator spacing with CSS units. Left and right margins shorten the line.

Static text

Property	Description
Color settings default	Uses the App's default text color.
Display heading	Selects heading size from H1 through H6.
Font size	Sets font size with CSS units such as px, em, or rem.
Text/text evaluation	Sets static fallback text or uses the JavaScript editor to evaluate variables and render a result.
Text color	Selects a preset or custom color when Color settings default is disabled.