Stand with Ukraine flag
Try it now Pricing
Professional Edition
Community Edition Professional Edition Cloud Edge PE Edge IoT Gateway License Server Trendz Analytics Mobile Application PE Mobile Application MQTT Broker
Documentation > Administration UI > Mobile application QR code
Getting Started
Devices Library Guides Installation Architecture API FAQ
On this page

Mobile application QR code

Available since TB Version 3.7

We are excited to introduce a new QR code feature, designed to streamline the authorization process in the ThingsBoard mobile application. This enhancement makes logging in faster and more secure, offering a user-friendly alternative to traditional username and password entry.

Scan to download the mobile app

If the Thingsboard PE mobile application has not been installed yet, scanning the QR code will redirect the user to the application marketplace (available on Google Play and App Store).

Just follow these simple steps to get started:

  • Log into your ThingsBoard account and navigate to the "Home" page. You will find the QR code for connecting the mobile app in the bottom right corner;
  • Open the camera app on your phone or tablet and point it at the QR code. The phone will automatically scan the code and show the link button. Click this button to open the link to download the ThingsBoard mobile app;
  • Install ThingsBoard mobile application;
  • Launch the ThingsBoard mobile app to start using it.
Log into your ThingsBoard account and navigate to the "Home" page. You will find the QR code for connecting the mobile app in the bottom right corner;
Log into your ThingsBoard account and navigate to the "Home" page. You will find the QR code for connecting the mobile app in the bottom right corner;
Open the camera app on your phone or tablet and point it at the QR code. The phone will automatically scan the code and show the link button. Click this button to open the link to download the <b>ThingsBoard mobile app</b>;
Open the camera app on your phone or tablet and point it at the QR code. The phone will automatically scan the code and show the link button. Click this button to open the link to download the ThingsBoard mobile app;
Install ThingsBoard mobile application;
Install ThingsBoard mobile application;
Launch the ThingsBoard mobile app to start using it.
Launch the ThingsBoard mobile app to start using it.

Additionally, by clicking the “App Store” or “Google Play” button in the “Connect mobile app” widget, you will be redirected to the ThingsBoard app page in the respective app store for further downloading to your device.

Clicking the "App Store" or "Google Play" button in the "Connect mobile app" widget, you will be redirected to the ThingsBoard app page in the respective app store for further downloading to your device.
Clicking the "App Store" or "Google Play" button in the "Connect mobile app" widget, you will be redirected to the ThingsBoard app page in the respective app store for further downloading to your device.
App Store.
App Store.
Google Play.
Google Play.

Login with QR code

Scan the QR code with the ThingsBoard mobile app, and you will instantly gain access to your account, without the need to manually enter your credentials.

The login process is simple and convenient:

  • Launch the ThingsBoard mobile app on your device and use the QR code scanning feature. Make sure you have the latest version of the app installed;
  • Scan the QR code on the "Home" page of your ThingsBoard instance using the mobile app. You will find the QR code for connecting the mobile app in the bottom right corner;
  • You have successfully logged into the ThingsBoard mobile app with your account.
Launch the ThingsBoard mobile app on your device and use the QR code scanning feature. Make sure you have the latest version of the app installed;
Launch the ThingsBoard mobile app on your device and use the QR code scanning feature. Make sure you have the latest version of the app installed;
Scan the QR code on the "Home" page of your ThingsBoard instance using the mobile app. You will find the QR code for connecting the mobile app in the bottom right corner;
Scan the QR code on the "Home" page of your ThingsBoard instance using the mobile app. You will find the QR code for connecting the mobile app in the bottom right corner;
You have successfully logged into the ThingsBoard mobile app with your account.
You have successfully logged into the ThingsBoard mobile app with your account.

Configuring QR code widget on Home page

The mobile application QR code widget settings are inherited from the system level by default. Tenant administrators are authorized to override system settings. For this, navigate to the “Mobile app” tab on the “Settings” page, and disable “Use system settings” toggle.

Navigate to the "Mobile app" tab on the "Settings" page and disable "Use system settings" toggle;
Navigate to the "Mobile app" tab on the "Settings" page and disable "Use system settings" toggle;

There, you’ll find two settings blocks: “Applications” and “Appearance on Home page”.

Applications:

Two types of application are available for tenant: default and custom.

  • Using the default one means using officially published ThingsBoard Cloud mobile application (available on Google Play and App Store).
Leave "Default" applications settings to use the <b>ThingsBoard Cloud</b> mobile application.
Leave "Default" applications settings to use the ThingsBoard Cloud mobile application.
Doc info icon

Note: The latest release of the ThingsBoard Cloud mobile application (version 1.2.0) includes the capability to switch its server host, allowing it to work with your ThingsBoard PE instance. Simply select the “Login with scan QR code” option on the mobile application’s login page, and the application will automatically switch its server host to your ThingsBoard PE platform host.

If you prefer to use your custom application, switch to the custom settings and input the necessary application credentials for your Android and iOS apps.
If you prefer to use your custom application, switch to the custom settings and input the necessary application credentials for your Android and iOS apps.
Doc info icon

Note: To use custom mobile application tenant should have domain name configured in Login White labeling settings.

After making your settings adjustments, click “Save”. Then, scan the QR code on the “Home” page with your mobile device to ensure it redirects to the specified application.

  • If necessary, you can disable unused platforms.
If necessary, you can disable unused platforms.
If necessary, you can disable unused platforms.


Appearance on Home page:

Optionally, you can disable the QR code widget on the “Home” page, configure badges, turn them off entirely, or update the QR code label to better fit your needs.

You can disable the widget on the home page, configure badges (or turn them off altogether), and update the QR code label.
You can disable the widget on the home page, configure badges (or turn them off altogether), and update the QR code label.

Mobile app QR code widget

With the release of ThingsBoard 3.7, we’ve also introduced the “Mobile app QR code” widget. You can use this widget on your dashboards to simplify the login process for your customers on their mobile devices.

Let’s add this widget to your dashboard:

  • Open your dashboard and switch to edit mode. Click the "+ Add widget" icon at the top of the screen;
  • Navigate to the "Cards" widget bundle;
  • Select the "Mobile app QR code" widget;
  • You can use either the system settings or customize your own. If desired, you can configure badges (or turn them off altogether), and update the QR code label. Click "Add".
  • Adjust widget size to fit your needs. After you're done tweaking, click "Save" to save the dashboard;
  • Mobile app QR code widget has been added. Scan QR code with your mobile and check you are redirected to the specified application.
Open your dashboard and switch to edit mode. Click the "+ Add widget" icon at the top of the screen;
Open your dashboard and switch to edit mode. Click the "+ Add widget" icon at the top of the screen;
Navigate to the "Cards" widget bundle;
Navigate to the "Cards" widget bundle;
Select the "Mobile app QR code" widget;
Select the "Mobile app QR code" widget;
You can use either the system settings or customize your own. If desired, you can configure badges (or turn them off altogether), and update the QR code label. Click "Add".
You can use either the system settings or customize your own. If desired, you can configure badges (or turn them off altogether), and update the QR code label. Click "Add".
Adjust widget size to fit your needs. After you're done tweaking, click "Save" to save the dashboard;
Adjust widget size to fit your needs. After you're done tweaking, click "Save" to save the dashboard;
Mobile app QR code widget has been added. Scan QR code with your mobile and check you are redirected to the specified application.
Mobile app QR code widget has been added. Scan QR code with your mobile and check you are redirected to the specified application.