--- title: "Add Device" slug: "add-device" updated: 2026-10-26T23:40:41Z published: 2026-10-26T23:40:41Z canonical: "docs.verdi.ag/add-device" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.verdi.ag/llms.txt > Use this file to discover all available pages before exploring further. # Add Device ## Overview Add Device puts a new Verdi device on your dashboard in about a minute. You scan its QR label, mark where it sits on the map, tell Verdi what is plugged into it, and name it. Use it from a phone in the field or a computer at [app.verdi.ag](https://app.verdi.ag). This article is for User and Admin accounts. What you set up depends on the device: | Device | What you set up | | --- | --- | | Block Controller (Gen 4) | Location, plus one valve or pump and the zones it serves | | Micro-Block Controller | Location, plus up to two valves and their zones. Add no valves for a sensor-only Micro. | | ePlant TreeTag dendrometer | Location and the zones it monitors | | SDI-12 Remote Telemetry Unit | Location and the zones it monitors | | Gateway (Gen 1 or Gen 2) | Location and name only | Davis weather stations are connected through WeatherLink, not Add Device. See [Davis Weather Stations (WeatherLink)](https://docs.verdi.ag/docs/en/davis-weatherlink-integration). ## Before you start - **Have the device in hand.** You need its QR label, or the Device ID printed beside it (for example, eui-fcc23d000042fca3). - **Leave the battery disconnected.** Connect it at the end, after the device is saved. - **Check your zones.** Valves and sensors are linked to zones on your map. If a zone you need is missing, contact Verdi support before you start. - **Select the right account.** If you manage more than one account, choose it first. Add Device is unavailable until an account is selected. - **Allow camera access** in your browser when asked. The camera reads the QR label. See Troubleshooting if the camera does not open. ## Add a device ### 1. Open Add Device On the map, tap **+ Add Device**. ![](https://cdn.document360.io/21bcacda-1800-45ee-8df3-7d1d6186e001/Images/Documentation/fig1-add-device-button.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A18%3A13Z&se=2026-11-19T05%3A18%3A13Z&sr=b&sp=r&sig=4HxPC%2FsdvSXFpi5cO1EFr029lF0FAsAfZIV52a%2B%2FrWA%3D) ### 2. Scan the QR code Hold the device's QR label inside the green frame. Verdi reads it automatically and moves on. Tap **Swap Camera** to switch cameras. - **Label won't scan?** Tap **Manually Enter Device ID**, pick your device type, and type the ID printed beside the QR code. You can leave off the "eui-" at the start. - **Asked to pick a device type?** Some labels match more than one type. Choose the one that matches your device. ![](https://cdn.document360.io/21bcacda-1800-45ee-8df3-7d1d6186e001/Images/Documentation/fig2-scan-qr.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A18%3A13Z&se=2026-11-19T05%3A18%3A13Z&sr=b&sp=r&sig=iCvZMnIFtqo9bSaiTeT%2B41mn0KkucnVEf%2FGCPB0HQJw%3D) ### 3. Place the device on the map Tap the map where the device is installed. A pin marks the spot and its coordinates appear under **Position**. Tap again to move it, then tap **Confirm Location**. Place it carefully: this pin is where you will find the device on your dashboard. ![](https://cdn.document360.io/21bcacda-1800-45ee-8df3-7d1d6186e001/Images/Documentation/fig3-place-device.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A18%3A13Z&se=2026-11-19T05%3A18%3A13Z&sr=b&sp=r&sig=9DwDVoAuXY6eJK%2BGmnaKcREMoGzFsorKyeaidGWTcl4%3D) ### 4. Add the connected equipment Tell Verdi what is wired to the device. **Equipment (0/1)** means one port is free. Tap **Add Equipment**, then choose **Valve** or **Pump**. Micro-Block Controllers take valves only, so they skip this choice. Nothing wired yet, or a sensor-only device? Tap **Skip Connecting Equipment** and go to step 6. ![](https://cdn.document360.io/21bcacda-1800-45ee-8df3-7d1d6186e001/Images/Documentation/fig4-equipment-type.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A18%3A13Z&se=2026-11-19T05%3A18%3A13Z&sr=b&sp=r&sig=FS3GVcw2Zje3jpNkDGqWf97%2FMrcppXzlPnWHoyolBJE%3D) For an ePlant TreeTag or SDI-12 unit, you choose the zones it monitors here instead, then go to step 6. Gateways skip straight to step 6. ### 5. Choose the zones From the dropdown, select every zone the valve irrigates. For a pump, select every zone it supplies. Selected zones turn green on the map. Tap **Save**. Back on **Connected Equipment**, check your list. Tap the gear to edit or the trash can to remove. Add more equipment if a port is still free, then tap **Continue**. ![](https://cdn.document360.io/21bcacda-1800-45ee-8df3-7d1d6186e001/Images/Documentation/fig5-valve-zones.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A18%3A13Z&se=2026-11-19T05%3A18%3A13Z&sr=b&sp=r&sig=yzbjwyPwYRJEseSb1nnyv%2BAGijA9q99HiKGPsjfItJk%3D) ### 6. Name and save The device is named after its ID by default, such as D-TEZ-620. Rename it to something your team will recognize, like "Block E Valve". Check the device type, EUI, and connected equipment. Tap the pencil to change equipment. Then tap **Confirm & Save**. ![](https://cdn.document360.io/21bcacda-1800-45ee-8df3-7d1d6186e001/Images/Documentation/fig6-confirm-name.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A18%3A13Z&se=2026-11-19T05%3A18%3A13Z&sr=b&sp=r&sig=PhV20gnLcRC38vLHfCH7x6PC1vwf3wSTwOWheqUIsx4%3D) ### 7. Connect the battery The device is registered. Connect its battery now so it contacts Verdi right away. The screen shows how long the first connection should take, about 6 minutes for a Block Controller (Gen 4). You don't need to wait. Tap **Add Another Device** to keep going, or **See This Device** to open its Device Card. ![](https://cdn.document360.io/21bcacda-1800-45ee-8df3-7d1d6186e001/Images/Documentation/fig7-registered.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A18%3A13Z&se=2026-11-19T05%3A18%3A13Z&sr=b&sp=r&sig=PMys%2Bhd2SImlmt5DwaFbmx8RZpFAykvYJE1SAhM2BX0%3D) ## After registration The device shows on your map right away. Its connection details appear on the [Device Card](https://docs.verdi.ag/docs/device-card) once it first contacts Verdi. - **Micro-Block Controller:** to make it contact Verdi immediately, hold a strong magnet against the back of the device until you hear a soft click. - **Gateway:** there is no time estimate. The gateway is confirmed once another device reports through it. - **Changing zones or equipment later:** open the device's Device Card. For wiring and mounting, follow the [Block Controller Installation](https://docs.verdi.ag/docs/block-controller-installation) guide. ## Troubleshooting **The camera doesn't open.** Your browser needs camera permission for app.verdi.ag. Allow it, refresh the page, and try again. Or use **Manually Enter Device ID**. - **iPhone or iPad:** Settings > Safari > Camera, set to Allow or Ask. - **Chrome (phone or computer):** tap the lock icon in the address bar, open Site settings, and set Camera to Allow. - **Safari on Mac:** Safari > Settings > Websites > Camera, and set app.verdi.ag to Allow. **The device ID isn't accepted.** Check it matches the ID printed beside the QR code, character for character. **The device is already registered.** If it is on your account, find it on the map or with **Search** instead of adding it again. If it belongs to another account, contact Verdi support. **I put the pin in the wrong place.** Before saving, tap the back arrow to return to the map. After saving, move the device from its Device Card. **I closed Add Device partway through.** Nothing is saved until you tap **Confirm & Save**. Start again from **+ Add Device**. **The device hasn't connected after the estimated time.** Check the battery is connected. For a Micro, use the magnet. If it still hasn't connected, contact Verdi support. Need help? Email support@verdi.ag or call (855) 945-5628.