Importing Multiple Images in One Asset (Grid or Carousel)

You may group together images and upload them to Hub as a single asset, where each page is one of the images uploaded.

These images can then be viewed in "Carousel" mode (where users can flip between images with arrows) or "Grid" mode.

You may upload such multi-image assets using the Cloud Import method outlined below.

Uploading Multi-Image Assets

Prepare a JSON like the following, where each URL points to an image you'd like to include in the asset. The order of the URLs will determine the order in which images will be presented to the annotator as pages.

While there is no hard limit, we recommend limiting the number of images in a single dataset to 100 or less.

The following JSON will import two assets of four images each:

[
  {
    "externalId": "my-asset-external-id-1",
    "dataset": [
      "https://url.com/65c18c8b-4513-4a0a-b876-1aeb2e0908ec.png",
      "https://url.com/b0b70590-e4cc-42ef-8537-3ee3f7917fed.jpg",
      "https://url.com/38e11364-1ce0-417a-9e38-436468c555ce.jpg",
      "https://url.com/eff59355-03bd-447f-aa47-46028f90c2e6.jpg"
    ]
  },
  {
    "externalId": "my-asset-external-id-2",
    "dataset": [
      "https://url.com/65c18c8b-4513-4a0a-b876-123456789012.png",
      "https://url.com/b0b70590-e4cc-42ef-8537-234456566787.jpg",
      "https://url.com/38e11364-1ce0-417a-9e38-876345383488.jpg",
      "https://url.com/eff59355-03bd-447f-aa47-319485019239.jpg"
    ]
  }
]

From your project dashboard, go to the Assets tab and click on Add Data. Then, enter the Cloud Upload section and drag and drop your JSON on the file upload field. Then, press on Upload. Your multi-image asset(s) will be uploaded.

If the files you are uploading are located in a private storage, select your storage method from the Storage Method dropdown on the right. Read more here about storage integrations on Ango Hub.

Viewing Modes

Users can view images in two different ways: one at a time in Carousel mode, and multiple at once in Grid mode.

To switch between the two modes, click on the following button in the toolbar of the image labeling editor, or press "F" on your keyboard:

Carousel Mode

Carousel mode has a navigation bar at the top, where users can flip between images by clicking on the arrows or by entering the page number.

Users can only see and annotate one image at a time.

Grid Mode

Grid mode displays up to 16 images at a time. (in datasets larger than 16 images, only the first 16 images).

Dragging the icon on an image allows you to change its position in the grid.

The button makes the image full screen.

Focus Mode

By holding Alt (Option on macOS) and clicking on multiple images, then by clicking on the "layout" button that appears:

You can focus your view on only those images. Click the button again to exit focus mode.