thethingsstack.io has moved to thethingsindustries.com/docs
Got it

v3.12

Getting Started Devices Gateways Integrations Reference
Get The Things Stack

Reference

    Overview
  • Billing with Stripe
  • API
  • Application Packages
  • Command-Line Interface
  • Components
  • Configuration
  • Data Formats
  • Email Templates
  • Federated Authentication
  • Frequency Plans
  • Glossary
  • ID and EUI Constraints
  • Interoperability Repository
  • LoRaWAN Specification and Regional Parameters
  • Networking
  • Packet Broker
  • Rate Limiting
  • Root Certificates
  • Telemetry
  • Web UI Branding

Web UI Branding

This reference gives details on how to customize the branding of the login pages and the Console.

Cloud Branding

Cloud users need to contact The Things Industries to update branding in the console. See below for what’s available to customize and what files are necessary. To request a branding update, either send us a link to a CDN which hosts these files or attach them to the email.

Title, Subtitle and Description

The title, subtitle and description of the login pages and the console can be changed using configuration options. See for details the Identity Server configuration reference and the Console configuration reference.

Logos

It is possible to change the logos of the web UI by changing the “branding base URL” to a location that contains the following files:

Filename Size Purpose
console-favicon.svg vector The SVG logo for the console that is shown in browser tabs and bookmarks
console-favicon.png multiple The fallback favicon logo for the console in PNG format; recommended size 32x32
console-favicon.ico multiple The fallback favicon logo for the console in ICO format; recommended size 32x32
console-og-image.png 1200x600 The logo for the console that is shown when sharing links on social media
console-touch-icon.png 400x400 The logo for the console that is shown mobile devices
claim-favicon.svg vector The SVG logo for the device claiming frontend that is shown in browser tabs and bookmarks
claim-favicon.png multiple The fallback favicon logo for the device claiming frontend in PNG format; recommended size 32x32
claim-favicon.ico multiple The fallback favicon logo for the device claiming frontend in ICO format; recommended size 32x32
claim-og-image.png 1200x600 The logo for the device claiming frontend that is shown when sharing links on social media
claim-touch-icon.png 400x400 The logo for the device claiming frontend that is shown mobile devices
logo.svg vector The logo for the console that is shown in the menu bar of the console
oauth-favicon.svg vector The SVG logo for the login pages that is shown in browser tabs and bookmarks
oauth-favicon.png multiple The fallback favicon logo for the login pages in PNG format; recommended size 32x32
oauth-favicon.ico multiple The fallback favicon logo for the login pages in ICO format; recommended size 32x32
oauth-og-image.png 1200x600 The logo for the login pages that is shown when sharing links on social media
oauth-touch-icon.png 400x400 The logo for the login pages that is shown mobile devices

If the “branding base URL” option is set, “logo.svg” is used to display a secondary logo next to the logo of The Things Stack for LoRaWAN. It is recommended to use a logo with a wide (e.g. 5:1) or square (1:1) aspect ratio. Tall logos (e.g. 1:5; height larger than width) will be displayed very small, due to the limited height of the header bar.

For the exact configuration options that are required to set a custom “branding base URL”, see the Identity Server configuration reference and the Console configuration reference.

Note:

If you have your favicon as a PNG, use ImageMagick to convert it to ICO:

$ convert console-favicon.png \
    -define icon:auto-resize=64,48,32,16 \
    console-favicon.ico
← Telemetry

On this page

  • Cloud Branding
  • Title, Subtitle and Description
  • Logos

The Things Stack

Getting Started

Devices

Gateways

Integrations

Reference

Contributing

GitHub

Forum

About Us

The Things Network

The Things Industries

About this page

Last changed by Ben Olayinka on 10 Feb 2021.
util: Replace distributions-inline with distributions shortcode

Edit on Github