Skip to main content

​
Overview

The QR Code Scanner enables users to scan QR codes from within the app and automatically populate designated fields with the extracted data. This eliminates manual typing and speeds up data entry for records that support QR code input.

​
Access the QR Scanner

On record pages that support QR code data input, a Scan QR Code button or icon appears next to fields configured to accept QR data.

​
Setup Prerequisites

Before using QR code scanning:
  • Your device must have a camera
  • The app must have camera permission enabled
  • The record page must have fields configured for QR input by an admin

​
Add a QR Code Field to the Record Details Layout

Before users can scan QR codes, an admin must add a QR Code field to the record details layout using the Layout Builder.
  1. Open Record Details Layout icon Record Details Layout for the target object
  2. From the fields panel, drag a QR Code field into the desired section of the layout
  3. Configure the field name and any associated settings
The Record Details Layout automatically saves. Once added, the QR Code field appears on record pages with a Scan QR Code button that users can use to initiate scanning.

​
Scan a QR Code

  1. Navigate to a record page with QR scanning capability
  2. Locate the Scan QR Code button associated with the target field
  3. Click the button to open the scanner interface
  4. Position the QR code within the scanner frame
  5. Hold steady while the app reads the code
  6. The extracted data automatically populates the designated field
To scan QR codes on a mobile device, you must log in to Elementum through a mobile browser. QR code scanning is not supported in the mobile app.
The QR scan button only appears on fields that have been configured by an admin to accept QR code input. See the Layout Builder documentation for setup instructions.

​
Review and Edit Data

After a successful scan:
  • The extracted information appears in the target field
  • Review the populated data for accuracy
  • Edit the data if needed before saving
  • Save the record to confirm the changes

​
Best Practices

  • Ensure adequate lighting when scanning QR codes
  • Hold the device steady and position the code fully within the scanner frame
  • Verify populated data before saving, especially for critical fields
  • If scanning repeatedly fails, check that the QR code is not damaged or obscured

​
Tips for Successful Scanning

​
Good Lighting

Ensure the QR code is well-lit. Avoid shadows or glare on the code surface.

​
Steady Position

Hold your device steady and keep the QR code still during scanning.

​
Full Visibility

Position the entire QR code within the scanner frame—don’t crop edges.

​
Clean Codes

Use undamaged QR codes. Torn, smudged, or faded codes may not scan.

​
Common Use Cases

Inventory Management Scan product barcodes to quickly log items, update stock levels, or look up product details. Asset Tracking Scan asset tags to pull up equipment records, log maintenance, or transfer ownership. Event Check-In Scan attendee badges or tickets to record attendance and retrieve registration details. Document Processing Scan document identifiers to link physical documents with their digital records.

​
Troubleshooting

When a scan fails, the app displays a clear error message. You can retry the scan by clicking the scan button again, or enter the information manually in the field.
The scan button only displays on fields configured by an admin for QR input. If you don’t see the button:
  • Confirm you’re on a record type that supports QR scanning
  • Contact your app admin to enable QR input for the field
The app doesn’t have camera access. Grant camera permission in your device settings and try again.
If the camera opens but doesn’t capture the code:
  • Ensure the QR code is fully within the frame
  • Improve lighting and avoid shadows or glare on the code
  • Check that the code isn’t blurry or damaged
  • Try a different copy of the code if it may be damaged or obscured
  • Adjust the distance between your device and the code
  • Restart the scan by closing and reopening the scanner
The code format wasn’t recognized. Verify the QR code is valid and undamaged, then try again.
If the scanned data doesn’t match expectations:
  • Verify you scanned the correct QR code
  • Check that the QR code contains the expected data
  • Edit the field manually before saving

Form Builder

Configure fields and forms for data entry

Layout Builder

Design record page layouts and field placement