--- title: "Configure custom branding | Grafana documentation" description: "Change the look of Grafana to match your corporate brand." --- > For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt). # Configure custom branding Custom branding enables you to replace the Grafana Labs brand and logo with your corporate brand and logo. > Note > > Available in [Grafana Enterprise](../../../introduction/grafana-enterprise/) and to customers on select Grafana Cloud plans. For pricing information, visit [pricing](/pricing/) or contact our sales team. For Cloud customers, please provide custom elements and logos to our Support team. We will help you host your images and update your custom branding. The `grafana.ini` file includes Grafana Enterprise custom branding. As with all configuration options, you can use environment variables to set custom branding. With custom branding, you can modify the following elements. Hover your cursor over a number to learn more about each element. ![Grafana login page with interactive callouts highlighting customizable branding elements](/media/docs/grafana/screenshot-grafana-13.0-custom-branding-login-page.png) 1. **Login background** (`login_background`) The full-page background behind the login card. Accepts any valid CSS `background` value, including `url()` for images. 2. **Login box background** (`login_box_background`) The background of the login form card. Accepts any valid CSS `background` expression. 3. **Login logo** (`login_logo`) The logo at the top of the login card. Grafana recommends SVG files, 48x48 pixels or smaller. When set, the login title and subtitle don’t appear. 4. **Login title** (`login_title`) The main heading on the login page. Defaults to “Welcome to Grafana”. Doesn’t appear if a login logo is set. 5. **Login subtitle** (`login_subtitle`) Secondary text below the login title. Empty by default. Doesn’t appear if a login logo is set. 6. **Footer and help menu links** (`footer_links`) Links shown at the bottom of the login page. These same links also appear in the **Help** menu when logged in. By default: Documentation, Support, and Community. ![Grafana home page with interactive callouts highlighting the fav icon, application title, and side menu logo](/media/docs/grafana/screenshot-grafana-13.0-custom-branding-home-page.png) 1. **Fav icon** (`fav_icon`) The small icon in the browser tab. Defaults to the Grafana sunburst icon. 2. **Application title** (`app_title`) The text appended to every page title in the browser tab. Defaults to “Grafana”. This setting controls the name in both the browser tab and the main menu header. 3. **Side menu top logo** (`menu_logo`) The logo in the top-left corner of the application, also shown in the main menu header. 4. **Application title** (`app_title`) The application name in the main menu header, next to the side menu logo. This setting controls the name in both the main menu header and the browser tab. You can also customize the **loading logo** (`loading_logo`), which appears during the initial page load splash screen. > You will have to host your logo and other images used by the custom branding feature separately. Make sure Grafana can access the URL where the assets are stored. The configuration file in Grafana Enterprise contains the following options. For more information about configuring Grafana, refer to [Configure Grafana](../). ini ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```ini # Enterprise only [white_labeling] # Set to your company name to override application title ;app_title = # Set to main title on the login page (Will not appear if a login logo is set) ;login_title = # Set to login subtitle (Will not appear if a login logo is set) ;login_subtitle = # Set to complete URL to override login logo ;login_logo = # Set to complete CSS background expression to override login background # example: login_background = url(http://www.bhmpics.com/wallpapers/starfield-1920x1080.jpg) ;login_background = # Set to complete CSS background expression to override login box background ;login_box_background = # Set to complete URL to override menu logo ;menu_logo = # Set to complete URL to override fav icon (icon shown in browser tab) ;fav_icon = # Set to complete URL to override apple/ios icon ;apple_touch_icon = # Set to complete URL to override loading logo ;loading_logo = # Set to `true` to remove the Grafana edition from appearing in the footer ;hide_edition = ``` > Note > > For the `login_logo` option, Grafana recommends using SVG files that are 48 pixels by 48 pixels or smaller. You also don’t need to use the `url()` function for `login_logo`. > > Additionally, you can copy images to the local Grafana image directory, `/usr/share/grafana/public/img/`, and set `login_logo` to the stored image. For example: > > ini ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy > > ```ini > login_logo = /public/img/ > ``` You have the option of adding custom links in place of the default footer links (Documentation, Support, Community). Below is an example of how to replace the default footer and help links with custom links. ini ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```ini footer_links = support guides extracustom footer_links_support_text = Support footer_links_support_url = http://your.support.site footer_links_guides_text = Guides footer_links_guides_url = http://your.guides.site footer_links_extracustom_text = Custom text footer_links_extracustom_url = http://your.custom.site ``` The following example shows configuring custom branding using environment variables instead of the `custom.ini` or `grafana.ini` files. ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```none GF_WHITE_LABELING_FOOTER_LINKS=support guides extracustom GF_WHITE_LABELING_FOOTER_LINKS_SUPPORT_TEXT=Support GF_WHITE_LABELING_FOOTER_LINKS_SUPPORT_URL=http://your.support.site GF_WHITE_LABELING_FOOTER_LINKS_GUIDES_TEXT=Guides GF_WHITE_LABELING_FOOTER_LINKS_GUIDES_URL=http://your.guides.site GF_WHITE_LABELING_FOOTER_LINKS_EXTRACUSTOM_TEXT=Custom Text GF_WHITE_LABELING_FOOTER_LINKS_EXTRACUSTOM_URL=http://your.custom.site ``` > Note > > The following two links are always present in the footer: - Grafana edition - Grafana version with build number If 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. ## Custom branding for shared dashboards In addition to the customizations described below, you can customize the footer of your shared dashboards. To customize the footer of a shared dashboard, add the following section to the `grafana.ini` file. ini ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```ini [white_labeling.public_dashboards] # Hides the footer for the shared dashboards if set to `true`. # example: footer_hide = "true" ;footer_hide = # Set to text shown in the footer ;footer_text = # Set to complete url to override shared dashboard footer logo. Default is `grafana-logo` and will display the Grafana logo. # An empty value will hide the footer logo. ;footer_logo = # Set to link for the footer ;footer_link = # Set to `true` to hide the Grafana logo next to the title ;header_logo_hide = ``` If you specify `footer_hide` to `true`, all the other values are ignored because the footer will not be shown.