> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://documentation.celestory.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# The files Celestory accepts, and how to organize them

# 📁 The files Celestory accepts, and how to organize them

Every project has its own media library, opened from the **Files** menu (`Cmd/Ctrl + Shift + E`). Everything your blocks display or play comes from there.

## 🖼️ Images

| Format | Extension | Good to know |
| --- | --- | --- |
| PNG | `.png` | Transparency preserved. |
| JPEG | `.jpg`, `.jpeg` | Lightweight, for photos. |
| WEBP | `.webp` | Good size / quality trade-off. |
| GIF | `.gif` | Animated, played as is. |
| SVG | `.svg` | Vector, crisp at any size. |
| ICO / ICNS | `.ico`, `.icns` | Application icons. |

## 🔊 Sounds

| Format | Extension | Good to know |
| --- | --- | --- |
| MP3 | `.mp3` | The safest format. |
| WAV | `.wav` | Uncompressed, so heavy. |
| OGG | `.ogg` | Compressed, good quality. |
| WEBM | `.webm` | Audio track only. |

You can also record from the microphone: the sound arrives as MP3.

## 🎬 Videos

| Format | Extension | Good to know |
| --- | --- | --- |
| MP4 | `.mp4` | The default choice. |
| WEBM | `.webm` | Lightweight alternative. |
| MOV | `.mov` | QuickTime format. |
| MPEG | `.mpeg`, `.mpg` | Legacy format. |

## 📄 Documents and data

| Format | Extension | Good to know |
| --- | --- | --- |
| Text | `.txt` | Readable in the preview. |
| Markdown | `.md` | Ideal for long texts. |
| HTML | `.html` | Displayed in the preview. |
| PDF | `.pdf` | Browsable in the preview. |
| JSON | `.json` | For your game data. |

🔺 A JSON shows up under **Type** as "Unknown file", with no preview. That is normal: it is properly stored and usable.

## 🔤 Fonts

| Format | Extension | Good to know |
| --- | --- | --- |
| OTF | `.otf` | Preview in four sizes. |
| TTF | `.ttf` | Same. |

## 🦴 2D animation with Spine

A Spine animation requires **three files**, uploaded separately then picked one by one in the Spine resource: the texture as **PNG**, the skeleton as **JSON**, the atlas as **`.atlas`**.

🔺 Keep the `.atlas` extension as it is. Celestory recognizes files by their extension: renamed to `.txt`, your atlas becomes a text file and disappears from the atlas picker. In the list, an `.atlas` is displayed as "Unknown file": that is expected.

## ⬆️ Adding files

The **+** button, at the bottom of the left-hand column, opens four entries: **Add file(s)** (multiple selection), **Add folder**, **Record audio** and **AI Generation**.

🔺 You cannot drop a file from your desktop: drag and drop only serves to tidy up the files already there. Use the **+** button. On a narrow window, the left-hand column is hidden and the **+** button with it: widen the window.

## 🗂️ Organizing your media library

- **Folders, not tags.** Celestory offers neither tags nor labels: your organization relies on folders and on clear names.
- **Moving**: drag your files onto a folder, or onto the back arrow to go up one level.
- **Searching**: the search field sweeps the whole project, not just the open folder.
- **Sorting**: click the Name, Date, Size or Type headers.

## 📊 Available space

A gauge at the bottom of the list reads "X of Y used". This quota is specific to the project and depends on your plan. An upload that would exceed it is rejected, and nothing is kept.

🔺 A single file cannot exceed about 2 GB.

## 🔁 Replacing a file without breaking your links

Select **a single** file, open the **⋯** menu then **Reimport**. The file keeps its identity, its name and its location: the blocks using it keep pointing at it, with no reconnection. Only the content, the size and the date change.

The selection window will only offer files in the same format as the original. To change format, upload a new file and rewire your blocks.

→ Next step: connect these files to your blocks with **Content Management**.