Annotations cannot be saved in PIX4Dcloud
This article explains the most common reasons why annotations cannot be saved in PIX4Dcloud and provides guidance on how to identify the cause and recover or re-import the affected annotations when possible.
Licenses: This article is valid for PIX4Dcloud Starter and PIX4Dcloud Pro licenses.
Roles: Only Owners, Managers, and Editors can permanently upload and save annotations in PIX4Dcloud.
Issue Description / Causes
Annotations may fail to be saved in PIX4Dcloud under the following circumstances:
1. Annotation Migration Failure
Due to internal changes in how annotations are stored, existing annotations are automatically migrated to a new database when an older project is opened.
If the migration process fails, the user interface displays:
-
A notification indicating that there was a problem with the migration.

-
A failed status icon next to the annotation layer that could not be migrated.

Selecting the affected annotation layer displays the specific reason for the failure.
2. Unsupported Annotation Format During Import
When importing annotations into the annotation hierarchy, some files may not meet the supported format requirements. In this case:
-
The annotation is not imported.
-
A failed status icon appears under the annotation layer hierarchy.
-
Selecting the layer displays the exact reason for the failure.
Possible Solutions / Checks
For Annotation Migration Failures
-
Click Download backup to export the affected annotations in GeoJSON format.
-
If the file is large or complex, split it into smaller files with fewer coordinates.
-
Re-import the corrected files into the project.
For Import Failures
-
Verify that the annotation file format is supported by PIX4Dcloud.
-
Check the error message displayed when selecting the failed annotation layer.
-
Correct the file structure or geometry as indicated and re-import the annotation.
Warning: Clicking Dismiss or refreshing the page removes the failed status icon. Any annotations that were not successfully migrated will be permanently lost if no backup is downloaded.