Images, icons & files

How to upload images, videos and files

September 15, 2026
How to upload images, videos and files

To upload a file in TeleportHQ, open the Assets Manager in the left sidebar, go to Uploads, click + on the Public folder and choose Upload Assets. You can also drag files from your computer anywhere onto the editor. The files appear in the folder, and you can add them to your pages from there.

Before you start

Steps

  1. In the left sidebar, click the folder icon (tooltip Assets Manager).
  2. Click the Uploads tab.

  3. On the Public folder row, click + (tooltip Upload assets or create folders). To upload into one of your own folders, point at that folder and click its +.

    The Public folder in the TeleportHQ Uploads tab, with 1 its + button and 2 the Drop files here area

  4. In the menu, click Upload Assets.

    The + menu of the TeleportHQ Public folder, with Upload Assets highlighted above Generate new asset and Create Folder
  5. Pick one or more files on your computer. For example, bakery-storefront.jpg and menu.pdf.
  6. Wait while the drop area shows Uploading.... The files then appear in the folder.

Other ways to upload:

  • Drag files from your computer anywhere onto the editor. They go into the folder under your mouse pointer, or into Public.
  • Click the Drop files here / or use the + icon area at the top of the Public folder. It opens the same file picker.
  • Copy a picture (for example, a screenshot) and paste it on the canvas with Ctrl+V (Cmd+V on Mac). TeleportHQ shows "Adding the pasted image…", saves it in Public (named pasted-image, for example pasted-image.png) and places it in the selected element, or on the page when nothing is selected.

Check that it worked

Your files are listed in the folder with their size. Point at an image to see a larger preview. To place it on a page, see How to add and replace images or How to add a video from your computer.

TeleportHQ doesn't show a message when an upload works. It only shows a warning when a file is heavy for a web page (see below).

The heavy-file warning

After an upload, TeleportHQ checks each file's weight for a web page. If one file is heavy, a warning names it and says why, for example:

"hero-video.mp4" is 12 MB. Videos are not compressed when published: visitors download the whole file.

If several files are heavy, the warning starts with "3 uploaded files are heavy for a web page:" and lists each file with its size.

The upload still worked: the warning is advice, not an error. A heavy file slows down every page that shows it. To make it lighter, or to see which heavy files a page uses, see How to find files that slow down your page.

Troubleshooting

Dropping a .zip file started an import instead of an upload Dropping a .zip onto the editor imports it as a website. To store a zip file as a download, use + → Upload Assets instead.

"The format of the upload is not supported. Please upload only … files." The file type isn't allowed. Convert it to a supported format, for example .heic to .jpg.

"Upload failed. The extension of your file does not match its content. Please check your file." The file's name ends in one type but the file is another, or a JSON, YAML or CSS file has errors. Save the file again in the right format and upload it.

"Upload failed. We cannot recognize the type of the file you are uploading" TeleportHQ couldn't read what kind of file it is. Open and save it again in a common format, such as .jpg or .mp4.

"Assets upload failed. Asset type file is missing." The file name has no extension. Rename it, for example logo to logo.png.

"Asset name cannot contain * : " ' | < > ? / `" Rename the file on your computer without those characters.

"Cannot upload video files" Video uploads need a trial or paid plan. Click Upgrade now, or use a free Pexels video instead. See How to use free stock photos and videos (Unsplash, Pexels).

"Custom Font file detected" "Custom Font files can only be added from Project Settings." Click Go to Project Settings, or click Cancel and follow How to upload your own fonts.

"Select a single element to paste an image into." You pasted a picture while several elements were selected. Select one element, or none, and paste again.

"The pasted image was added to your assets, but could not be placed here." The selected element can't hold a picture, or you selected something else while it uploaded. The picture is in the Public folder: add it from there.

For size and storage errors, see Which files can I upload, and how big can they be?

Good to know

  • TeleportHQ changes file names to lowercase, replaces ( and ) with [ and ], and adds a number if the name is already used in the folder.
  • If a file's extension doesn't match its content, TeleportHQ corrects the extension where it can, before uploading.
  • There is no "replace file" option for images, videos or documents. Upload the new file and point your elements to it.
  • Pasted pictures go through the same checks as other uploads: your plan's limits, the file-type check and the heavy-file warning.
Share

Related Articles

What is the Assets Manager?

The Assets Manager is the TeleportHQ editor panel (left sidebar, Ctrl/Cmd+4) where you upload, organize and check your project's images, videos, documents, audio and 3D files, and pick free stock photos, videos, 3D models, sounds and icons, in the tabs Uploads, Stock, 3D, Audio and Icons.

Which files can I upload, and how big can they be?

TeleportHQ accepts images (jpg, png, gif, svg, webp, ico), videos (mp4, m4v, mov), documents (pdf, Word, Excel, PowerPoint, zip), audio, .glb 3D models, fonts and text files; trial and Pro plans allow 10 MB per file and 1 GB per project, Premium allows 30 MB per file and 3 GB per project, and smaller files are flagged as heavy when they would slow a page down.

How to organize files in folders

In the TeleportHQ Assets Manager, click + on the Public folder and choose Create Folder to make a folder, then right-click files and choose Move to folder, or drag them into it; right-click a folder to rename, move, download or delete it.

How to find files that slow down your page

In TeleportHQ, open the Assets Manager's Uploads tab; when the page you're editing uses files that are heavy for a web page, a line such as "1 heavy file on this page" shows at the top, and clicking it lists each file with its size, the reason it slows the page and a link to its folder.

How to add and replace images

In TeleportHQ, you add an image with the Image element or by dragging an uploaded file onto the page, replace it by selecting the image and picking another file in the Assets Manager, and crop, adjust, add text, remove the background, edit with AI or resize it with Edit image.

How to add a video from your computer

In TeleportHQ, you upload an MP4, M4V or MOV file to the Assets Manager, drag it onto your page as a Video element, and set its poster, controls, autoplay, loop and sound in the Video section of the right panel.