Guidelines for optimal performance

While the Encord platform is able to handle large volumes of data, we strongly recommend working within the following limits to ensure smooth operations and limit loading times.

The limits outlined below apply for both the SDK, and the Encord platform.

Get Help (AI Help Widget)

While delving into the Encord platform, you might have questions about how to use specific features or use cases that are of interest. Encord provides an AI Help widget that can help you with those needs.

You can close the AI Help widget at anytime if you feel it is in your way.

To access the widget again after closing, click the Help button and toggle the switch for the AI Help widget.


Import into Encord

The following recommendations apply to the Encord platform and the SDK.

We recommend uploading files in batches not exceeding 2GB, to ensure upload does not exceed 3 hours.
Image groups upload faster than image sequences. To understand the differences between these file types, we recommend learning more here.

Encord enforces the following upload limits for each JSON file used for file uploads:

  • Up to 1 million URLs
  • A maximum of 500,000 items (e.g. images, image groups, videos, DICOMs)
  • URLs can be up to 16 KB in size

Optimal upload chunking can vary depending on your data type and the amount of associated metadata. For tailored recommendations, contact Encord support. We recommend starting with smaller uploads and gradually increasing the size based on how quickly jobs are processed. Generally, smaller chunks result in faster data reflection within the platform.

Before importing your data think about how you want to search for and filter your data. Custom metadata can always be added to your data after your initial data import, but starting with a strong foundation of custom metadata (by importing it with your data) can significantly decrease the time to ROI and achieving your goals.

LimitEnterpriseTeamFree
Maximum # of data units at one time10,0002,5001000
Maximum image/video/DICOM file size1 GB1 GB25 MB
Maximum JSON file size100 MB or 10,000 entries100 MB or 2500 entries10 MB
Label row / Annotation task limit50 MB50 MB10 MB
Model predictions import limit50 MB50 MB10 MB
Maximum resolution4K (3840 x 2160 px)4K (3840 x 2160 px)4K (3840 x 2160 px)
Number of frames per video200,000 (2hrs at 30fps)200,000 (2hrs at 30fps)200,000 (2hrs at 30fps)

Active supports analysis (Advanced Metrics and Embeddings) on images and videos up to 4K resolution. Performance is affected for images and videos over 4K.

For optimal performance, we strongly recommend downscaling images and videos over 4K to 4K resolution.

When a Project is too large, the files in the attached Dataset(s) must be resized.


Annotate Projects

LimitEnterpriseTeamFree
Maximum number of ProjectsUnlimitedUnlimited10
Maximum dataset size per Project100 GB100 GB100 GB
Maximum number of labels per Project *5,000,0001,000,0001,000,000
Maximum number of instances per Workflow Project500,000500,0005,000
Maximum number of instances per Manual QA Project5,0005,0005,000
Maximum number of tasks per Workflow Project500,000500,0001,000

* labels = number of instances multiplied the frames they are present in. Labels often accumulate in long videos or large images with many separate objects.

If the number of labels in your Project exceeds our specified limits, consult us.

Manual QA Projects are being deprecated. We strongly recommend moving your Projects to Workflow Projects. We provide an SDK script to convert Manual QA Projects into Workflow Projects. Contact support if you need assistance.


Encord Active Projects

LimitEnterpriseTeamFree
Maximum number of data units500,000500,00025,000
Encord Active supports up to 750K data units per Project, but we recommend 500K data units per Project.

Active supports analysis (Advanced Metrics and Embeddings) on images and videos up to 4K resolution. Performance is affected for images and videos over 4K.

For optimal performance, we strongly recommend downscaling images and videos over 4K to 4K resolution.


Organization

LimitEnterpriseTeamFree
Maximum number of usersUnlimitedUnlimited1
Even if you stay within these limits, we recommend creating a new Project every 6 months and archiving the existing Project

Access control

Projects in Encord currently support the following roles:

  • Annotator: Responsible for completing annotation tasks.
  • Reviewer: Responsible for completing review tasks.
  • Annotator + Reviewer: Able to complete both annotator and reviewer tasks.
  • Team manager: Able to complete both annotator and reviewer tasks and access team management features.
  • Admin: Full access to all Project features. In order to successfully attach Ontologies and Datasets to a given Project, a user must have Admin permissions against each target resource.

Learn more about user based access control from here:

For collaborative teams using our SDK, we recommend creating shared service accounts and creating SSH keys for those shared accounts. For example, to have several people create Ontologies, Datasets, and Projects programmatically, create an email account for use with Encord (for example, encord-admins@mycompany.com) and generate an SSH for that email account.

Screen size

Encord is not supported on small screens such as tablets. The minimum application window resolution must be 800x600px.


Supported data

For detailed information on all supported data and file types, visit our Supported Data page. The following lists highlight recommended file types but are not exhaustive.

Video formats

We support a range of formats and codecs. We recommend using the following video formats:

  • .mp4 file with h.265.
  • .mp4 with vp9.
  • webm

Ensure that videos have a constant frame rate and no audio tracks. The label editor will inform you when we detect audio present in the video files. You can remove audio tracks in videos already in the Encord platform by using the media re-encoding feature in our platform, detailed here.

Other formats and codecs may be supported, but we cannot guarantee compatibility, for more information please see our blog or relevant section in our documentation.

Audio formats

We support a range of formats and codecs. For optimized performance we recommend using the following audio formats:

  • .mp3
  • .mp4
  • .wav
  • .m4a
  • .flac
  • .eac3

Image formats

The platform supports a range of image formats. For most cases we recommend to use:

  • .png
  • .jpeg

For more information please see the relevant section in our documentation.

Resolution of data / media

The resolution of any videos and images should be limited to 4k pixels (4096x2160px) to avoid issues. If you have other requirements, contact us first and we can help evaluate suitability for specific use-cases.


Keyboard shortcuts

Be sure to check out all the keyboard shortcuts available when using the Label Editor, to help speed up your annotations!


We recommend the Google Chrome or Brave web-browsers when using Encord. All exceptions are listed in the following table.

ModalityRecommended browserNotes
VideosChromeIncludes image sequences
ImagesChromeIncludes image groups. Excludes TIFF files.
DICOMFirefoxNo tab memory limit allows large files to load. However, large files can slow down your computer significantly.
Images (TIFF)SafariDue to Chromium-based browser limitations, TIFF files can only be viewed in the Label Editor using the Safari browser. More details can be found here.

This is primarily due to optimizing performance & ensuring data integrity. Modern browsers give no control over deterministically rendering media files (e.g., displaying frames and rendering videos). Further, we also recommend turning off hardware acceleration in Chrome.

Hardware acceleration adds another layer of uncertainty to video rendering in the browser. To eliminate unexpected behavior, we strongly recommend disabling hardware acceleration.

If you have any questions on the above or are experiencing performance issues, contact us at support@encord.com