Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions config/sitemap.json
Original file line number Diff line number Diff line change
Expand Up @@ -591,8 +591,8 @@
"hash": "61fbc6cd51322eae629148216875b973c3ebe17e8fffe98f28811eb1b77342c0"
},
"getting-started/console/console.md": {
"date": "2026-04-29",
"hash": "3d0635b4e83fcc64b282d174cd78a4526ec524b4337d52a0a459654180fc8e4e"
"date": "2026-06-22",
"hash": "f7e445857515ce708cf605c3b711ff45cf39e475d0a53e47e2f1a3ae4a92b01e"
},
"getting-started/console/development-devices.md": {
"date": "2025-03-18",
Expand Down Expand Up @@ -8223,8 +8223,8 @@
"date": "2023-11-08"
},
"getting-started/new.md": {
"hash": "bbd393275812c0569a83809633fdf0671d44738c6ceea89ef0d2fc2857235a06",
"date": "2026-06-12"
"hash": "2dbefab1175a3be7d43d07a6b2e759be579d1a3269ae08980f977e94bba843eb",
"date": "2026-06-22"
},
"getting-started/cloud/logic.md": {
"hash": "71a1026986a744d0446ae3a1156cbcb68840de48db731768ccedc6861c035c16",
Expand Down
Binary file added src/assets/images/console/add-devices-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/assets/images/console/add-devices-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/assets/images/console/add-devices-3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/assets/images/console/add-devices-4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/assets/images/console/add-devices-5.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/assets/images/console/add-devices-6.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
41 changes: 26 additions & 15 deletions src/content/getting-started/console/console.md
Original file line number Diff line number Diff line change
Expand Up @@ -372,33 +372,44 @@ When working with devices that belong to your Product, it is important to note t

### Adding devices

Now that you have your Product, it's time to import devices. Importing devices will assign them to your Product and allow you to start viewing and managing these devices within your Product Console.
Now that you have your Product, it's time to add devices. Adding devices will assign them to your Product and allow you to start viewing and managing these devices within your Product Console.

For any product you may be developing, you likely have one or more Particle development kits (i.e. a Photon) that you have been using internally for prototyping purposes. We strongly recommend importing these devices into your Product, and using them as your *development group*.

In addition, you'll want to have a *test group* of devices to serve as the guinea pigs for new versions of product firmware. You should get into the habit of uploading a new version of firmware to your product, and flashing it to your test group to ensure your code is working as expected. This too will be covered more in-depth in the [rollout firmware](#rollout-firmware) section below.

To import devices, click on the Devices icon in your product sidebar, then click on the "Import" button.
To add devices, click on the Devices icon in your product sidebar, then click on the **Add Devices** button.

![Your product's devices](/assets/images/devices-page.png)
![Product device list](/assets/images/console/add-devices-1.png)

To allow you to import devices in bulk, we allow you to upload a file containing multiple device IDs. Create a `.txt` file that contains all of the IDs of devices that you would like to import into your product, one on each line. [Not sure what your device ID is?](/getting-started/developer-tools/cli/#running-from-source-advanced-particle-identify) *You cannot register devices that have already been 'claimed' by someone outside of your team; all of these devices must either belong to a team member or belong to no one*. The file should look something like this:
You will then have several options for what to import:

```
55ff6d04498b49XXXXXXXXXX
45f96d06492949XXXXXXXXXX
35ee6d064989a9XXXXXXXXXX
```
![Add devices with order](/assets/images/console/add-devices-2.png)

#### Add one device - Adding devices

You can add a single device by entering its Device ID, ICCID, IMEI, or Serial number. For more information about unique identifiers for devices, see [serial number management](/hardware/best-practices/serial-number/).

![Add one device](/assets/images/console/add-devices-6.png)

#### Add many devices - Adding devices

You can add multiple devices from a file in multiple formats:

- .txt file: One device per line containing the Device ID, serial number, IMEI, or ICCID.
- .csv file: One column must be named `DEVICEID` and contain the 24-character hexadecimal Device ID.

![Add many devices](/assets/images/console/add-devices-4.png)

#### Add from order - Adding devices

Where each line is one Device ID. Once you have your file ready, drop it onto the file selector in the import devices dialog box.
If you've ordered devices in bulk, you can add all of the devices in the order.

![Import devices modal](/assets/images/import-devices.png)
![Add from order](/assets/images/console/add-devices-3.png)

As noted at the bottom of the dialog box, if you previously rolled out
firmware, those newly imported devices will be updated over the air to
that firmware next time they connect to the Particle Device Cloud.
If no orders can be found, this message will be displayed. Orders of "each" devices placed on the Particle store cannot be automatically imported.

The [Import Devices Tool](/tools/cloud-tools/import-devices/) can be used to simplify the process of doing multiple operations such as adding the device, claiming, naming, etc. for multiple devices.
![No orders available](/assets/images/console/add-devices-5.png)


### Rollout firmware
Expand Down
4 changes: 4 additions & 0 deletions src/content/getting-started/new.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,10 @@ When adding new items to this page:

The header format must be exactly that because the search feature uses that to delimit entries, and determine the date of entries
--}}
### Console add devices 2026-06-22

You can now add devices to a product directly from an order, or upload files in other formats. See [console add devices](/getting-started/console/console/#adding-devices).


### Web Device Doctor 2026-06-12

Expand Down
1 change: 1 addition & 0 deletions src/content/notes/fleet-setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,5 +5,6 @@ Even if you are still prototyping and developing, it's a good idea to start by [
There are many ways to manage onboarding devices at scale. For examples, see:

- [Cellular manufacturing guide](/scaling/manufacturing/manufacturing-cellular/)
- [Console add devices](/getting-started/console/console/#adding-devices)
- [Import devices tool](/tools/cloud-tools/import-devices/)