From 937ee12c9cce70618146e93b9ec993e2ae23d95e Mon Sep 17 00:00:00 2001
From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Date: Wed, 11 Jun 2025 10:16:43 +0200
Subject: [PATCH] Z-Wave device exclusion: add intro para (#39471)

---
 source/_integrations/zwave_js.markdown | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/source/_integrations/zwave_js.markdown b/source/_integrations/zwave_js.markdown
index 1787ffe9fde..7a11637f427 100644
--- a/source/_integrations/zwave_js.markdown
+++ b/source/_integrations/zwave_js.markdown
@@ -82,7 +82,7 @@ For more Z-Wave term definitions, refer to the [terminology section](#z-wave-ter
 To run a Z-Wave network, you need the following elements:
 
 - A [supported Z-Wave controller](/docs/z-wave/controllers/#supported-z-wave-usb-sticks--hardware-modules). First-time user? For recommendations on what to buy, go [here](#which-z-wave-controller-should-i-buy).
-- A running Z-Wave JS server.
+- A running [Z-Wave JS server](#setting-up-a-z-wave-js-server).
 - An installed Z-Wave integration in Home Assistant.
 
 ### Setting up a Z-Wave JS server
@@ -155,6 +155,8 @@ While your Z-Wave mesh is permanently stored on your dongle, the additional meta
 
 ### Removing a device from the Z-Wave network
 
+Do this before using the device with another controller, or when you don't use the device anymore. It removes the device from the Z-Wave network stored on the controller. It also removes the device and all its entities from Home Assistant. You can not join a device to a new network if it is still paired with a controller.
+
 1. In Home Assistant, go to {% my integrations title="**Settings** > **Devices & services**" %}.
 2. Select the **Z-Wave** integration. Then, select **Configure**.
 3. Select **Remove device**, then **Start exclusion**.