File Explorer

Quickly import data in bulk from private cloud storage.

There is a plugin with the same name performing a similar function. In most cases, the built-in file explorer (this page) supersedes and supplants the plugin.

If you are still looking for the documentation for the older File Explorer (Plugin), see here.

The File Explorer allows you to navigate your private storages' files and folders to quickly import either single files or entire folders to your Ango Hub project.

Prerequisites

You must have created a storage integration between Ango Hub and the cloud storage where the files you wish to import are located. Please follow the instructions in the docs page on storages to do so.

Accessing and Navigating the File Explorer

From the project where you would like to import data, navigate to the Assets tab, then click on Add Data and enter the tab called File Explorer. The File Explorer will open.

From the Storage Method dropdown on the left-hand side of the screen, please select a storage integration you have created by following the instructions in the storages page.

Then, from the Bucket dropdown, select a bucket.

If Ango Hub does not have sufficient permissions and it cannot see the buckets in your cloud storage account, the File Explorer will prompt you to enter the name of the bucket manually.

Once you have selected a storage method and a bucket, the files and folders in the bucket will appear on the right-hand side of the screen:

Double click on a folder name to navigate to the folder.

Importing Folders or Files

Click on the folder or file you would like to import to your project, then click on Upload on the bottom-left corner of the screen.

To import multiple folders or files, hold Ctrl (on Windows) or ⌘ (on Mac) and click on the files or folders you would like to add to your selection. You may also quickly add a series of files or folders by clicking on the first, then holding Shift, and clicking on the last to be selected.

File Explorer Configuration

Upload Subfolders: When selecting a folder to be imported, File Explorer will also navigate to its subfolders and import all files in all subfolders recursively.

Multi-page asset upload: When selecting a folder containing images, the contents of the folder will be imported as a single multi-image asset.

PCT upload: Coming soon.

Batch Assignment: File Explorer can assign imported assets to batches on import. From this dropdown, you can pick one of four batch assignment types:

Don't Assign (default) does not assign any new asset to any batch. Assign Folder Path will assign assets to a batch name corresponding to their file path. For example, if a file "image.jpg" is contained in your bucket in the "vehicles/images/jpg/" folder, its batch name will be "vehicles/images/jpg", where "vehicles" is the root folder, and "images" and "jpg" are subfolders. Assign Folder Name will assign each asset a batch name equal to the name of the folder where it is located. Custom allows you to assign all assets being uploaded to a custom batch.

Accepted Extensions: Select here extensions to whitelist while importing files in bulk. Files not having the extensions in this list will not be imported.

Ignored Extensions: Select here extensions to blacklist while importing files in bulk. Files having the extensions in this list will not be imported.

Manual Index Selection: Upon enabling this toggle, indices will be prepended to items currently visible in the File Explorer, like so:

By entering start and end index numbers in the text areas below the toggle, you will be able to limit which files will be imported: