FSM Mobile Element Properties

A Field Service Management (FSM) Mobile element property is a configuration setting that controls an element's displayed label, stored value, validation, appearance, or input behavior. Most FSM Mobile elements support common and element-specific properties. The following tables define each property and list supported element types, value formats, accepted values, expression support, and default values.

Common Element Properties

The following table lists common FSM Mobile element properties and describes value formats, accepted values, expression support, and default values.

Property	Description	Value Property Format	Accepted Values	Expression Support	Default Value
type	Specifies the element type.	String	One of the types listed in FSM Mobile Element Types. FSM Mobile treats an invalid or omitted type as text.	No. This property defines element structure.	text
name	Specifies the stable identifier that stores and references the element value.	String	A unique element identifier within its form or table.	No. This property defines element structure.	No default. Configure this property.
parent	Identifies the parent table that owns this column element.	String	The name of a top-level table element. The referenced element must use "type": "table". Omit parent for top-level elements.	No. This property defines element structure.	Omitted for top-level elements.
value	Sets a static default for a new record or a calculated value when configured as an expression. A static value doesn't replace a saved value when an existing record opens.	Type-specific	See the element value format in FSM Mobile Element Types.	Yes. The result must match the element value format.	Type-specific. See FSM Mobile Element Types.
label	Specifies the label displayed with the element.	String	Any display text.	Yes. The result must be a string.	""
required	Requires a non-empty accepted value before the form can be completed.	Boolean	true, false	Yes. The result must be a Boolean value.	false
disabled	Displays the element but prevents input.	Boolean	true, false	Yes. The result must be a Boolean value.	false
hidden	Hides the element.	Boolean	true, false	Yes. The result must be a Boolean value.	false
readonly	Displays the value but prevents editing.	Boolean	true, false	Yes. The result must be a Boolean value.	false
class	Specifies additional supported style class tokens. Use only documented styling tokens.	String	A string containing supported class tokens.	Yes. The result must be a string.	""

Element-Specific Properties

The following table describes properties that apply only to specific FSM Mobile element types. Each property is supported only by the element types listed in the Supported Element Types column.

Note:

Starting with version 2026.07.2, review existing Number element definitions and replace "step": "any" and "precision": null with supported values. If either value remains configured, FSM Mobile normalizes the value, which can change the element's behavior.

These updates apply to static configuration values. If a Number property uses an expression, the result must also match an accepted value for that property. For the replacement values and normalization behavior, see FSM Mobile Number Element Properties.

Property	Description	Supported Element Types	Accepted Values	Expression Support	Default
accept	Sets the file-type filter shown in the browser file picker.	file, image	A comma-separated list of file extensions or MIME-type specifiers. For example, configure "accept": ".pdf,.docx" or "accept": ".jpg,.jpeg,.png".	Yes. The expression must return a string.	file: Omitted, so no picker filter is applied. image: .bmp,.gif,.jpg,.jpeg,.pjpg,.pjpeg,.png,.tiff,.tif
autoselect	Selects the only option automatically when no option is marked as selected. Applies only to single-select lists.	select	true, false	Yes. The expression must return a Boolean value.	false
barcode	Enables device barcode scanning when the device browser provides camera access.	select, text	true, false	Yes. The expression must return a Boolean value.	false
camera	Enables image capture from the device camera.	image	true, false	Yes. The expression must return a Boolean value.	false
column	Controls whether a table child appears in the table column list and determines the display order.	Any direct child of a table element	Include the property with a number, such as "column": 1, to include and order the column. Omit the property to exclude the child from the column list. null still counts as a configured column property.	No. This property controls table structure.	Omitted unless resource normalization adds a column position for a visible element.
cols	Sets the visible text width.	html, textarea	Positive integer	Yes. The expression must return a positive integer.	null
downsample	Sets the maximum width or height, in pixels, for supported bitmap images before upload. FSM Mobile preserves the image proportions. This property does not set a file-size limit.	file, image	A positive whole-number pixel value, such as 1080.	Yes. The expression must return a positive integer.	The resource imagesize value. The standard FSM Mobile default is 1080 pixels.
height	Sets the signature input height.	signature	Positive pixel value	Yes. The expression must return a positive integer.	148 pixels
level	Sets the heading level.	heading	1, 2, 3	Yes. The expression must return an integer from 1 through 3.	1
max	Sets the maximum permitted value.	date, datetime, number, time	A number for number. For other supported element types, use the canonical value format for the element type.	Yes. The result must match the element type.	null
maxlength	Sets the maximum character count.	html, text, textarea	Positive integer	Yes. The expression must return a positive integer.	null
maxsize	Sets the client-side size limit, in kilobytes (KB), for non-bitmap files selected through a File element. An Image element does not apply this property. Recognized bitmap files selected through a File element are downsampled and bypass this limit.	file, image	Positive whole-number KB value	Yes. The expression must return a positive integer.	10240 KB (10 MB). An Image element does not apply this value.
min	Sets the minimum permitted value.	date, datetime, number, time	A number for number. For other supported element types, use the canonical value format for the element type.	Yes. The result must match the element type.	null
multiple	Allows the selection of more than one option.	select	true, false	Yes. The expression must return a Boolean value.	false
options	Defines the options that a Select element presents.	select	A static list must be an array of option objects. A configured option source or expression must resolve to an array of option objects. See Configuring the Select Options Property.	Yes. The expression must return an array.	[]
pattern	Validates input against a regular expression during article validation. Email retains the built-in live email-format check. A configured pattern does not replace that check in the editable Email input.	email, password, tel, text, url	A valid regular-expression source string	Yes. The expression must return a valid regular-expression string.	"" (no configured pattern validation)
placeholder	Displays hint text when the field has no value.	email, html, password, select, tel, text, textarea, url	String	Yes. The expression must return a string.	""
precision	Sets the maximum decimal places for entry and display when no unit precision or step display precision applies.	number	A whole number from 0 through 8	Yes. The expression must return a whole number from 0 through 8.	8
remote	Retrieves Select options remotely instead of supplying options only through options.	select	true, false	Yes. The expression must return a Boolean value.	false
rows	Sets the visible text height.	html, textarea	Positive integer	Yes. The expression must return a positive integer.	3
search	Enables searching in the Select list.	select	true, false	Yes. The expression must return a Boolean value.	false
step	Sets the permitted increment.	date, datetime, number, time	A positive number for number. Use a positive whole number for date and time values. The date element uses days. The datetime and time elements use seconds.	Yes. The result must meet the increment rule for the element type.	date and number: null datetime: 1 time: 60
stepper	Shows numeric increment and decrement controls.	number	true, false	Yes. The expression must return a Boolean value.	false
text	Provides display text for a read-only URL. The URL remains the value.	url	String	Yes. The expression must return a string.	""
unit	Selects the unit used to format a number for display.	number	Unit identifier string	Yes. The expression must return a string.	""
width	Sets the signature input width.	signature	Positive pixel value	Yes. The expression must return a positive integer.	448 pixels

Property Support by Element Type

The following table shows property support for each element type. In the Common Properties column, Supported indicates that the element accepts the complete common property set. If an element accepts only specific common properties, the column lists those properties. For more information about common properties, see Common Element Properties.

The Additional Supported Properties column lists type-specific properties. Any direct child of a table element can also use column.

Element Type	Common Properties	Additional Supported Properties
checkbox	Supported	None
date	Supported	min, max, step
datetime	Supported	min, max, step
email	Supported	pattern, placeholder
file	Supported	accept, downsample, maxsize
heading	type, name, parent, label, hidden Warning: For review	level
html	Supported	rows, cols, maxlength, placeholder
image	Supported	accept, camera, downsample, maxsize
number	Supported	min, max, precision, step, stepper, unit
password	Supported	pattern, placeholder
select	Supported	multiple, autoselect, barcode, options, placeholder, remote, search
signature	Supported	width, height
table	Supported	None. The table element is the only supported parent element type. Direct child elements use the table's name as parent.
tel	Supported	pattern, placeholder
text	Supported	barcode, maxlength, pattern, placeholder
textarea	Supported	maxlength, rows, cols, placeholder
time	Supported	min, max, step
url	Supported	pattern, placeholder, text

This layout is intentional for customer documentation: the common-property table defines every common property once, the type-specific-property table defines each property's accepted values and default once, and this matrix answers the per-type 'is it supported?' question without repeating 170 identical cells.

Related Topics

• FSM Mobile Element Configuration
• FSM Mobile Element and Property Configuration Conventions
• FSM Mobile Element Types
• FSM Mobile Element Property Validation Rules
• Configuring Select Element Options in FSM Mobile

General Notices