- Scan to download the mobile app
- Login with QR code
- Configuring QR code widget on Home page
- Mobile app QR code widget
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;](https://img.thingsboard.io/user-guide/ui/qr-code/qr-code-thingsboard-home-page-1-pe-preview.png)
![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>;](https://img.thingsboard.io/user-guide/ui/qr-code/qr-code-scan-and-install-app-pe-preview.png)
![Install ThingsBoard mobile application;](https://img.thingsboard.io/user-guide/ui/qr-code/qr-code-mobile-install-app-pe-preview.png)
![Launch the ThingsBoard mobile app to start using it.](https://img.thingsboard.io/user-guide/ui/qr-code/qr-code-mobile-open-app-1-pe-preview.png)
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.](https://img.thingsboard.io/user-guide/ui/qr-code/qr-code-thingsboard-home-page-2-pe-preview.png)
![App Store.](https://img.thingsboard.io/user-guide/ui/qr-code/qr-code-button-2-pe-preview.png)
![Google Play.](https://img.thingsboard.io/user-guide/ui/qr-code/qr-code-button-1-pe-preview.png)
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;](https://img.thingsboard.io/user-guide/ui/qr-code/qr-code-mobile-login-with-qr-1-pe-preview.png)
![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;](https://img.thingsboard.io/user-guide/ui/qr-code/qr-code-scan-and-open-app-pe-preview.png)
![You have successfully logged into the ThingsBoard mobile app with your account.](https://img.thingsboard.io/user-guide/ui/qr-code/qr-code-mobile-dashboard-1-pe-preview.png)
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.
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).
- The custom one means using your custom application.
![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.](https://img.thingsboard.io/user-guide/ui/qr-code/mobile-app-qr-code-widget-settings-3-pe-preview.png)
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.
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.](https://img.thingsboard.io/user-guide/ui/qr-code/mobile-app-qr-code-widget-settings-5-pe-preview.png)
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;](https://img.thingsboard.io/user-guide/ui/qr-code/add-qr-code-widget-1-pe-preview.png)
![Navigate to the "Cards" widget bundle;](https://img.thingsboard.io/user-guide/ui/qr-code/add-qr-code-widget-2-pe-preview.png)
![Select the "Mobile app QR code" widget;](https://img.thingsboard.io/user-guide/ui/qr-code/add-qr-code-widget-3-pe-preview.png)
![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".](https://img.thingsboard.io/user-guide/ui/qr-code/add-qr-code-widget-4-pe-preview.png)
![Adjust widget size to fit your needs. After you're done tweaking, click "Save" to save the dashboard;](https://img.thingsboard.io/user-guide/ui/qr-code/add-qr-code-widget-5-pe-preview.png)
![Mobile app QR code widget has been added. Scan QR code with your mobile and check you are redirected to the specified application.](https://img.thingsboard.io/user-guide/ui/qr-code/add-qr-code-widget-6-pe-preview.png)