License Scanning

The License Scanning feature allows users to scan the barcode on the back of a license card and auto-populate fields from the engagement with information from the license.


Enabling Camera Settings For Limelight App

Follow the steps below to allow the Limelight App access to your iPad’s camera.

  • Start by going to your iPad settings to give camera access to the Limelight App.
  • Once in Settings, scroll down the left side menu until you find the Limelight App. On the right side, enable the toggle button to allow Limelight access to the iPad’s camera.
iPad - Settings
Camera - Settings


Turning On License Scanning For An App

To set up License Scanning on your app, follow the steps below:

Dashboard - Enter Project

  • Log into the Limelight Platform and select the project you would like to add the License Scanning feature to.

Canvas - Enter Global Settings

  • From the Canvas, click on the Settings Icon to enter the global settings of the app.

App Global Settings - Click Enable License Scan

  • Within the App Global Settings, enter into the Globaltab and click the Enable Driver’s License Scanningcheckbox.
  • Save and Publish your app for your new settings to take effect.

Adding License Scanning Form Fields To Your App

License Scanning Form Field Setup

To link up a form field with a piece of information captured from the license, follow the naming structure of your form field exactly as specified below:

FIELD LABEL TAG NAME FIELD TYPE
First Name firstName Text Field
Middle Name middleName Text Field
Last Name lastName Text Field
Gender (M/F) gender Toggle / Dropdown Menu / Text Field
Date of Birth dateOfBirth Date Field
Address streetAddress Text Field
Address Line 2 streetAddress2 Text Field
ZIP Code / Postal Code postalCode Text Field with Postal or ZIP Code Validation
City city Text Field
Jurisdiction (State / Province) jurisdiction Dropdown Field
Country country Text Field
License Expiration Date expirationDate Date Field
License Vehicle Class vehicleClass Text Field
License Number licenseNumber Text Field

Capturing Jurisdiction (State / Province) Values Correctly

Jurisdiction, or capturing State or Provincial information, is captured using a dropdown form field. The value captured by a license must match up with the value from the dropdown’s available values, otherwise the captured value will be discarded and the user will have to select an option from the dropdown field manually.

Setting Up Jurisdiction Field

It is standard for a license to store a jurisdiction as its two letter abbreviation.

Example:

  • ON = Ontario
  • BC = British Columbia
  • CA = California
  • VA = Virginia

If you create a dropdown field for jurisdiction, the user should configure the dropdown field value with the state or province abbreviation in all capital letters.


How To Use The License Scanning Feature On Your App

Follow the instructions below to use the License Scanning feature on your app form.

App Form - Scanning Button - Settings
Scanning Your License
  • Log into your app and go to the form with your license fields. This is usually captured within an Attendee form or Data Capture form.
  • On the right side of the toolbar, click the Blue Barcodebutton to activate the camera mode.
  • Place your card in the middle of the screen so the barcode is prominent. The iPad will focus on the barcode and take the picture automatically.
Auto-Populated Form
  • Once the picture is taken, the form fields with the proper naming conventions will automatically populate.

Still need help? How can we help? How can we help?