12 Rebranding

Overview

There are several ways in which you can customize and rebrand your Zabbix frontend installation:

  • replace the Zabbix logo with a desired one
  • hide links to Zabbix Support and Zabbix Share
  • set a custom link to the Help page
  • change copyright in the footer

How to

To begin with, you need to create a PHP file and save it as local/conf/brand.conf.php. The contents of the file should be the following:

  1. <?php
  3.        return [];

This will hide the links to Zabbix Support and Zabbix Share.

To use a custom logo, add the following line to the array from the previous listing:

  1. 'BRAND_LOGO' => '{Path to an image on the disk or URL}',

With the redesign of the main menu in Zabbix 5.0, there are two additional images of the Zabbix logo that can be overridden:

  • BRAND_LOGO_SIDEBAR - displayed when the sidebar is expanded
  • BRAND_LOGO_SIDEBAR_COMPACT - displayed when the sidebar is collapsed

To override:

  1. 'BRAND_LOGO_SIDEBAR' => '{Path to an image on the disk or URL}',
  2.        'BRAND_LOGO_SIDEBAR_COMPACT' => '{Path to an image on the disk or URL}',

Any image format supported by modern browsers can be used: JPG, PNG, SVG, BMP, WebP and GIF.

Custom logos will not be scaled, resized or modified in any way, and will be displayed in their original sizes and proportions, but may be cropped to fit in the corresponding place.

To set a custom copyright notice, add BRAND_FOOTER to the array from the first listing. Please be aware that HTML is not supported here. Setting BRAND_FOOTER to an empty string will hide the copyright notes completely (but the footer will stay in place).

  1. 'BRAND_FOOTER' => '{text}',
Custom help location

To replace the default Help link with a link of your choice, add BRAND_HELP_URL to the array from the first listing.

  1. 'BRAND_HELP_URL' => '{URL}',
File example
  1. <?php
  3.        return [
  4.            'BRAND_LOGO' => './images/custom_logo.png',
  5.            'BRAND_LOGO_SIDEBAR' => './images/custom_logo_sidebar.png',
  6.            'BRAND_LOGO_SIDEBAR_COMPACT' => './images/custom_logo_sidebar_compact.png',
  7.            'BRAND_FOOTER' => '© Zabbix',
  8.            'BRAND_HELP_URL' => 'https://www.example.com/help/'
  9.        ];