Manage the repository

The Perfecto Repository is the storage where you keep and manage all your digital assets, such as Android and iOS apps, images, audio files, scripts, or any other files you may need for testing purposes. In the Repository management view, you can upload, download, and delete files, search for files, or modify file information.

The repository has a flat structure. It does not include any folders or subfolders. If you need to distinguish between files that have the same filename, you can change the file name. If you need to keep the file name, you can change the locator, which essentially serves as a virtual path. The locator is the file path that is included in your automation code and API calls. If you migrated from a repository in the legacy Perfecto UI, the locator also represents the former folder structure or hierarchy. It allows you to find files that once used to reside in the same folder.

You can keep files private, make them publicly available, or give access permission to people in your group. These categories are represented as dedicated tabs at the top of the Repository management view.

The folders on the left provide access to specific file types: All apps, Android apps, iOS apps, Simulator apps, images, audio files, and other miscellaneous files. You can also view all files recently used, provided you have view permissions for them.


The Simulator apps folder is reserved for files of type .zip that contain .app files for installation on virtual iOS devices. Be aware that on Windows, .app files appear as folders, so when creating a .zip file, you need to do this at the level of the .app folder.

The maximum file size is 1 GB for applications and 150 MB for all other files. All file types are supported.

For Perfecto's active accounts, files remain in the repository as long as they are being used. Usage includes injection from the repository as part of automation or manual testing, but it does not include editing. As part of Perfecto's retention policy, files that have not been used for a year will be removed from the repository. 


You can also work with the repository via the Perfecto REST API. For details, see Legacy | Repository Operations.

You can add tags to repository files to make them easier to find and handle. Tags facilitate better search and orientation, especially in large repositories where new files are added constantly. File tags are displayed in a dedicated table column and in the info panel for a file.

Repository files are available to you when you use features such as audio injection, image injection, and image analysis.

Watch this short video to get an overview of repository management. For detailed steps, expand any of the following procedures.