Kiosk & Locked Mode

With our Kiosk Mode & Locked Mode feature the codeREADr app can be used for online and offline ‘unattended’ scanning applications such as attendance check-in, surveys, loyalty rewards, etc.

It’s also useful for applications where you want to limit your app user’s ability to only scanning and manual entry (option), and not expose them to any other in-app features.

On the Advanced tab when creating or editing a Service you will find the option to select ‘Kiosk Mode’. This allows you to password-protect access to the app’s settings and other features.

When used in combination with Apple’s Guided Access feature you can restrict the use of the iOS device to the codeREADr app and disable the hardware buttons. For Android devices you can use screen pinning and optionally block the Back and Overview buttons if you feel it’s necessary.

On-site setup

  1. Admin set’s up Guided Access in the device’s settings.
  2. Admin signs into the codeREADr app with the credentials you’ve issued. They are presented with one or more authorized Services.

kiosk services

3. Admin taps the appropriate Service which by default is in the kiosk mode. Notice the buttons for Manual Entry, Lookup, History and Settings are removed as are the navigation buttons. The only action available to non-admin is to tap the screen to open the camera for scanning.

kiosk tap to scan

4. Admin can tap the lock icon to unlock the kiosk mode. They can choose a different Service, upload scans (if a manual upload is necessary) and access the app’s settings.

By default the app is set up to use the rear-facing autofocus camera. Use of the front camera can be selected in the app’s settings after unlocking the kiosk mode.

kiosk keypad

To see unattended scanning you can view this short video. [Note: this video was taken before the kiosk mode was available but it gives you the basic idea of how scanning works with QR Codes and RFID/NFC credentials.]


Creating the Service

On the Advanced tab when creating or editing your Service(s) select the Kiosk Mode.

Important: Copy the text from the example script and paste it into the form field provided, including the {} brackets. If you remove any string be sure to remove it entirely and keep the comma after the string EXCEPT for the last string.


Here’s kiosk mode text to copy and paste into the Advanced step’s form field.

– Required: Replace 1234 with whatever password you want the admin to use to unlock the kiosk mode.

– Optional: Use your own URL for webify. If there’s Internet connectivity this will be the image presented on the Tap to Scan screen. If you want to use the default image (i.e. the finger tapping the screen) then remove the entire webify string.

– If you enabled the Auto Next Scan option on the Advanced tab, the app will automatically open the camera view after each scan. If you don’t want that include the stop_auto_next string.

– If you’ve enabled pinning on your Android device and you want pinning to start automatically when the service is used, then keep the android_screen_pinning.

– Use manual_input” to enable app users to manually enter values in case the barcode or NFC tag is damaged. If you don’t add this string the default is no manual input. [This option is live on iOS but won’t be live for Android OS until Oct. 2016. Contact support if you have any questions.]

Important Settings

A. Stop Auto Sign Out

For standard services, the app will automatically sign out the app user if the device has gone to the background for more than 3 hours.

  1. The device goes to sleep.
  2. The app user switches away from codeREADr app.

We don’t do any special checking for Kiosk Mode because the expectation is the admin will deploy controls for those two cases.

On iOS, you can configure Guided Access to set the display to always on. On Android, we added an option in app’s settings called “Keep Screen On” because not all device makers offer it like Apple.

B. Refreshing Services

The app needs to connect to our server at least once in every 5 days to reset the token. To accommodate that the Kiosk Mode will refresh services automatically every 24 hours provided there’s Internet connectivity (network or Wi-Fi).

C. Other considerations

You will want to disable automatic app updates (for all apps, not just ours).

in Services