Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 40 additions & 0 deletions _includes/docs/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -77,6 +77,46 @@ The data is stored in [Cassandra](https://cassandra.apache.org/) database. Cassa
ThingsBoard is licensed under [Apache 2.0 License](https://en.wikipedia.org/wiki/Apache_License#Version_2.0).
It is free for both personal and commercial usage and you can deploy it anywhere.

## Can I replace the default ThingsBoard logo in the menu?

{% if page.docsPrefix contains "paas/" or docsPrefix contains "paas/" %}
In the ThingsBoard Cloud, all branding can be configured directly from the user interface using the built-in [White-Labeling](/docs/{{docsPrefix}}user-guide/white-labeling/#customize-thingsboard-web-interface) module.
Here’s what you can do in just a few clicks:
- Replace the ThingsBoard logo and favicon with your own corporate visuals
- Customize login and system pages to greet users with your brand from the start
- Adjust color schemes and styles (primary, accent colors, logo size, CSS tweaks) to match your identity
- Preview changes live before applying them
- Configure custom domain: map your own domain name (e.g., portal.company.com) so users access the platform via your branded URL

And it doesn’t stop at the logo. With ThingsBoard Cloud you can:
- Set up custom [email templates](/docs/{{docsPrefix}}user-guide/mail-templates/), so all platform notifications reflect your brand
- Add [custom translations](/docs/{{docsPrefix}}user-guide/custom-translation/), ensuring the platform “speaks” your users’ language
- Create [custom menus](/docs/{{docsPrefix}}user-guide/custom-menu/), adapting navigation to your business workflows

This gives you a fully branded platform: your users see your logo, your colors, your emails, and even your tailored menus.
{% elsif page.docsPrefix == "pe/" or docsPrefix == "pe/" %}
In the Professional Edition, all branding can be configured directly from the user interface using the built-in [White-Labeling](/docs/{{docsPrefix}}user-guide/white-labeling/#customize-thingsboard-web-interface) module.
Here’s what you can do in just a few clicks:
- Replace the ThingsBoard logo and favicon with your own corporate visuals
- Customize login and system pages to greet users with your brand from the start
- Adjust color schemes and styles (primary, accent colors, logo size, CSS tweaks) to match your identity
- Preview changes live before applying them
- Configure custom domains: map your own domain name (e.g., portal.company.com) so users access the platform via your branded URL

And it doesn’t stop at the logo. With PE you can:
- Set up custom [email templates](/docs/{{docsPrefix}}user-guide/mail-templates/), so all platform notifications reflect your brand
- Add [custom translations](/docs/{{docsPrefix}}user-guide/custom-translation/), ensuring the platform “speaks” your users’ language
- Create [custom menus](/docs/{{docsPrefix}}user-guide/custom-menu/), adapting navigation to your business workflows

This gives you a fully branded platform: your users see your logo, your colors, your emails, and even your tailored menus.
{% else %}
The Community Edition does not include a built-in white-labeling feature. However, it is technically possible to replace the default ThingsBoard logo by modifying the source code and rebuilding the platform. This requires development expertise and familiarity with ThingsBoard’s codebase. Please note that such changes will need to be reapplied after each upgrade of the platform.

If you need a more streamlined and configurable option, we recommend considering the Professional Edition. With Professional Edition, you can effortlessly upload your own logo and favicon, customize login and system pages, adjust colors and branding palettes, and even tailor [email templates](/docs/pe/user-guide/mail-templates/), [translations](/docs/pe/user-guide/custom-translation/), and [custom menus](/docs/pe/user-guide/custom-menu/) - all directly from the user interface, without touching the code. This empowers your organization to deliver a fully branded, professional-grade experience to your customers and tenants in just a few clicks.

More details: [PE White-Labeling Guide](/docs/pe/user-guide/white-labeling/#customize-thingsboard-web-interface).
{% endif %}

## How to get support?

You can use troubleshooting instructions and community resources or [contact us](/docs/contact-us) and learn more about [services](/services/) we provide.