Custom User Agent String
Feature supported in:
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:
- Navigate to Kiosk Pro settings
- Scroll to the "Remote Management & Notifications" category
- Tap "Remote Settings Control"
- Enable "Remote Settings Control"
- Set "Settings XML File Location" to one of the following:
- For mobile Safari: https://docs.kioskgroup.com/mobile.xml
- For desktop Safari: https://docs.kioskgroup.com/desktop.xml
- 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