> ## Documentation Index
> Fetch the complete documentation index at: https://docs.goframe.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Import media
> Bring video, audio and images into a project: supported formats, the 50 GB limit, Cloud Sync, local-only files and relinking
Import puts your own footage, music and pictures into the project's [Media pool](/editor/media-pool), ready to drag onto the Timeline or hand to the agent. Files can stay on your device or sync to the cloud, and GoFrame Editor tells you which is which.
## Ways to import
* Click **Import files** in the Media pool header and pick files from your computer. An empty pool reads "Add your image, video, music, and voiceover collection to compose your project." with **Import** and **Record** buttons.
* Drag files from your desktop onto the Media pool.
* Drag files straight onto the Timeline. They are added to the Media pool and placed on a track in one move.
* Attach files when you create a project from Home with **Attach starter files (script, brief, media)**.
Media you [record](/editor/record) in the browser and media the agent generates land in the same Media pool, marked **Created by AI agent** where relevant.
You can keep editing while files import. Uploads and transcription run in the background; watch them in the **Background tasks** panel described in [Organize the Media pool](/editor/media-pool).
## Supported formats and limits
| Type | Formats |
| ----- | ---------------------------- |
| Video | mp4, mov, qt, avi, mkv, webm |
| Audio | mp3, wav, m4a, aac |
| Image | jpg, jpeg, png, gif, webp |
* Maximum file size is 50 GB. Larger files are refused with **File too large (max 50 GB)**.
* Unsupported files are skipped, and a toast reports how many.
* If GoFrame Editor cannot read a file's metadata, it imports the file with default values and tells you.
* Media is not transcoded on a server. Playback, thumbnails and waveforms are built in your browser, so very large or unusual files may take longer to become scrubbable.
Duplicates are detected by content, not by name. If you import a file that already exists in the project, GoFrame Editor reports **N files are already in the library** and reuses the existing asset instead of adding a copy.
## Local files and Cloud Sync
Every imported asset has a **Cloud Sync** setting. Until a file is synced it lives only in this browser on this computer.
* **Cloud Sync** (in the asset's right-click menu): upload this file so it is available on any device, to collaborators, and to the agent's cloud tools.
* **Auto cloud sync — Upload new files automatically** (in **Library settings**, the ⋯ button in the Media pool header): turn it on to sync every new import without touching each asset.
Cloud storage counts toward your plan's quota (2 GB on Free, 25 GB on Creator, 100 GB on Pro). See [Plans and credits](/editor/plans-and-credits).
### Upload statuses and badges
Each asset reports its upload state as one of:
| Status | Meaning |
| ------------------ | ---------------------------------------------------- |
| **Uploaded** | The file is in the cloud. |
| **Uploading…** | Upload in progress. |
| **Pending upload** | Queued; it will start when earlier uploads finish. |
| **Local only** | Cloud Sync is off for this asset. |
| **Upload error** | The upload failed. Toggle Cloud Sync again to retry. |
Asset cards also carry badges: **Available locally**, **In cloud**, **Pending upload** and **Created by AI agent**.
Local-only files depend on your browser's storage. If a file is too large to keep there, you will see: *"…" is too large for the browser's local storage — it works this session but will need relinking after reload. Use Cloud Sync to keep it.* Turn on Cloud Sync for anything you cannot afford to relink.
## Relink local files
When a project references local files this device cannot read (a different computer, cleared browser data, or a file that moved), the Media pool shows a banner such as **6 local files are unavailable** with a **Relink…** button, and each affected tile carries a **relink** badge ("File missing — relink"). The same **Relink…** action is in the asset's right-click menu. Clips that use those files stay on the Timeline but cannot play until you relink.
Click **Relink…**. The **Relink local files** dialog ("These files are not available on this device. Locate each file, or scan a folder to relink them in bulk.") lists each file with its status, such as **File missing or moved**.
Click **Locate…** next to a file and pick it. A file that only lost its browser permission offers **Reconnect** instead; grant access in the browser prompt.
Click **Relink from folder…** and choose a folder. GoFrame Editor scans it and matches files by content. Folder scanning requires Chrome or Edge; in other browsers use per-file **Locate…**.
If the file you picked has different content from the original, the dialog says so. Pick another file, or choose **Use anyway** to accept it.
Click **Close** when every file is relinked.
GoFrame Editor works best in a Chromium browser such as Chrome or Edge. Saving exports directly to disk and folder-based relinking rely on browser features that other browsers do not provide.
## Continue
* [Organize the Media pool](/editor/media-pool)
* [Record screen, camera and voice](/editor/record)
* [Transcribe media](/editor/transcription)
* [Supported formats and limits](/editor/formats-and-limits)