Mobile app QR code

Who it’s for

Administrators rolling out the ThingsBoard mobile app to a team that will not type a server address correctly. The tile goes on the landing dashboard, and onboarding becomes “open the dashboard, point your phone at the square” rather than a page of setup instructions.

What it does

The Mobile app QR code card renders a QR code that opens the ThingsBoard mobile app, with store badges beside it for people who do not have the app yet. Scanning the code on a phone with the app installed connects it to this platform; scanning it without the app leads to the store listing, so one square covers both cases.

• One tile handles install and connect — the same code routes to the store or into the app depending on what the phone already has.
• App Store and Google Play badges sit to the right or below the code, or are hidden when the audience already has the app.
• The caption above the code is editable, which matters because the default sentence explains both paths and most rollouts only need one.
• The code’s target comes from the platform’s own mobile app settings by default, so a change made once centrally reaches every dashboard carrying this widget.
• The Mobile app QR code card reads no telemetry and shows no device: a QR code built from entity data belongs on the QR Code widget instead.

How to set up

Data keys

The Mobile app QR code card takes no datasource and no data keys — its content comes from the platform’s mobile app settings rather than from telemetry.

QR code

Setting	Default	Effect
Use system settings	On	Takes the code’s target from the platform’s main mobile app settings instead of configuring it here
Badges	On	Shows the App Store and Google Play badges
Badge position	RIGHT	Places the badges beside or beneath the code
Label	On	Shows the caption above the code
Label text	Scan to connect or download mobile app	The caption

Configure the platform’s mobile app settings first — with Use system settings on, this widget renders whatever is set there, and an unconfigured platform produces a code that goes nowhere.

How to customize

• To word the caption for your rollout — edit Label, or turn it off if the surrounding dashboard already explains the step.
• To drop the store badges — turn off Badges when everyone in the audience already has the app installed.
• To fit a narrow tile — set Badge position to place the badges below the code rather than beside it.
• To point the code somewhere other than the platform default — turn off Use system settings and configure the target on the widget.

Tips

• Put the tile on the dashboard users land on after their first sign-in, not on an admin page. The people who need it are the ones who have never opened the platform before, and they will not go looking for a settings screen.
• Leave Use system settings on. A platform address configured per widget is the kind of thing that stays correct until the server moves, and then breaks on exactly the dashboards nobody thinks to check.