Table of Contents

Asset information overlay

This document describes how to format your JSON file to include additional asset information (asset metadata) when importing your data. Attach additional information by including a URL to an image file, a URL to a video file, or a string of text when you create your import file.

To see the basic JSON format without additional asset information, see Importing via JSON.

Attach metadata to video or image imports

Reasons to attach an image to an asset:

  1. The asset is part of a larger image and labelers may need to see the larger image for context.
  2. Labelers need a an image to reference to help them label correctly.

Attach a video to the asset to give context for the images being labeled.

Attach text to an asset to provide context, instructions or guidance to the labeler.

To specify additional asset information, include the following fields under info in your JSON import file.

type

The media type attached to your asset. Value will be IMAGE, VIDEO, or TEXT.

value

Paths to external URLs to render on the web page as a video or image embed. Text strings that are not paths will be rendered as text.

The example below will import three image assets with an image, a video, or text attached to each asset.

[ 
{
"externalId": "2017-Tesla-Model-S-P90D-102.jpg",
"imageUrl": "https://storage.googleapis.com/labelbox-example-datasets/tesla/2017-Tesla-Model-S-P90D-102.jpg",
"info": {
"type": "IMAGE",
"value": "https://storage.googleapis.com/labelbox-example-datasets/tesla/2017-Tesla-Model-S-P90D-102.jpg"
}
},
{
"externalId": "2017-Tesla-Model-3-top-view.jpg",
"imageUrl": "https://storage.googleapis.com/labelbox-example-datasets/tesla/2017-Tesla-Model-3-top-view.jpg",
"info": {
"type": "VIDEO",
"value": "http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4"
}
},
{
"externalId": "2016-tesla-model-s-17-of-43.jpg",
"imageUrl": "https://storage.googleapis.com/labelbox-example-datasets/tesla/2016-tesla-model-s-17-of-43.jpg",
"info": {
"type": "TEXT",
"value": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."
}
}
]

Attach metadata to text imports

The example below will import one text asset with an image attached.

[ 
{
"data": "Lorem ipsum dolor sit amet..." ,
"info": {
"type": "IMAGE",
"value": "https://storage.googleapis.com/labelbox-example-datasets/tesla/2016-tesla-model-s-17-of-43.jpg"
}
}
]

Import your JSON file

To learn how to import your JSON file, see Import your JSON file.

View the asset metadata

You can view an asset’s additional information by clicking the tab icon in the top left corner when the asset is loaded in the labeling interface.

Was this page helpful?

Import via JSON

Importing TIFF files

Contact