Web Browsing

1. Allow Refresh

Set to true to allow the user to refresh the page, e.g. using the

• address bar actions
• kiosk control panel
• pull to refresh (can be configured separately)

Default: true

2. Allow Pull to Refresh

Set to true to allow the user to refresh the page by pulling down from the top 1/4 of the screen.

Note that this requires:

• the Allow Refresh setting to also be true
• the page to have been scrolled fully to the top prior to the gesture
• a single finger (touch) is used

Default: true

3. Allow Backwards Navigation

Set to true to allow the user to go back one page in history.

This also enables forward navigation.

Default: true

4. Allow Go Home

Set to true to allow the user to go home using one of:

1. Tapping the top-left quadrant of the screen 10 times in quick succession (opens Kiosk Control Panel)
2. Holding the back button (long-pressed). For more details, see Settings -> Device
3. Clicking the () icon on the right of the address bar (top-right corner of screen) and selecting Home
4. Clicking the floating toolbar () icon and selecting Home
5. Clicking your device's home button
   • This requires Webview Kiosk to be set as the default launcher (home) app

Default: true

5. Clear History on Home

Set to true if you want to clear the backwards/forward navigation history whenever a Go Home action is triggered.

Default: false

6. Replace History URL on Redirect

Set to true to replace the current history entry with the final URL if any page redirections occurs, rather than adding multiple entries to the history navigation stack.

Default: true

7. Allow History Access

Set to true to allow viewing and navigating back in history, by clicking the () icon on the right of the address bar (top-right corner of screen) and selecting History.

Default: true

8. Allow Bookmark Access

Set to true to allow viewing and navigating to bookmarks configured in settings, by clicking the () icon on the right of the address bar (top-right corner of screen) and selecting Bookmark.

Default: true

9. Allow Other URL Schemes

Allow the handling of non-http/https URL schemes (i.e. intents) such as intent:, mailto:, sms:, tel:, spotify:, whatsapp:, unifiedpush:, etc in other apps.

When in Lock Task Mode, the apps responsible for handling these intents needs to be present in the Lock Task Permitted list under the device owner settings to function.

Default: false

10. Allow Default Long Press

When enabled, long-pressing areas in the WebView will trigger the native WebView behaviour, e.g. text selection.

Specifically for links, even if set to false, this setting can be overridden by the Allow Link Long Press Context Menu setting.

Default: true

11. Allow Link Long Press Context Menu

When enabled, long-pressing links in the WebView will trigger a custom link options dialog.

This will take precedence over the Allow Default Long Press setting (i.e. overrides it).

This actions available in the dialog are:

1. Copy Link
2. Open Link
3. Open in Browser (only available when not in locked mode)

Default: true

12. Override URL Loading Block Action

Action to take when a URL navigation (via shouldOverrideUrlLoading) matches the blacklist regex.

Typically, this is from clicking links (<a> tags) on a webpage's HTML.

This option will NOT take effect for:

• JavaScript navigation
• Custom URL loading, e.g. from the Address Bar, Bookmarks, History, etc

In those other cases, the block page will simply be shown.

Default: Show Block Page

13. Address Bar Actions

This setting is only controlling the UI aspect of the Address Bar.

Access will still need to be enabled using the dependent settings.

See the Settings Web Browsing -> Kiosk Control Panel Actions for a list of available actions.

14. Kiosk Control Panel Region

Controls which part of the screen can be multi-tapped 10 times in quick succession to show the Kiosk Control Panel dialog.

Available regions are:

Region	Description
Top Left	Upper-left quadrant of the screen.
Top Right	Upper-right quadrant of the screen.
Bottom Left	Lower-left quadrant of the screen.
Bottom Right	Lower-right quadrant of the screen.
Top	Upper half of the screen.
Bottom	Lower half of the screen.
Full	Entire screen.
Disabled	Do nothing on multi-tap. Please note that if both of the following are true: Web Browsing -> Kiosk Control Panel Region is disabled Device -> Back Button Hold Action is not set to Open Kiosk Control Panel Then this option cannot be disabled, and will default to Top Left.

At the top-right corner of the dialog, there is an icon button that toggles the stickiness Kiosk Control Panel's stickiness behaviour. By default, sticky mode is disabled (). When enabled (), clicking on the action buttons will not automatically close the dialog.

You can also disable this setting and instead configure Device -> Back Button Hold Action to open the Kiosk Control Panel.

Default: Top left

15. Kiosk Control Panel Actions

This setting is only controlling the UI aspect of the Kiosk Control Panel. Access will still need to be enabled using the dependent settings.

The following actions are available to be configured (remove or rearrange):

Action	Description
Navigation	Combination of Back and Forward buttons side-by-side. Requires Web Browsing -> Allow Backwards Navigation
Back	Navigates one page backwards in history. Requires Web Browsing -> Allow Backwards Navigation
Forward	Navigates one page forward in history. Requires Web Browsing -> Allow Backwards Navigation
Home	Navigates to the home page. Requires Web Browsing -> Allow Go Home
Refresh	Perform a reload on the current webpage. Requires Web Browsing -> Allow Refresh
History	Opens the history dialog. Requires Web Browsing -> Allow History Access
Bookmark	Opens the bookmark dialog. Requires Web Browsing -> Allow Bookmark Access
Files	Opens the local files dialog. Requires Web Content -> Allow Local Files
Find	Opens a search bar to find matching text on the page.
Scroll Top	Scrolls to the top of the page.
Scroll Bot	Scrolls to the bottom of the page.
Apps	Opens a dialog allowing you to launch other apps. When in lock task mode (kiosk), the following are required to launch apps: Your device is on Android 9+ (SDK/API level 28+) Webview Kiosk is lock task permitted The target app is lock task permitted Lock Task Feature -> HOME is enabled The last condition helps avoid being trapped in lock task mode. It enables the use of the home button to open your default launcher (which may show an error that you can safely dismiss). From the launcher, you can find and open Webview Kiosk to unlock the kiosk. You may want to also consider: Granting notifications permission to Webview Kiosk Enabling Lock Task Feature -> NOTIFICATIONS Setting Webview Kiosk as the default launcher The first two suggestions is to display the foreground service notification in lock task mode. Tapping on the notification will return you to Webview Kiosk. Please note that for user-owned devices utilising "Screen Pinning" mode, app launching is not supported. Refer to the Security documentation for further details.
Settings	Open the app settings screen. By default, this action is not configured. This will always be visible if Appearance -> Floating Toolbar Mode is set to Hidden, and will be appended to the end if not configured.
Lock	Trigger either screen pinning or lock task mode.
Unlock	Trigger screen unpinning or unlock task. Will require biometrics or device credentials to succeed. This action will always be visible when the device is in locked mode, and will be appended to the end if not configured.

16. Search Provider URL

The URL used for search queries in the address bar. This URL must include the search string query parameter.

For example,

Default: https://duckduckgo.com?q=

17. Search Suggestion Engine

Configure the search engine for text suggestions (autocomplete/hints) when typing in the address bar.

For example, when searching for "new", you may get suggested

• news
• new recipes
• new york times

Supported options are:

Default: NONE