Configure a parameterized record screen

Configure a record screen to query a user for a parameter. The screen then uses this parameter to determine the record that appears on the screen.

Before you begin

Role required: admin

Procedure

Navigate to All > System Mobile > Mobile App Builder.

The Mobile App Builder
Search for the application scope you are working in and then select the name of the application scope.

The Mobile App Builder
Select the Screens category, and then select New.
Select the Record option in the Create a screen page, and then select Continue.
Complete the following fields as needed.

Field	Description
Name	The name of your screen. This name appears as a tile in the mobile application.
Description	Additional information about your screen.
Fetch type	Settings that determine when data is loaded in your screen. Select from the following fetch types: Prefetch: This option pre-loads record screen data when an end user accesses a list, calendar, or record screen. On-demand: The app sends a network request to load the app only when end users navigate to it. Background: The app makes a background network request to load embedded screens or record screen segments. Dynamic prefetch: Screens for the first 10 rows load as described for the Prefetch fetch type. After the 10 first rows load, additional rows of screens load with the On-demand fetch type.
Dynamic prefetch count	You can change the number of rows loaded with prefetch by changing the value of the Dynamic prefetch count field.
Hide screen name	Option to hide the record's screen name.
View using (Legacy Card/Card)	A Card used for the header section of the record screen. Use the Mobile Card Builder to change the appearance of your mobile card or the fields displayed on the card. For more detail on using the Mobile Card Builder, see Customize a screen using Mobile Card Builder. The best practice is using Card.
Card	This is an element that visually displays information from different records. You can style this information by setting specific conditions for each information type.
Icon	Icon that appears in the header of the launcher screen.
Alert	This is a mobile alert overlay for a record screen. Use it to inform users of an important message and to redirect them to a specific screen. Only one mobile alert is available per instance.
Data item	This defines what table you want data from and what conditions must be met for the data to be displayed.
Record screen segments	This is a UI element for switching between different lists on a single record screen. Use it to divide content into different areas on the screen.
Dynamic segments height	Sets the height for dynamically sized segments.
Dynamic segments minimum width	Sets the minimum width for dynamically sized segments.
Top menu function instances	Functions placed in the top menu of the record screen.
UI parameters	This is a variable that affects how a field or UI element behaves. Use it to determine how a value can be entered or if it will be autopopulated for a UI element based on what the user has done.
Dynamic screen title	This is how you can create an element and map it to a UI parameter. Use it to pass a value from one screen to another and include it in the title of the destination screen.
Role access	Option to limit user access to the screen by role.

6. On the Record screen form, select an existing data item or create a new one.

Field	Description
Name	Name of the data item.
Description	Additional information about your data item.
Table	Table where the data item gets its data from.
Group by	Determine what values the table will be grouped by.
Condition Type	Whether the conditions for the data item are declarative, scripted, or use an encoded query. Leave this field at its default setting.
Offline condition	Conditions to apply when the user sets the app to offline mode.
Parameters	Data Parameter used for filtering the data item. Use parameters to accept values passed from screens or other sources.

7. In the Data item screen, create a new data parameter by selecting the **New** button in the Parameters field.

In the New Data Parameter screen, enter a name for your parameter in the Name field, and select the parameter Type.

The available types are Integer, String, Decimal, Boolean, Datetime, or Date. For more detail on available options when creating parametrized data items, see Configure a parametrized data item.
Use the left panel hierarchy tree to return to the data item you just created a data parameter for.

In the Condition field, create a query that uses your parameter to filter your records.
Use the left panel hierarchy tree to return to the Record Screen and select New in the UI Parameters field to create a new parameter.
In the Properties section, enter a name for the UI parameter.
In the Setting section, fill in the following fields.

Field	Description
Input type	How your users enter a value for this parameter. Select from the following options: Text Choice List Search List QR/Barcode
Table name	Table used for the choice list where users select a parameter value.Note: This field is visible only when Input type is set to Choice list or Search list.
Field name	The field used for the choice list where users select a parameter value.Note: This field is visible only when Input type is set to Choice list or Search list.
Default value	Default value for your parameter.Note: This field is only visible when Default value type is set to Manual.
Input style	Input style for your parameter. Select from Inline or Popup.
Default value type	Whether the parameter has a default value. Select None to have no default value, or Manual to enter a manual value in the Default value field.
Mandatory	Determines whether user input for the parameter is mandatory.
Placeholder text	Text that appears in the parameter entry field before the users enters a value.
Multi-select	Whether the user can select multiple values from the choice list.Note: This field is visible only when Input type is set to Choice list.
Search type	The type of search used when finding a parameter value.Note: This field is visible only when Input type is set to Search list.
Carried	Whether this parameter a carried parameter. Use carried parameters to move information between different screens and actions.

13. In the **Data Parameter Mapping** section, select the **Choose** button to create a new parameter mapping.

Select the data parameter you created for the data item.
Select Apply.
Select Save.

Result

The UI parameter in your form is associated with the data parameter in your data item. When a user accesses this form, the screen prompts the user for a value for the parameter. The data item uses that value to filter the record displayed in the form.

title	Configure a parameterized record screen
description	Configure a record screen to query a user for a parameter. The screen then uses this parameter to determine the record that appears on the screen.
locale	en-US
canonical_url	https://www.servicenow.com/docs/r/mobile/configure-param-form-applet.html
release	brazil
topic_type	task
last_updated	2026-09-10
reading_time_minutes	5
breadcrumb	Record screenMobile screen typesMobile screensMobile app componentsBuilding mobile appsMobile Platform