Skip to main content
All CollectionsSwitches & ModulesBlue Series Fan SwitchHome Assistant - Zigbee2MQTT
Blue Series Fan Switch • Setup Instructions • Zigbee2MQTT
Blue Series Fan Switch • Setup Instructions • Zigbee2MQTT

Setup and Pairing instructions for the Inovelli Blue Series Fan Switch on Home Assistant - Zigbee2MQTT (Z2M)

Eric Maycock avatar
Written by Eric Maycock
Updated over 9 months ago

DISCLAIMER: You may notice there are a lot of over-used keywords or phrases as well as English that seems a little off. This is because these articles are used to feed our AI Robot (Ira) and she needs the data to be structured in a certain way.

REMINDER: This switch is only to be used to control AC Motor exhaust and ceiling fans. Do not use the switches on any sort of lighting load or DC Motor.

IMPORTANT: Before installing your fan switch, please ensure the fan motor is set to high speed. If you notice that after you install your fan switch the speeds are not as fast as they were prior to installing your switch, it's likely that the motor was not on high (please adjust if you find this is the case).

This is the digital setup instructions for the Blue Series Smart Fan Switch (Exhaust or Ceiling) on the Zigbee2MQTT platform.


Navigating the Instructions

Please click on any of the sections in the Table of Contents to get started. We recommend working your way down as it follows an intentional flow that is user friendly and hub/gateway specific. As always, any questions, please see the Additional Resources links section or submit a ticket, we’re happy to help.


Quick Setup Instructions

Follow these if you have already installed the Fan switch before and are just looking for some quick pairing instructions. If this is your first time installing the Fan switch, please skip this section and work your way through the various sections below starting with the Prerequisites.

This section assumes the following:

  1. You’ve wired the switch and it works manually

Let’s begin:

  1. Make sure your switch LED is lit up blue

  2. Open up your Home Assistant App, click on the hamburger bar at the top left (three lines) and select, "Zigbee2MQTT" from the sidebar (if you don't have a shortcut, go to, "Configuration" → "Add-ons, Backups, & Supervisor" → "Zigbee2MQTT" → "Open Web UI")

  3. Click on, "Permit join (All)" at the top

  4. Make sure your switch LED is pulsing blue as shown in Video #1 – if it’s not, press the config/favorite button three (3) times as shown in Video #2

  5. Zigbee2MQTT should then search for, find and initialize the switch

Video #1 & Video #2

Video #1: Switch Already Pulsing Blue

Video #2: Press config/favorites button to initiate the LED pulsing blue

If your LED bar refuses to pulse blue, then please hold down on the top of the paddle as well as the config/favorites button for approximately 20 seconds until the LED Bar turns Red and then let go. The LED Bar will blink red three times to confirm as shown in the video below.

Video Demonstration

NOTE: Video sped up to save time/space



Installation Instructions

Before setting up your switch within Zigbee2MQTT, you will have to manually install your switch in the wall and have it powered up. In order to do that, you (or your licensed electrician) will need to follow our Wiring Instructions which can be found below:


Pairing Instructions

The below instructions assume you have installed the Zigbee2MQTT Converter prior to pairing. Please follow the instructions below to include/pair your Blue Series Fan Switch

  1. Open your Zigbee2MQTT Web App and go to the, "Devices" tab

  2. Click, “Permit join (All)”

  3. While Home Assistant is scanning, make sure your switch LED is pulsing blue as shown in Video #1 – if it’s not, press the config/favorite button three (3) times as shown in Video #2. The LED Bar should start pulsing blue and, if successfully paired to Home Assistant, it will briefly turn green


    Video #1: Switch Already Pulsing Blue

    Video #2: Press config/favorites button to initiate the LED pulsing blue

  4. Zigbee2MQTT will then search for your Inovelli switch and, if successful, will let you know that the device was found and ultimately added

  5. To view your device and change any of the parameters, find the device in your "Devices" list and click on it.


Once your switch is successfully paired, check to make sure you have basic functionality of your switch by turning it on/off.

NOTE: By default the switch is setup for Exhaust Fans so it will only turn On/Off (this means you will not be able to adjust the speed of your Ceiling Fan). This is for safety reasons. If you'd like to change your switch to operate a Ceiling Fan, then please move to the Switch Configuration section below.


Switch Configuration

In this section, we will help you change your switch mode (ie: Exhaust or Ceiling) and type (Single-Pole or 3-Way Aux).

If you are trying to setup your switch in Smart Fan Mode, please still select the Switch Mode and Type from the below instructions, and then follow the directions to setup Smart Bulb Mode

Switch Mode (Exhaust or Ceiling)

To change your Blue Series Fan switch from an Exhaust Fan (On/Off) to a Ceiling Fan (Multi-Speed) or vice versa in Zigbee2MQTT, please follow the instructions below:

  1. Open your Zigbee2MQTT Web App and go to the, "Devices" tab

  2. Find your Blue Series Fan Switch and click on it and then click on the "Exposes" tab

  3. Scroll down to where it says, "OutputMode"

  4. Find "OutputMode" and select either, "Fan Controller" or "On/Off" and select the option you desire.

  5. Test your switch to make sure the setting applied

Switch Type (Single-Pole, Multi-Way Aux)

To program your Blue Series Fan switch to operate in a Single-Pole or Multi-Way Aux in Zigbee2MQTT, please follow the instructions below:

  1. Open your Zigbee2MQTT Web App and go to the, "Devices" tab

  2. Find your Blue Series Fan Switch and click on it and then click on the "Exposes" tab

  3. Scroll down to where it says, "SwitchType"

  4. Find "SwitchType" and select either, "Load Only (default)" or "Aux".

    NOTE: If you are selecting, "Smart Aux Switch" and you have a non-neutral setup, you will need to program your switch to work properly. Please follow these directions: Blue Series Fan Switch • Special Programming for Aux Switch in Non-Neutral Mode

  5. Test your switch to make sure the setting applied


Advanced Feature Setup

This switch is packed with features and most of them come directly from this community. They've been debated back and forth, added to wishlists, and talked about over the course of 4+ years.

Below we will provide a link to all the parameters and show you how to change them from within Zigbee2MQTT and then we'll go into some of the advanced features and explain how to set them up in Zigbee2MQTT.

Parameter Explanations

You will need to install a Converter prior to accessing any of these features from within the app. Instructions can be found here: Converter Installation

A parameter is a setting within the switch firmware that allows you to change how the switch operates. For example, you want to change how fast your fan turns on and off, the color of the LED bar, minimum speed level and much more -- all with a few clicks within the app.

To find all the parameters, please follow these steps:

  1. Open your Zigbee2MQTT Web App and go to the, "Devices" tab

  2. Find your Blue Series Fan Switch and click on it, then click on the "exposes" tab.

  3. Scroll down to where all of the options are listed and change them to fit your needs.

For a list of the most up-to-date parameters and the firmware version they are associated with, please visit the Blue Series Fan Switch Parameter Page

Zigbee Bindings

Zigbee binding is when two or more Zigbee products communicate directly with one another without the need to communicate with a hub. There are two main benefits of utilizing Zigbee binding: speed & local control.

From a speed standpoint, cutting out the middle-man (hub) can save precious milliseconds or even seconds depending on your cloud and/or processing power off your hub. Whereas from a local control standpoint, if your hub goes does down and cannot communicate, your products can still talk to each other.

To setup Zigbee Binding with Zigbee2MQTT, please see this article: Setting Up Zigbee Bindings • Zigbee2MQTT

Did this answer your question?