---
title: "Device Menus"
app: "Warehouse Insight"
section: "How-to guides"
last_updated: "2026-05-19"
url: "https://insight-works.com/kb/warehouse-insight/pda-menus/"
---

# Device Menus

Note: For earlier versions of Warehouse Insight, find the documentation [here](/kb/warehouse-insight/introduction/).

Device menus are integral to the application development process. Menus can be created using the _Warehouse Insight_ _Device Menus_ page in Business Central.  There are two primary types of menus:

1. Main Menus
2. Application Menus

Menus can be created for the main landing page (e.g., launching an application or offline application like Shipping, Receiving, and Item Inquiry) or the menus can be created for a specific application (e.g., Close, Post, and Change Quantity).

When creating a menu, there are several properties that can be set. The table below describes relevant properties available. Additional properties may be available depending on the standard action being performed by the menu.

| **Property** | **Description** |
| --- | --- |
| Event ID | The event ID to call in Business Central when the menu has processed. Can be used with or without a Standard Action being set. |
| Refresh On Success | If set, the menu triggers the _When Loading Document Data_ event. |
| Require Line | Places the selected lines data into the page context prior to executing the menu. If no line is selected, the menu does not execute. |
| Standard Action | The primary action to take when you click the menu. |

### Standard Actions

Menus primarily define their interactions with Applications via the Standard Action property. Each standard action is described below with examples on how to use them.

 Note: Not all menu standard actions are valid or applicable due to version deprecation. Some standard actions can also be replaced with designer specific blocks.

| **Standard Action** | **Description** |
| --- | --- |
| Close | Closes the application and fire the “When the Form Closes” event. |
| Change Qty. | Triggers the “When Quantity Should Change on a Row” event. |
| Custom Qty. | Displays a simple enter quantity dialog. |
| Custom Text | Displays a simple enter text dialog. |
| LP Show | Not available. |
| LP Create | Triggers the “When a License Plate is Started” or “When a License Plate is Stopped” events.  Updates the menu text accordingly. |
| Offline Application | Launches the configured offline application. |
| Lookup to Barcode | Not available. |
| Prompt to Barcode | Not available. |
| Bin Inquiry | Launches the Bin Inquiry application as configured on the _Setup_ page. |
| Item Inquiry | Launches the Item Inquiry application as configured on the _Setup_ page. |
| Item Picture | Displays the selected items picture. |
| Custom Form | Deprecated. |
| Lookup List | Displays a simple lookup grid list for the user to select an entry from. |
| Hide Completed | Toggles the visibility of completed lines. |
| Take Picture | Prompts the user to take a picture using the device’s camera. |
| Choose Picture | Prompts the user to choose a pre-existing image on the device. |
| Start Application | Launches the specified application. |
| Custom Application Event | Fires the “Custom Event” defined in the _Custom 1_ field. |
| Switch Take/Place | Deprecated. |
| Search | Deprecated. |
| Customize Page | Displays the page customization options dialog. |

#### Close

The Close standard action closes the current application and triggers the “When the Form Closes” event block.

 Note: You can replace the “Change Qty.” action with a “Custom Event” standard action instead, and you can override the manual quantity change behavior via the “override\_event\_behavior” variable.

#### Change Qty.

The Change Qty. standard action triggers the “When Quantity Should Change on a Row” event block and internally sets the event behavior to indicate that manual quantity change was requested.

 Note: You can replace the Change Qty. action with a “Custom Event” standard action instead, and you can override the manual quantity change behavior via the “override\_event\_behavior” variable.

#### Custom Qty.

The Custom Qty. standard action displays a dialog allowing you to enter a number.

When you choose this action, you can set additional properties on the menu.

If you press the **OK** button on the dialog, the value is set in a variable called “action\_result”, and you can then use it by custom code as specified by the menu “Event ID” property.

 Note: The use of decimals cannot be controlled by the menu action and are determined by the device configuration property for decimal places. Note: You can replace this menu action by using the “Ask for a Number” application block.

| **Property** | **Description** | **Default** |
| --- | --- | --- |
| Title | The title for the dialog. | Enter Value |
| Prompt | The prompt to display to the user. | Value |
| Default Quantity | The initial value for the dialog. | 0 Row values can also be used by referencing in brackets (e.g., [Qty. to Ship]). |
| Min. Quantity | The minimum value allowed to be entered. | 0 |
| Max. Quantity | The maximum value allowed to be entered. | No maximum |

#### Custom Text

The Custom Text standard action displays a dialog allowing you to enter text.

When you choose this action, you can set additional properties on the menu.

If you press the **OK** button on the dialog, the value is set in a variable called “action\_result”, and you can then use it by custom code as specified by the menu “Event ID” property.

 Note: You can replace this menu action by using the “Ask for Text” application block.

| **Property** | **Description** | **Default** |
| --- | --- | --- |
| Title | The title for the dialog. | Enter Text |
| Prompt | The prompt to display to the user. | Value |
| Default Value | The initial value for the dialog. | Blank Row values can also be used by referencing in brackets (e.g., [Description]). |
| Max. Length | The minimum value allowed to be entered. | 2048 (max variable length allowed) |

#### LP Create

The LP Create standard action triggers either the “When a License Plate is Started” or the “When a License Plate is Stopped” events blocks depending on the current state of the menu.

 Note: The menu text updates to reflect the current state.

#### Offline Application

You can use the Offline Application standard action to trigger an offline application to be launched. Typically, you would use this on the main landing page.

When you choose this action, you can set additional properties on the menu.

| **Property** | **Description** | **Default** |
| --- | --- | --- |
| Offline Application | The offline application to launch. |  |

 Note: For assistance with developing offline applications, contact Support.

#### Bin Inquiry

The Bin Inquiry standard action launches the application specified in the _Warehouse Insight Setup_ page’s _Bin Inquiry Application_ field.

Additional context parameters are automatically passed to the application for the Bin based on the configured line fields.

 Note: You can replace this menu action with the “Start an Application” block.

#### Item Inquiry

The Item Inquiry standard action launches the application specified in the _Warehouse Insight Setup_ page’s _Item Inquiry Application_ field.

Additional context parameters are automatically passed to the application for the Item, Variant, Serial and Lot based on the configured line fields.

 Note: You can replace this menu action with the “Start an Application” block.

#### Item Picture

The Item Picture standard action displays a dialog showing the picture associated with the selected line’s Item record based on the configured line fields.

 Note: You can replace this menu action with the “Show Picture” block.

#### Lookup List

The Lookup List standard action displays a dialog allowing the user to select an entry from a grid.

When you choose this action, you can set additional properties.

When completed, the context is populated with the selected record’s values. The context variables created are in the format [action\_result.FieldName] (e.g., action\_result.Description). You can use these variables in the extension codeunit event handler as specified by the “Event ID” associated with the menu.

 Note: You can replace this menu action with the “Choose From Table” block.

| **Property** | **Description** | **Example** |
| --- | --- | --- |
| Table to Lookup | The table to retrieve the records from. | 27 (Item) |
| Table Filter | The filter to apply to the table. | WHERE (No.=FILTER(\*1)) |
| Columns | A comma-separated list of columns to display to the user. | No.,Description |

#### Hide Completed

The Hide Completed standard action hides or shows grid entries with their quantity to handle fully entered.

Depending on the menu state, the menu option toggles between Hide Completed and Show Completed.

 Note: This menu action is not supported when viewing records in Card View mode.

#### Take Picture

The Take Picture standard action switches to camera mode on the device and allows you to take a picture. The picture data is sent to the extension codeunit event handler as specified by the “Event ID” associated with the menu.

#### Choose Picture

The Choose Picture standard action prompts you to select an existing image from the device. The image data is sent to the extension codeunit event handler as specified by the “Event ID” associated with the menu.

#### Start Application

The Start Application standard action launches the specified application. You can launch applications from the main landing page (e.g., Shipping, Receiving, and more) or from within existing applications (e.g., Lookup Lists -> Document, Document -> Drill Downs, and more).

When you launch an application from within another document, all context variables and information is passed to the newly-launched application; when you close the newly-launched application, no context information is passed back to the calling application.

When you choose this action, you can set additional properties on the menu.

 Note: You can launch applications with the “Start an Application” block.

| **Property** | **Description** | **Example** |
| --- | --- | --- |
| Application | The application to launch. | ADHOCMOVE |

#### Custom Application Event

The Custom Application Event standard action triggers the “Custom Event” block defined by the menu.

When you choose this action, you can set additional properties on the menu.

| **Property** | **Description** | **Example** |
| --- | --- | --- |
| Event Name | The name of the custom event to call in the application. | OnPost |

#### Customize Page

The Customize Page standard action launches the page configuration dialog allowing you to customize the current page. Currently, the only available customization option is to choose the Grid View or Card View columns.

#### Store & Forward

Store & Forward is a feature that aims to alleviate UI blocking while waiting for a network call to Business Central to return. A typical call to a SaaS instance can take up to approximately a third to a half a second (300 – 500+ milliseconds) or more. Store & Forward enables instant UI updates and queued network responses when using Scan Behavior of “No Dialog Increase by 1”, so the user can rapidly scan without waiting for a response from Business Central before performing the next scan.

Enable on a handheld device:

1. Press **Configure** / **Device** / **Store & Forward**.
2. Enable Store & Forward.
