Knowledge Base

Registering you AirGradient ONE on the AirGradient Dashboard

Learn how to add your AirGradient ONE monitor to the dashboard using a QR code or manual setup. This guide covers both pre-assembled units and DIY kits.

Table of Contents

There are two ways to add your AirGradient ONE to the dashboard.

You can:

The order does not matter. However, the device will not send any data to the dashboard until both steps have been completed.

Add to dashboard using the QR code (pre-assembled units)

If you have a pre-assembled AirGradient ONE, you can add it using the “Add to Dashboard” QR code printed on the back of the device.

  1. Scan the Add to Dashboard QR code
Alt text
  1. You will be taken to the AirGradient Dashboard: https://app.airgradient.com/
  • Log in, or create an account if you don’t already have one
  • The monitor’s serial number will be pre-filled
Alt text
  1. Pick which dashboard (Place) you want to associate the monitor with (if you have multiple) or create a new Place.
Alt text
  1. Enter a location name for the monitor
Alt text
  1. Select the exact model number. For assembled monitors, this is printed on the back of the monitor:
Alt text

If you’re unsure, see: AirGradient Models

Alt text
  1. Click Add
Alt text

The monitor will now appear in your dashboard. You should see an entry for the monitor on your dashboard, but it will likely show as offline for the first minute or two. Please allow up to five minutes for the monitor to show as online and for the data to begin reporting.

Alt text

Add to dashboard manually (Kits or QR code not working)

If you have a DIY kit, or if the QR code does not work, you can add the device manually:

  1. Open the monitor onboarding guide.
  2. Select the monitor type that you are trying to connect to your dashboard. In this case, you need to select the AirGradient ONE.
Alt text
  1. Select the exact model number. For assembled monitors, this is printed on the back of the monitor but for DIY kits, it is not. For the AirGradient ONE the latest model number is generally either:
  • I-9PSL-DE (Standard Wi-Fi Version)

  • I-9PSL-DE-CE (Cellular Version)

Alt text

If you’re unsure, see: AirGradient Models

  1. Pick which dashboard (Place) you want to associate the monitor with (if you have multiple) or create a new Place
Alt text
  1. Enter the serial number (SN) of the monitor.
Alt text

For assembled monitors, the SN printed on the back of the monitor but for DIY kits, it is not. To find the SN for the DIY kits, when you startup the monitor, you can see a message “180s to connect to WiFi Hotspot airgradient-xxxxx”. The xxxxx is the serial number of the monitor. Please make sure that you use it in lower case only and also do not use “airgradient-” which is not part of the serial number. So if for example, the display shows “airgradient-625bf2”, then “625bf2” is the serial number.

  1. Enter a location name for the monitor and click Add
Alt text
  1. You will next be provided with the steps to connect the device to your WiFi network. If you’ve already connected the device to your network, you can skip this step and click Next Step. Finally, click To Dashboard.
Alt text

The monitor will now appear in your dashboard. You should see an entry for the monitor on your dashboard, but it will likely show as offline for the first minute or two. Please allow up to five minutes for the monitor to show as online and for the data to begin reporting.

Alt text

If you don’t begin to receive data after five minutes, please confirm that the serial number is correct.

Adding an additional monitor to an existing dashboard

If you already have an AirGradient dashboard and the device is already connected to Wi-Fi:

  1. Go to Dashboard > Hardware
Alt text
  1. Click Add New
Alt text
  1. Enter:
  • Serial number

  • Maker: AirGradient

  • Model

Alt text
  1. Click Save
Alt text

Please note that adding a hardware entity alone is not enough.

To see data, you must also create a Location and assign the monitor to that Location.

Alt text
Alt text

⚠️ If a location is not created and linked to the hardware entity, the device will appear in the dashboard but you will not see any data until you also create a Location and tie the monitor to that location.

Your are being redirected to AirGradient Dashboard...