Custom User Agent String

Feature supported in:

Kiosk Pro Plus and Enterprise versions

Some websites employ a technique called user-agent sniffing to identify visitors' browsers and serve different content accordingly. While this method is generally discouraged due to potential errors with unknown browsers, it remains in use on some sites.

By default, Kiosk Pro uses the user agent string for the current version of WKWebView, the iOS/iPadOS browser engine that the app is built on. 

Default: blank 

When to Use a Custom User Agent String

If you encounter issues such as:

  • Content displaying differently in Kiosk Pro than in other browsers
  • Error messages
  • Unexpected behavior

Setting a custom user-agent string in Kiosk Pro may resolve these problems.

How to Set a Custom User Agent String

Due to the length and complexity of user-agent strings, we recommend using our sample files to update this setting:

  1. Navigate to Kiosk Pro settings
  2. Scroll to the "Remote Management & Notifications" category
  3. Tap "Remote Settings Control"
  4. Enable "Remote Settings Control"
  5. Set "Settings XML File Location" to one of the following:
    1. For mobile Safari: https://docs.kioskgroup.com/mobile.xml
    2. For desktop Safari: https://docs.kioskgroup.com/desktop.xml
  6. Return to the main menu and launch your kiosk presentation

This process will automatically update the Custom User Agent String setting and reset the Remote Settings Control to default.

Important Notes

  • After applying the custom user agent, test your kiosk thoroughly to ensure proper functionality.
  • Remember that while this solution can resolve certain issues, it's a workaround for websites using less-than-ideal practices.
  • If problems persist, consider contacting the website administrator for a more permanent solution.

Values for Remote Settings Control & Managed App Configuration

Key customUserAgentString
Key Type string
Default Value (blank)

Change Log

  • Included in version 6.0

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