Which files can I upload, and how big can they be?
TeleportHQ accepts images, videos, documents, audio, 3D models, fonts and text files in the Assets Manager. On a trial or Pro plan, each file can be up to 10 MB and each project can store 1 GB. On Premium, each file can be up to 30 MB and each project can store 3 GB. Uploading videos and 3D models needs a trial or paid plan.
Supported file types
| Type | Extensions | Notes |
|---|---|---|
| Images | gif, jpg, jpeg, png, svg, webp, ico | |
| Videos | mp4, m4v, mov | Trial or paid plan needed |
| Documents | pdf, doc, docx, xls, xlsx, ppt, pptx, zip | Can't be placed on the canvas; link to them |
| Audio | mp3, wav, ogg, m4a, aac, flac | |
| 3D models | glb | Trial or paid plan needed |
| Fonts | otf, ttf, woff, woff2 | Upload in Project settings → Appearance → Fonts |
| Text files | yml, yaml, txt, xml, json, js, css, env | Can be edited in the editor |
Other formats, such as .heic, .avi, .psd or .gltf, aren't supported. Convert them first, for example .heic to .jpg.
TeleportHQ checks each file's content. A file whose name says one type but whose content is another is rejected or corrected, and json, yaml and css files must be valid.
Storage and size limits per plan
These TeleportHQ limits apply per project:
| Plan | Storage per project | Largest file | Number of files |
|---|---|---|---|
| Trial and Pro (also older and special plans) | 1 GB | 10 MB | 2,000 |
| Premium | 3 GB | 30 MB | 6,000 |
| Free (older accounts only) | 5 MB | 2 MB | 200 |
| Expired plan | No uploads |
For current plans and prices, see teleporthq.io/pricing and What's the difference between Trial, Pro and Premium?.
Special cases:
- 3D models (.glb) you upload can be up to 30 MB on any trial or paid plan.
- Stock 3D models from the 3D tab can be up to 200 MB, as long as they fit in your project's storage.
- Stock photos, videos, sprites and sounds are linked from the provider and don't use storage.
- AI-generated images are saved in your project and count toward storage.
To see how big each file is, open Uploads: the size shows under each file's name. Sort files by: size at the bottom of the tab puts the largest first.
Heavy files: a warning, not a limit
A file can fit your plan's limit and still be heavy for a web page: every visitor downloads it. TeleportHQ flags these files after you upload them, shows their size in orange (heavy) or red (very heavy) in Uploads, and lists the ones the open page uses at the top of Uploads. The upload still works.
| File | Heavy from | Very heavy from |
|---|---|---|
| Image that TeleportHQ resizes when you publish | 5 MB | 15 MB |
| Image published as-is (an SVG, or a picture with Disable Optimisations on) | 300 KB | 1 MB |
| Video | 5 MB | 20 MB |
| Audio | 3 MB | 10 MB |
| Font file | 150 KB | 500 KB |
| 3D model | 25 MB | 100 MB |
Documents and text files are never flagged. To find and fix heavy files, see How to find files that slow down your page.
What the limit messages mean
"Upload failed. The maximum file size is 10MB" The file is bigger than your plan allows. Make it smaller (for example, compress a photo or shorten a video) and upload it again. On Premium, the message still says 10MB, but the real limit is 30 MB.
"Upgrade your workspace to a paid plan" with "The maximum file size is 2 MB on Free plan" This window only shows on an older Free workspace, when a file is bigger than 2 MB. Make the file smaller, or click Upgrade Now. Trial and paid workspaces see the "Upload failed" message above instead.
"The maximum assets size has been reached for this project: 1.024GB" (3.072GB on Premium) The project's storage (1 GB, or 3 GB on Premium) is full. Delete files you don't use, then try again. See How to rename or delete files (and remove unused ones).
"You reached the maximum size of upload files. Please remove any unused asset before uploading a new one." Either the project's storage is full or it has reached the maximum number of files. Delete unused files, then try again.
"Could not create asset(s). The maximum number of assets has been reached for this project: 2000" The project has the maximum number of files for your plan. Delete files you don't use.
"Upload limit exceeded" This window only shows on workspaces that aren't on a trial or paid plan, when the upload would go over the project's storage. It mentions "Free accounts". Delete unused files, or click Upgrade now.
"Cannot upload video files" Video uploads need a trial or paid plan. Click Upgrade now, or use a free video from Pexels in the Stock tab. See How to use free stock photos and videos (Unsplash, Pexels).
An upgrade window with no title when you upload a .glb file Uploading your own .glb file needs a trial or paid plan, and on a workspace without one the upgrade window shows no title. You can still add free models from the 3D tab.
"Assets upload failed. The free space limit was reached." The project's storage is full. Delete unused files.
"Assets upload failed due to server connection. Please refresh or try again with fewer files." Refresh the editor and upload fewer files at a time.