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