--- title: Input form screen attributes for inputs description: Different types of inputs are available for use in input form screens, and you can use different attributes to configure the inputs. locale: en-US canonical_url: https://www.servicenow.com/docs/r/australia/mobile/parameter-screen-var-attr.html release: australia topic_type: reference last_updated: "2026-03-12" reading_time_minutes: 20 breadcrumb: [Configure inputs, Configure an input form screen, Input form screen, Mobile screen types, Mobile screens, Mobile app components, Building mobile apps, Mobile Platform] --- # Input form screen attributes for inputs Different types of inputs are available for use in input form screens, and you can use different attributes to configure the inputs. Use input attributes to define the appearance and set limitations on your inputs. Examples include setting minimum and maximum values, or displaying an input value as a percentage. **Note:** All attributes are case-sensitive. ## General attribute You can use this attribute with any input form screen, regardless of the input type.
| Attribute | Description |
|---|---|
| **DescriptionRenderType** | Define a render type for the input description.**html**: Enables you to use HTML tags to format the text in the **Description** field of your input. |
| DataSourceId | Define this attribute whenever you create a data source mechanism to load input values. For more information, see [Data sources](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/mobile/data-sources.md).**Note:** This attribute is not supported with signature inputs. |
| ElementIdentifier | Define this attribute whenever you create a data source mechanism to load input values. For more information, see [Data sources](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/mobile/data-sources.md).**Note:** This attribute is not supported with signature inputs. |
| Use attachment inputs to enable users to attach files in an input form screen. Attachment inputs require a scripted action item and an **actionResult** object to upload a file. **Note:** Attachment inputs are only supported for scripted actions. | \[Omitted image "param-input-attachment-1.png"\] Alt text: Attachment input example. |
| Attribute | Description |
|---|---|
| **HiddenAttachmentSources** | Decide where you don’t want images sourced from. Select one of the following source values: `camera`, `files` or `gallery`, from the **Value** field.**Note:** To avoid images and files being obtained from more than one source, add additional **HiddenAttachmentSources** attributes after you save the attribute you are currently configuring. |
| Attribute | Description |
|---|---|
| **MaxEntries** | Used only for configuring multi-scanning and multiple groups of barcodes. Sets the maximum number of barcodes that a user can scan at a time. For example, you can set the value to `5` to enable users to rescan 5 times.**Note:** Use this attribute for multi-scan barcode inputs only. If your barcode input is intended for single scans, no attribute is required. |
| Use Boolean inputs for inputs with true or false values. You can configure Boolean inputs to appear either as a check box or as a toggle switch. | \[Omitted image "param-input-boolean-1.png"\] Alt text: Examples of boolean inputs configured as a check box or toggle switch. |
| Attribute | Description |
|---|---|
| **RenderType** | Specify a render type for the Boolean input.- **Checkbox** Displays the input as a check box. - **toggle** Displays the input as a toggle. |
| Use choice inputs to give your users options to select from. You can create these choices manually or use an existing table and field to provide the choices. Configure a choice input to enable users to select a single choice, or multiple choices. The option to select more than one chip in a category is marked by a + sign on the chips. Define the number of chips to display, enabling the user to see all options available on a single input form screen. If the defined number of chips to display exceed the defined amount, a **See all** button is displayed. Tap on the **See all** button to open a page with all the options listed. | \[Omitted image "inline-choice.png"\] Alt text: Single and multiple choice input options on input form screen. |
| Attribute | Description |
|---|---|
| **MultiSelect** | Option to enable users to select multiple choices for the input. The value must be **true** or **false**. Multi-select options are indicated with a "+" sign on the chip. |
| **Table** | The table where the choice field is located.**Note:** Use this option to use the choices in an existing table and field rather than manually creating choices. You must select a field on this table using the **Field** attribute. |
| **Field** | The field that contains your choices.**Note:** Use this option to use the choices in an existing table and field rather than manually creating choices. The field defined in this attribute must be on the table defined in the **Table** attribute. |
| **Inline** | Option to select how to display your choice inputs. By default, the value is **false**, meaning that the choice display is on the same screen, removing the need to navigate to a separate screen. For a visual example, see the image in the Choice inputs introduction.If you select **true**, a list-type option displays where users are required to navigate to an additional screen, after a selection is made. \[Omitted image "param-input-choice-1.png"\] Alt text: Inline choice option showing the need for a secondary selection screen. |
| **InlineMaxItems** | Option to define the number of chips to display within an input form screen section. The following inputs in the **Value** field are available:- Empty: Displays the default of up to 8 choice values. If there are more choices than 8 choice values, the **See all** button displays. - Negative numerical value: Displays all the choice values, even if it exceeds 8 values. - Positive numerical value: Displays the number of choice values defined. If there are more choices than the entered numerical value a **See all** button displays. The following image illustrates a scenario where 8 is the value entered and there are 12 choice values. The first screen displays 8 values. When the user taps the **See all** button, a new screen opens with all the 12 choice values displayed.\[Omitted image "inline-choice-see-all.png"\] Alt text: Choice list with See all button. |
| **RenderType** | Option to render the choice options as an image for the choice input. The value must be `image`. |
| **EnableSearch** | Option to display the search bar. The value must be **true** or **false**. |
| **SearchPlaceholder** | Text that appears in a search bar as a placeholder. |
| **SearchType** | Defines the query used for search. The value can be `starts_with` or `contains`. If this attribute isn’t configured, the instance uses **starts\_with** by default on the display label column. |
| Use custom map inputs to add a link to an indoor map in your mobile app. Users can use these maps to get directions to and reserve resources such as desks, meeting rooms, or lockers. Admins can also configure a parametrized data item with query conditions that enable sorting and filtering of the custom map input. **Important:** Custom map inputs that support parametrized data items must only use the **ScreenId** attribute. Don't use any other type of attribute for custom map inputs that support parametrized data items. If you're modifying an existing custom map input that uses the advanced reference qualifier to use a parametrized data item, use the **ScreenId** attribute only and remove all other attributes. | \[Omitted image "input-form-custom-map-input.png"\] Alt text: Shows how the custom map input is displayed in a mobile app where you select 'Next' to view the map. |
| Attribute | Description |
|---|---|
| **CustomMapConfigId** | The sys\_id of the sys\_sg\_custom\_map\_config table. |
| **CustomMapDefaultProviderId** | The sys\_id of the provider record in the sys\_sg\_custom\_map\_provider table. |
| **CustomMapInputs** | The sys\_id of the floor in the sys\_sg\_input table. This value must be entered as a JSON array. |
| **ScreenId** | The sys\_id of a parameterized data item used to sort and filter custom map inputs.**Important:** This attribute can't be used with any other custom map input attribute. If you use the **ScreenId** attribute with a custom map input, don't use any other attributes with the input. |
| **TargetTable** | Set to `sn_wsd_core_space`. |
| Use date/time inputs to enable your users to input date and time values. You can configure the input for date and time, or date only. | \[Omitted image "param-input-datetime-1.png"\] Alt text: Examples of date and date time configurations. |
| Attribute | Description |
|---|---|
| **RenderType** | Specify a render type for the date/time input.- **date-time** Displays date and time. If no RenderType is defined, this option is the default. - **date** Displays only the date. |
| **IncludeTimezone** | The time zone of the mobile device where the input is being added. The value must be **true** or **false**. When set to **true**, the mobile client sends the Device Time Zone information along with the date and time value to the back-end instance in the following format: YYYY-MM-DDThh:mm:ss.sssTZD **Note:** The Device Time Zone is different from the User Profile Time Zone that is configured on the platform. If this attribute is not configured, the mobile client doesn't include Device Time Zone information in the date/time input values. This behavior is the default. The date/time input values are in the following format: YYYY-MM-DD hh:mm:ss For information about setting up the IncludeTimezone attribute of date/time inputs for different action types, see [Date/time input setup for different action item types](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/mobile/datetime-input-setup-4-action-items.md). For information about action item types, see [Configure an action item](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/mobile/sg-studio-create-action-item.md). |
| **MaxRangeDays** | Optional attribute that determines whether future dates can be selected when a date/time input is added. This attribute supports both positive and negative integer values. Setting **MaxRangeDays** to `0` prevents users from selecting future dates and restricts them to current or past dates. **Note:** **MaxRangeDays** can be used together with **MinRangeDays**, **MaxRangeHours**, and **MinRangeHours**. |
| **MinRangeDays** | Optional attribute that determines whether past dates can be selected when a date/time input is added. This attribute supports both positive and negative integer values. Setting **MinRangeDays** to `0` prevents users from selecting past dates and restricts them to current or future dates. **Note:** **MinRangeDays** can be used together with **MaxRangeDays**, **MaxRangeHours**, and **MinRangeHours**. |
| **MaxRangeHours** | Optional attribute that determines whether future hours can be selected when a date/time input is added. This attribute supports both positive and negative integer values. Setting **MaxRangeHours** to `0` prevents users from selecting future date times and restricts them to current or past date times. **Note:** **MaxRangeHours** can be used together with **MaxRangeDays**, **MinRangeDays**, and **MinRangeHours**. |
| **MinRangeHours** | Optional attribute that determines whether past hours can be selected when a date/time input is added. This attribute supports both positive and negative integer values. Setting **MinRangeHours** to `0` prevents users from selecting past date times and restricts them to current or future date times. **Note:** **MinRangeHours** can be used together with **MaxRangeDays**, **MinRangeDays**, and **MaxRangeHours**. |
| Use number inputs to enable your users to enter numerical values. Define optional minimum and maximum values to define a number range for your input. You can optionally configure a number input to appear as a percentage. By default, number inputs support decimals. To have the basic box input for a number, within an Input record, complete all the mandatory fields and select **Number** in the **Input type** field. | \[Omitted image "ifs-number-box.png"\] Alt text: Examples of number inputs configured as a numerical or percentage values. |
| Attribute | Description |
|---|---|
| **CustomErrorMessage** | Sets a custom error message that you can specify. This message displays when the associated UI rule condition is met. |
| **Max** | Specify a maximum value for the input. |
| **Min** | Specify a minimum value for the input. |
| **RenderType** | Specify a render type for the number input.- **integer** Displays whole integers, such as `3`, `1003`, or `57`. When **integer** is used, end users can only enter integers and can't enter decimals. \[Omitted image "ifs-number-box2.png"\] Alt text: The render type called integer showing an input called Number of outlets with a value of 60. - **line** Displays the input as a line field. \[Omitted image "ifs-number-line.png"\] Alt text: The render type called line showing an input called Subscription duration in months with a value of 73. - **percentage** Displays a percent symbol\(%\) after the number in the input. \[Omitted image "ifs-number-percent.png"\] Alt text: The render type called percentage showing an input called Interest rate in percentage with a value of 8%. - **slider** Displays the input as slider value and a box input. For more information about sliders and how to configure them, see [Configure a slider option for a number input](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/mobile/configure-slider.md). \[Omitted image "ifs-slider-float-step-size.png"\] Alt text: The render type called slider showing an input called Weight of package in kilograms with a value of 44.25. **Note:** For a table showing which attributes can be used with which render type, see [Number render types and compatible input attributes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/mobile/number-compatible-input-attributes.md). |
| **SkipValidationWhenHidden** | **Note:** This attribute can only be used with line and percentage render types. Can be set to either `true` or `false`. It's set to `false` by default, which means that by default the associated UI rule validation is run on the hidden inputs. Only set this to `true` when you want to skip the validation on hidden inputs. |
| Attribute | Description |
|---|---|
| **DefaultValue** | The value displayed when the user first views the slider. If no value is entered, the value displayed is zero. The default value must be between the min and max values. **Note:** This defined value is the the starting point, unless a loading mechanism, which takes priority, is configured. See, [Loading mechanisms for input form screens](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/mobile/loading-mechanisms.md). |
| **StepSize** | The size of each step on the slider. The steps must be a number divisible between the max and min number. For example the min number is 20 and the max number is 80, the StepSize can be numbers like 2, 5, or 10. |
| **ReferencePoint** | When set to **true** a marker is added to the slider, providing a visual reference point for the user.**Note:** For the sake of visual clarity, this input attribute should not be used with the input attribute VisualStepsEnabled. |
| **VisualStepsEnabled** | When set to **true** the slider displays visual increments based on the specified StepSize input attribute.**Note:** For the sake of visual clarity, this input attribute should not be used with the input attribute ReferencePoint. |
| **EnforceStepSize** | When set to **true** users are unable to enter a value in the number box that does not align with the StepSize value. |
| **Decoration** | Defines sections on the slider with corresponding labels that appear when a user taps a section or enters a value. Each section can be associated with a specific color to aid visual representation. For more information, see [Configure a slider option for a number input](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/mobile/configure-slider.md). |
| Use ranking inputs to enable your users to sort the available choices in order of preference or priority. Users tap and drag the available choices. Choices for the ranking input must be manually defined. | \[Omitted image "param-input-ranking-1.png"\] Alt text: Ranking input example. |
| Attribute | Description |
|---|---|
| **IsOverlay** | Sets whether the signature input is opened in a half modal window. You can set the **Value** to `true` or `false`. A value of **true** configures the signature to open in a half modal window.**Note:** If the signature input is configured as the only input on a page and the **isOverlay** attribute is set to `true`, the **isOverlay** attribute is ignored, and the signature input is displayed in the full screen. |
| Use string inputs for text input. You can define a maximum character length for this input. | \[Omitted image "param-input-string-1.png"\] Alt text: String input example. |