Open Page as Popup

When to use Advanced options

Select a fixed destination in Popup page. For a dynamic destination, parameters, or background options, expand Advanced options:

• Use a dynamic Page Code expression: provide a JavaScript expression that returns the Page Code.
• Page parameters (JSON object): pass a static object such as {"PLC":"PLC_LINE01","Device":"PUMP_01"}. A top-level array is invalid.
• Build page parameters with an expression: return an object or an ordered array of { key, value } entries; use the array to preserve repeated keys.
• Background behind popup: choose Dim the page behind or Keep the page visible. Dim strength is limited to 0%-85%.
• Allow the same popup to open more than once: permit duplicate instances. It is off by default to avoid accidental duplicates.

// Fixed page + static parameters
Page Code: device_details
Page parameters: {"PLC": "PLC_LINE01", "Device": "PUMP_01", "active": true}

// Dynamic page example
selectedDeviceType === "pump" ? "pump_details" : "valve_details"

How popup parameters are sent, read, and returned

The static popup input requires a JSON object and cannot represent repeated keys. Dynamic parameter expressions can return an ordered array of { key, value } entries to preserve repeated keys. For consistent host and local-fallback behavior, use string, number, boolean, or null values. The popup destination still reads them with GetPageParameter, GetPageParameterValues, or GetPageParameters and treats the result as text.

• Static parameters: enter a JSON object.
• Dynamic parameters: Build page parameters with an expression accepts an object or an ordered { key, value } array, but not a Promise or DOM object.
• Destination reads: call GetPageParameter* in the popup page's Page Script.
• Close result: Close Current Popup's Result expression sends a result back to the opener; it is not a page query parameter.
• Parameters provide page context only; they do not bypass host permissions or expand Tag access.

// Popup Page Script
var plc = GetPageParameter("PLC", "");
var device = GetPageParameter("Device", "");
var activeText = GetPageParameter("active", "false");
var active = activeText === "true";

Delivery boundaries and common mistakes

The target must be an exported page in the package. Adding, removing or renaming popup pages, or changing shared assets, requires a full export. Select from the page list to match Page Code to the manifest; do not emulate popups with Open Link.