Skip to main content

How do I connect my AirGradient ONE to the AirGradient Dashboard?

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

one-add-to-dashboard.webp

  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

dash-monitor-serial.webp

  1. Pick which dashboard (Place) you want to associate the monitor with (if you have multiple) or create a new Place (Link to article on difference between Place and Location?)

dash-place.webp

  1. Enter a location name for the monitor

dash-location.webp

  1. Select the exact model number. For assembled monitors, this is printed on the back of the monitor:

model-back.webp

dash-select-model.webp

  1. Click Add

dash-click-add.webp

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. 

dash-first-time-load.webp

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.

dash-manual-select-monitor.webp

3. 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)

dash-manual-select-current-model.webp

If you’re unsure, see: AirGradient Models

4. Pick which dashboard (Place) you want to associate the monitor with (if you have multiple) or create a new Place (Link to article on difference between Place and Location?)

dash-manual-place.webp

5. Enter the serial number (SN) of the monitor. 

dash-manual-enter-sn.webp

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.

6. Enter a location name for the monitor and click Add

dash-manual-enter-location-name.webp

7. 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. 

dash-manual-connect-to-wifi.webp

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. 

dash-manual-first-time-loading.webp

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

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

dash-add-monitor-to-existing-dash.webp

  1. Click Add New

dash-add-new.webp


  1. Enter:

  • Serial number

  • Maker: AirGradient

  • Model

dash-enter-sn-maker-model.webp


  1. Click Save

dash-click-save.webp

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.


dash-create-location-1.webp


dash-create-location-2.webp


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.