Add a quick action in your mobile applications
Provide your users with a shortcut, which is also known as a quick action, to an item or action in your mobile apps. Quick actions appear on the applet launcher page.
Before you begin
Role required: admin
About this task
Procedure
Navigate to All > Now Mobile App > Applet Launchers.
In the applet launchers [sys_sg_applet_launcher] table, open the applet launcher record that you would like to add the catalog item to.
For example, open the Homepage record to add the catalog item under the
Plus icon icon on the home page.
Select the Body tab.
Add a record under the Quick Actions Menu Maps related list.
If you're not able to insert a row, make sure that you're in the ServiceNow Now Mobile App Screens and Applet Launcher application scope.
Add one of the quick actions from the following options.
Quick action Description Report an Issue Opens the Create Incident catalog item. Chat Opens Agent Chat.
Result
Your users can open the quick action by selecting the
Plus icon icon on the applet launcher page.
Parent Topic:Configuring Now Mobile
Create a quick action in your mobile applications
Provide easy access to an important item by creating a quick action. For example, you can create a quick action that opens a Service Catalog item.
Before you begin
Role required: admin
Procedure
Create a function for the quick action.
Navigate to System Mobile > Functions.
The Function [sys_sg_button] table opens.
Click New.
On the form, fill in the fields.
| Field | Description |
|---|---|
| Name | Name of the function record. |
| Description | Description to enable other users to easily understand the purpose of the function. |
| Type | Type of quick action that you want to create. To create a quick action that opens a Service Catalog item, select URL. For more information about function types, see Configure a smart button. |
| Context | Whether the function applies at the record or table level.- Record: Action only applies at the record level. For example, updating a field. - Global: Action that only applies at the table level. For example, creating or deleting a record. For this example, select Global. |
| Link Label | Label for the link. This value does not display in the user interface. |
| Link URL | Relative URL for the item that you want to open when the user clicks the function. For example, to open a Service Catalog item in the Now Mobile portal, enter This field only displays if the Type field is URL. |
| Relative URL | Option that is selected to determine whether the URL is relative. For this example, choose Selected. This field only displays if the Type field is URL. |
| Condition | |
| Table | Table on which the condition runs. |
| Condition | Condition that should be met for the action to be successful. For a catalog item, enter `var item = new sn_sc.CatItem('3f1dd0320a0a0b99000a53f7604a2ef9'); answer = item.canView() && item.isVisibleServicePortal();` to display the quick action only when the end user has permissions to view the item. |
| Roles | Roles that you want to user to have to view the quick action. |
Add an instance of the function that you created to the page.
In the native UI, navigate to Now Mobile App > Applet Launchers.
Open the applet launcher record that you would like to add the quick action to.
Select the Body tab.
Insert a new row in the Quick Actions Menu Maps related list.
If you're not able to insert a row, make sure that you're in the ServiceNow Now Mobile App Screens and Applet Launcher application scope.
Click the magnifying glass to look up an item
The Function Instances [sys_sg_button_instance] table opens.
Click New.
On the form, fill in the fields.
| Field | Description |
|---|---|
| Name | Name of the function instance. |
| Description | Description to enable other users to easily understand the purpose of the function instance. |
| Parent | Page on which you are adding the quick action. For example, select Applet Launcher: Homepage to add the quick action to the home page. Select a value in the Parent table field first. |
| Application | Application scope. |
| Parent table | Table that contains the record type where the button appears. For this example, select applet Launcher [sys_sg_applet_launcher] to add the quick action to an applet launcher page. |
| Function | Function record that you created earlier. |
| Label | Label to help the user understand what the quick action opens. For example, `Report an outage`. |
| Location | Location where the button appears in the UI. For this example, select Quick Action. |
| Icon | Icon to display next to the label. For more details on mobile icons, see Mobile icons.Note: Not all listed icons work with quick actions. To see a list of compatible icons, filter your list where the Icons field contains Note: The Icons field is not on the icon list by default. To add the Icon field to your list, right-click the list header and select Configure > List Layout. Then, add the Icon field to the selected list. You should see the icon field on your reference field list. |
| Order | Number that indicates the order that the functions are listed. If there are multiple instances in the same location, the app displays them from the lowest to the highest. |
8. Click **Submit**.
9. Save the applet launcher record.
Result
Your users can open the quick action by selecting the
Plus icon icon on the applet launcher page.