Hidden Settings

The following settings are not frequently used and most are available only to troubleshoot or workaround a specific issue. 

To prevent clutter in the app's settings menus, these settings can only be updated from their defaults through a Remote Settings Control update or Managed App Configuration update.

Generate Unique iPad ID Remotely

Supported in

Kiosk Pro Plus and Enterprise

Assign a Unique iPad ID to a device remotely if, for example, you deployed kiosks without setting a Unique iPad ID in Kiosk Pro settings or if you accidentally wiped a Unique iPad ID with the remote settings .xml file.

Step 1: Update your Remote Settings XML

Add the following key-value pairs to your remote settings .xml file (or if you are using a fresh .xml template, uncomment both pairs by removing the <!-- and --> that surround this set of <dict> tags).

<dict>
	<key>Key</key><string>kp_setting_command_generateKioskID</string>
	<key>Value</key><string></string>
</dict>
<dict>
	<key>Key</key><string>kp_setting_command_sendContextInfo</string>
	<key>Value</key><string></string>
</dict>

These <key>Value</key><string></string> keys are unique in that they do not need a value between the <string> tags to work correctly.

Upload the amended file to the correct location on your servers.

Step 2: Generate the new ID

When Kiosk Pro downloads the .xml file and sees the ‘kp_setting_command_generateKioskID’ key-value pair, it will immediately check to see if a Unique iPad ID is set in the app’s settings.

If a value is found, the app does nothing. If no value is set for Unique iPad ID, the app generates a unique identifier based on the Apple key ‘identifierForVendor’ and saves it as the Unique iPad ID, which will look something like: 3B9C1105-73EB-4147-8D6A-B4317DB2E701.

Step 3: Identify the Device

To help you identify the kiosk based on its new ID, the second key-value pair, 'kp_setting_command_sendContextInfo', instructs the kiosk to generate an email including general information about the device like the device model and current IP address.

If Update Location Coordinates Automatically has been set to something other than 'Never' and the iOS alerts to confirm that the app should be allowed to access the device’s location are approved, the app will also be able to include detailed location data in the email.

Valid SMTP settings for remote alerts must be configured in Kiosk Pro settings for the email to be sent.

This key-value pair will generate an email for every kiosk, not just ones that have had the Unique iPad ID automatically generated. To prevent overuse of SMTP relays, we only generate this email once.

To generate a second email, you would need to manually exit and relaunch the app while it is still pointing at the .xml file containing this key. To prevent random emails when the app is relaunched, we recommend including these key-value pairs in your .xml file only when specifically needed, and either removing or commenting them out otherwise.

If the information included in the email is not enough to identify the device and you have someone on-site, you can ask them to exit Kiosk Pro, open the device’s main settings (with the silver gear icon), and scroll down the left panel until they see the app’s icon, which includes a non-editable field displaying the Unique ID that’s been set. Alternately, if you have the app set to send email alerts for power supply change, you could have them unplug a kiosk to generate an email that includes that specific device’s Unique ID.

Step 4: Replacing the Generated ID

Once you’ve identified the kiosk, you can replace the generated ID with one that is more helpful in identification using the remote settings .xml file.

To do this, add the following key-value pair to the .xml file for each kiosk you need to change:

<dict>
	<key>Key</key><string>uniqueiPadID</string>
	<key>Value</key><string>NewUniqueID</string>
	<key>ApplyTo</key><array><string>GeneratedUniqueID</string></array>
</dict>

So for a kiosk with a generated unique ID of ‘3B9C1105-73EB-4147-8D6A-B4317DB2E701’ that you want to rename ‘Library 1’:

<dict>
	<key>Key</key><string>uniqueiPadID</string>
	<key>Value</key><string>Library 1</string>
	<key>ApplyTo</key><array><string>3B9C1105-73EB-4147-8D6A-B4317DB2E701</string></array>
</dict>


Use Native PDF Library

Supported in

Kiosk Pro Basic, Plus and Enterprise

Use the native PDF viewer built into the current Browser Engine to display PDF documents. If enabled, this prevents the use of any of the app's other PDF Display features.

Note: The native PDF viewer is used by default in Kiosk Pro Lite as it does not include the PDF Display Features included in other versions of the app.

Default Value: Off

This setting can be toggled individually by using the following XML files with Remote Settings Control:

Values for Remote Settings Control & Managed App Configuration

Key kp_useNativeBrowserPDFViewer
Key Type boolean
Default Value false


Allow Tabbing Between Inputs in UIWebView

Supported in

Kiosk Pro Basic, Plus and Enterprise

Toggle to ability to tab between input fields in a form. This setting compensates for a bug with UIWebView introduced in iOS 8 where quickly tabbing through form fields can cause the app to crash.

Default Value: On

Values for Remote Settings Control & Managed App Configuration

Key kp_enableDropdownsForiOS8
Key Type boolean
Default Value true


Reload Browser After Sleep

Supported in

Kiosk Pro Plus and Enterprise.

This setting fixes an issue with the WKWebView browser crashing from low memory while the app is inactive (for example, if the screen is turned off).

While the app is in an inactive state, iOS does not send notifications of WKWebView crash so the app is unable to automatically reload as it otherwise would. As there are other conditions that make the app inactive (such as showing the Control Panel to connect to AirPlay or adjust volume), we're unable to simply automatically reload every time the app makes this type of shift.

Default Value: Off

When the app shifts from an inactive state to an active state (as when the screen is turned on again), Kiosk Pro will check to see if a title is defined (to confirm if a page is being displayed instead of a blank screen due to a potential crash), and if not, Kiosk Pro will reload the homepage. Since we can't assume that a page always has a title, this setting is turned off by default.

This setting can be toggled individually by using the following XML files with Remote Settings Control:

If your content does not have a <title> element set in the header of every page, or if the screen freezes/is unresponsive after coming back from an inactive state, you can use the following XML files to always reload the homepage:

Values for Remote Settings Control & Managed App Configuration

Key for reloading based on page title kp_reloadBrowserAfterSleep
Key for always reloading kp_reloadBrowserAfterSleepIfPageTitleUndefined
Key Type boolean
Default Value false


Disable All Internet Monitoring

Kiosk Pro Basic, Plus and Enterprise

When displaying content that requires a network connection to load and that connection is unavailable, Kiosk Pro will periodically attempt to reload pending successful page load. This setting disables all automatic attempts by the app to reload if a connection is lost.

Default Value: Off

This setting can be toggled individually by using the following XML files with Remote Settings Control:

Values for Remote Settings Control & Managed App Configuration

Key kp_monitorInternetAccessWhenIdle_totallyDisabled
Key Type boolean
Default Value false


MercuryPay Server List

Supported in

Kiosk Pro Enterprise.

This list defines the server URLs Kiosk Pro attempts to contact when sending a transaction through the MercuryPay API.

Important: Do not alter this list unless specifically instructed to do so by Kiosk Pro or MercuryPay’s support team.

Default Value: w1.mercurypay.com/ws/ws.asmx;https://w2.backuppay.com/ws/ws.asmx

Values for Remote Settings Control & Managed App Configuration

Key mps_server_list
Key Type string
Default Value w1.mercurypay.com/ws/ws.asmx;https://w2.backuppay.com/ws/ws.asmx


Autofill Delay

Supported in

Kiosk Pro Plus and Enterprise.

Add a delay after the page load event is triggered before the app attempts to fill any Autofill credentials. This is useful in situations where fields are dynamically generated or otherwise not available immediately on page load.

Default Value: 0
Unit of Measure: seconds

Values for Remote Settings Control & Managed App Configuration

Key kp_autofilling_injectionDelayInterval
Key Type string
Default Value 0


Allow UIWebView Alerts

Supported in

Kiosk Pro Basic, Plus and Enterprise

Prevent alerts designed to notify you of UIWebView's removal deadline.

Default Value: On

Values for Remote Settings Control & Managed App Configuration

Key _kp_isUIWebViewRemovalWarningAllowed
Key Type boolean
Default Value true


Remote Management Server Event Logging > Server Version Incompatibility Detected

Supported in

Kiosk Pro Plus and Enterprise.

Triggers error logging when the version of the remote management server in use is determined to be incompatible with the app.

Default Value: None

Values for Remote Settings Control & Managed App Configuration

Key logServerVersionIncompatibilityDetected
Key Type integer
Default Value 0
Possible Values
  • 0 = None
  • 1 = Error
  • 2 = Warning
  • 4 = Info

Still stuck? How can we help? How can we help?