1+++
2title = "White labeling"
3description = "Change the look of Grafana to match your corporate brand"
4keywords = ["grafana", "white-labeling", "enterprise"]
5aliases = ["/docs/grafana/latest/enterprise/white-labeling/"]
6weight = 1300
7+++
8
9# White labeling
10
11White labeling allows you to replace the Grafana brand and logo with your own corporate brand and logo.
12
13> Only available in Grafana Enterprise v6.6+.
14
15Grafana Enterprise has white labeling options in the `grafana.ini` file. As with all configuration options, you can also set them with environment variables.
16
17You can change the following elements:
18
19- Application title
20- Login background
21- Login logo
22- Side menu top logo
23- Footer and help menu links
24- Fav icon (shown in browser tab)
25- Login title (will not appear if a login logo is set, Grafana v7.0+)
26- Login subtitle (will not appear if a login logo is set, Grafana v7.0+)
27- Login box background (Grafana v7.0+)
28- Loading logo
29
30> You will have to host your logo and other images used by the white labeling feature separately. Make sure Grafana can access the URL where the assets are stored.
31
32{{< figure src="/static/img/docs/v66/whitelabeling_1.png" max-width="800px" caption="White labeling example" >}}
33
34The configuration file in Grafana Enterprise contains the following options. Each option is defined in the file. For more information about configuring Grafana, refer to [Configuration]({{< relref "../administration/configuration.md">}}).
35
36```ini
37# Enterprise only
38[white_labeling]
39# Set to your company name to override application title
40;app_title =
41
42# Set to main title on the login page (Will not appear if a login logo is set)
43;login_title =
44
45# Set to login subtitle (Will not appear if a login logo is set)
46;login_subtitle =
47
48# Set to complete URL to override login logo
49;login_logo =
50
51# Set to complete CSS background expression to override login background
52# example: login_background = url(http://www.bhmpics.com/wallpapers/starfield-1920x1080.jpg)
53;login_background =
54
55# Set to complete CSS background expression to override login box background
56;login_box_background =
57
58# Set to complete URL to override menu logo
59;menu_logo =
60
61# Set to complete URL to override fav icon (icon shown in browser tab)
62;fav_icon =
63
64# Set to complete URL to override apple/ios icon
65;apple_touch_icon =
66
67# Set to complete URL to override loading logo
68;loading_logo =
69```
70
71You can replace the default footer links (Documentation, Support, Community) and even add your own custom links.
72An example follows for replacing the default footer and help links with new custom links.
73
74```ini
75footer_links = support guides extracustom
76footer_links_support_text = Support
77footer_links_support_url = http://your.support.site
78footer_links_guides_text = Guides
79footer_links_guides_url = http://your.guides.site
80footer_links_extracustom_text = Custom text
81footer_links_extracustom_url = http://your.custom.site
82```
83
84Here is the same example using environment variables instead of the custom.ini or grafana.ini file.
85
86```
87GF_WHITE_LABELING_FOOTER_LINKS=support guides extracustom
88GF_WHITE_LABELING_FOOTER_LINKS_SUPPORT_TEXT=Support
89GF_WHITE_LABELING_FOOTER_LINKS_SUPPORT_URL=http://your.support.site
90GF_WHITE_LABELING_FOOTER_LINKS_GUIDES_TEXT=Guides
91GF_WHITE_LABELING_FOOTER_LINKS_GUIDES_URL=http://your.guides.site
92GF_WHITE_LABELING_FOOTER_LINKS_EXTRACUSTOM_TEXT=Custom Text
93GF_WHITE_LABELING_FOOTER_LINKS_EXTRACUSTOM_URL=http://your.custom.site
94```
95
96> **Note:** The following two links are always present in the footer:
97
98- Grafana edition
99- Grafana version with build number
100
101If you specify `footer_links` or `GF_WHITE_LABELING_FOOTER_LINKS`, then all other default links are removed from the footer and only what is specified is included.
102