IoT Platform provides the over-the-air (OTA) update and management feature. To update devices, make sure that your devices support the OTA service. Then, you can upload an update package to the IoT Platform console and push OTA update notifications to the devices. This article describes the limits and procedure of OTA updates.


Before you use the OTA update feature, make sure that your devices support the OTA service.

Background information

Take note of the following limits of OTA updates:

  • Each Alibaba Cloud account can have a maximum of 500 update packages.
  • The maximum size of an update package file is 1,000 MB. The file format can be only .bin, .tar, .gz, .zip, .gzip, .apk, or .tar.gz.
  • Take note of the following limits of update batches:

    Update batches: IoT Platform shows created update tasks as different update batches. You can go to the Update Package Details page and view the update batch of the update package on the Batch Management tab.

    • You can use an update package to create one or more update batches for different firmware versions to be updated.
    • You can use an update package to create only one dynamic update batch for a firmware version to be updated.
    • Each device in a dynamic update batch can be updated up to 10 times.
    • You can use multiple update packages to create multiple update batches for the same firmware version. In this case, only the latest dynamic update batch takes effect.
    • Each module of a device can have only one ongoing update batch at the same time. A device that has an ongoing update batch is in the To Be Pushed, Pushed, or In Upgrade state.
  • Only devices that are connected to IoT Platform by using the Message Queuing Telemetry Transport (MQTT) protocol support the OTA update feature.
  • If devices are online, these devices can immediately receive update notifications. If devices are offline, IoT Platform pushes update notifications when devices go online.
  • After a device is distributed to the destination instance, you can perform OTA updates on the device.


  1. Add an update package: Add an OTA module and update package to a product.
  2. Verify an update package (Optional): Verify the package.
    • If you set the Verify Update Package parameter to No when you add the update package, skip this step.
    • After tested devices are updated and the status of the update package is displayed as Verified, you can perform a batch update.
  3. Initiate a batch update task: Push the upgrade package to devices for OTA update.
  4. View update status: View the update status of the devices and the information of the update package.
  5. View statistics on update package versions and success rates: View the statistics on version distribution and success rate distribution after the update.