Description
The headerMAX widget is designed to enhance the customization and usability of your Zabbix dashboard. It allows users to create visually distinct section headers and interactive buttons with URL links. These features help improve navigation and organization, making it easier to structure the dashboard according to specific monitoring needs.
With headerMAX, users can fully personalize their buttons and headers by choosing from multiple font styles, background colors, text sizes, and other design options. This level of customization ensures that important sections stand out and improves the clarity and efficiency of the dashboard layout.
Additionally, the option to create URL-linked buttons provides quick access to external resources, reports, or different dashboard views, reducing the time spent searching for critical information. Whether used to categorize sections, highlight key metrics, or link to important tools, headerMAX makes the Zabbix dashboard more user-friendly, visually appealing, and functionally adaptable.
Usage Examples
Here are a few examples of how you can use the headerMAX widget
Example 1 – Section headers (FREE)
Structure your dashboard with colored section headers. Plain text with a custom font, size, color, background and alignment – no HTML needed, fully available in the FREE edition.
Example 2 – Live dashboard tiles (PRO)
The PRO edition renders HTML content and resolves expression macros into live item values. The configuration form ships four one-click EXAMPLES templates – KPI tiles, Single stat, Gauge bar and Throughput – use them as they are, or as a starting point for your own tiles:
Example 3 – Interactive dashboard navigation button (only PRO feature)
Using HTML, the headerMAX widget can function as a custom navigation button that links to another dashboard.
This is especially useful for creating visual menus, section overviews, or quick-access panels directly within a dashboard layout. With styles applied directly in the HTML, you can control layout, padding, icons, and hover behavior to fit your branding and UI needs.
The example below includes a clickable icon and title, styled as a tile with rounded corners and background color transition on hover.
Note: This example requires HTML to be enabled in the widget settings and may use custom Zabbix icons (e.g., from imgstore.php).
Code example
<div style="
width: 100%;
height: 100%;
background-color: white;
border-radius: 20px;
overflow: hidden;
box-sizing: border-box;
transition: background-color 0.3s ease;">
<!-- MANUAL: Link to target dashboard -->
<a href="zabbix.php?action=dashboard.view&dashboardid=1"
style="
text-decoration: none;
display: flex;
flex-direction: column;
justify-content: space-between;
width: 100%;
height: 100%;
padding: 120px;
box-sizing: border-box;
transition: background-color 0.3s ease;"
onmouseover="this.parentNode.style.backgroundColor='#f7be00';"
onmouseout="this.parentNode.style.backgroundColor='white';">
<div style="
flex-grow: 1;
display: flex;
justify-content: center;
align-items: center;">
<!-- MANUAL: Icon source and alt text -->
<img src="imgstore.php?iconid=127"
alt="Dashboard icon"
height="110"
style="
max-width: 100%;
object-fit: contain;">
</div>
<!-- MANUAL: Tile label -->
<p style="
color: #0D142D;
font-weight: bold;
margin: 10px 0 0;
text-align: center;
line-height: 1.2;">Network Overview</p>
</a>
</div>Example 4 – Interactive dashboard navigation button to external systems or sending email from dashboard
User can check dashboards, access external systems ( service desk, knowledge base, bugzilla or home aquarium ) or send email for predefined/related email address. This can improve workflow for users working with Zabbix.
Installation
headerMAX is distributed as a standard deb/rpm package from our repository repo.initmax.com. The package installs the module into your Zabbix frontend, enables it automatically and migrates any dashboards using the legacy header widget – no manual steps in the Zabbix frontend are needed. It is also HA ready – multi-frontend / HA setups work out of the box, just install the package on every frontend node.
Connect to your Zabbix frontend server via SSH (perform on all frontend nodes) and run the commands for your distribution.
FREE edition
# Debian / Ubuntu
wget https://repo.initmax.com/zabbix/release/initmax-release-latest_all.deb
dpkg -i initmax-release-latest_all.deb
apt update && apt install zabbix-module-headermax# RHEL / Rocky / Alma
rpm -Uvh https://repo.initmax.com/zabbix/release/initmax-release-latest.noarch.rpm
dnf clean all && dnf install -y zabbix-module-headermax# SUSE
rpm -Uvh https://repo.initmax.com/zabbix/release/initmax-release-latest.noarch.rpm
zypper --gpg-auto-import-keys refresh && zypper install -y zabbix-module-headermaxPRO edition
After purchase, sign in to the initMAX customer portal and issue a repository token (Profile → Repo tokens). The token unlocks the PRO repository for your account. Replace TOKEN in the commands below with your token – or simply copy the pre-filled commands from the portal catalog.
# Debian / Ubuntu
wget https://repo.initmax.com/zabbix/release/initmax-release-latest_all.deb
dpkg -i initmax-release-latest_all.deb
sed -i -e '/^# Types: deb/,$ s/^# //' -e 's|USER:TOKEN|token:TOKEN|' /etc/apt/sources.list.d/initmax.sources
apt update && apt install zabbix-module-headermax# RHEL / Rocky / Alma
rpm -Uvh https://repo.initmax.com/zabbix/release/initmax-release-latest.noarch.rpm
sed -i -e '/#\[initmax-zabbix-pro\]/,$ s/^#//' -e 's|USER:TOKEN|token:TOKEN|' /etc/yum.repos.d/initmax.repo
dnf clean all && dnf install -y zabbix-module-headermax# SUSE
rpm -Uvh https://repo.initmax.com/zabbix/release/initmax-release-latest.noarch.rpm
sed -i -e '/#\[initmax-zabbix-pro\]/,$ s/^#//' -e 's|USER:TOKEN|token:TOKEN|' /etc/zypp/repos.d/initmax.repo
zypper --gpg-auto-import-keys refresh && zypper install -y zabbix-module-headermaxVerification
The module is enabled automatically during the package installation. You can verify it in the Zabbix frontend menu: Administration → General → Modules
Upgrading from the legacy header widget? Existing dashboard widgets are migrated to headerMAX automatically on the first signed-in page load – all configuration is preserved. Updates are then delivered through your package manager (apt / dnf / zypper) like any other system package.
Configuration
Where to get it?
If you’re interested in this widget, you can find it in our e-shop. There you’ll learn more about the available versions and how to get the product.