diff --git a/config/sitemap.json b/config/sitemap.json index 03482a811f..1b7abd4d5e 100644 --- a/config/sitemap.json +++ b/config/sitemap.json @@ -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", @@ -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", diff --git a/src/assets/images/console/add-devices-1.png b/src/assets/images/console/add-devices-1.png new file mode 100644 index 0000000000..6ee9c0b0e6 Binary files /dev/null and b/src/assets/images/console/add-devices-1.png differ diff --git a/src/assets/images/console/add-devices-2.png b/src/assets/images/console/add-devices-2.png new file mode 100644 index 0000000000..9161d9019d Binary files /dev/null and b/src/assets/images/console/add-devices-2.png differ diff --git a/src/assets/images/console/add-devices-3.png b/src/assets/images/console/add-devices-3.png new file mode 100644 index 0000000000..5a643e01f2 Binary files /dev/null and b/src/assets/images/console/add-devices-3.png differ diff --git a/src/assets/images/console/add-devices-4.png b/src/assets/images/console/add-devices-4.png new file mode 100644 index 0000000000..687214a46b Binary files /dev/null and b/src/assets/images/console/add-devices-4.png differ diff --git a/src/assets/images/console/add-devices-5.png b/src/assets/images/console/add-devices-5.png new file mode 100644 index 0000000000..ac7481c9c9 Binary files /dev/null and b/src/assets/images/console/add-devices-5.png differ diff --git a/src/assets/images/console/add-devices-6.png b/src/assets/images/console/add-devices-6.png new file mode 100644 index 0000000000..d6892beb14 Binary files /dev/null and b/src/assets/images/console/add-devices-6.png differ diff --git a/src/content/getting-started/console/console.md b/src/content/getting-started/console/console.md index 13f3dc48cb..8c4b92c15d 100644 --- a/src/content/getting-started/console/console.md +++ b/src/content/getting-started/console/console.md @@ -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 diff --git a/src/content/getting-started/new.md b/src/content/getting-started/new.md index 66575a810e..fb92464f8d 100644 --- a/src/content/getting-started/new.md +++ b/src/content/getting-started/new.md @@ -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 diff --git a/src/content/notes/fleet-setup.md b/src/content/notes/fleet-setup.md index 249506a98a..8ed61e4786 100644 --- a/src/content/notes/fleet-setup.md +++ b/src/content/notes/fleet-setup.md @@ -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/)