Knowledge Base

Registering you AirGradient Open Air on the AirGradient Dashboard

Learn how to add your AirGradient Open Air 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 Open Air 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 Open Air, 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

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

3 - Pick which dashboard (Place) you want to associate the monitor with (if you have multiple) or create a new Place:

Alt text

4 - Enter a location name for the monitor location

Alt text

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

Alt text
Alt text

6 - 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 (DIY Kit 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 Open Air.

Alt text

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 Open Air the latest model number is generally either:

  • O-1PST (Standard Wi-Fi Version)

  • O-1PST-CE (Cellular Version)

Alt text

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

Alt text

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

6 - Enter a location name for the monitor.

Alt text

7 - Choose whether you want to share your data publicly:

Alt text

8 - If you do choose to share your data publicly, you will need to enter a public name for the location and location coordinates.

Alt text

You can copy the location coordinates from Google Maps by right clicking on a location. The coordinates should be at least 4 decimal points long:

Alt text

Note: If you’re sharing data with OpenAQ the public name of the location will need to be unique. Locations with common names can have problems displaying on the OpenAQ side.

9 - Finally, scroll down and click Add.

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

Alt text
Alt text

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

2 - Click Add New

Alt text

3 - Enter:

  • Serial number

  • Maker: AirGradient

  • Model number

Alt text

4 - 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
Alt text
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...