> For the complete documentation index, see [llms.txt](https://animoia.gitbook.io/animoia-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://animoia.gitbook.io/animoia-docs/guide/project-panel.md).
# Project panel
## Import media
Click Import, double-click empty Project-panel space, right-click empty space and choose **Import Files…**, drag files into the panel, or drop files on the Timeline.
{% hint style="info" %}
**Notes:**
* Numbered stills such as `shot_0001.png` are grouped as one image-sequence video when that choice is offered.
* SVGs retain vector quality. Layered SVGs can be prepared as a composition or imported flat when that choice is offered. For layered compositions from other software, such as [Affinity](https://www.affinity.studio/), SVG is the recommended way to preserve the layers and vector quality when importing into Animoia.
* GIF/WebP animation is converted to a video.
{% endhint %}
Importing is a background task. Its progress appears in the status bar. Project editing is locked during playback, but Project search remains available.
## Search and organize
Search matches names and useful metadata: type, dimensions, duration, frame rate, sequence status, and audio presence. Use **New Folder** to collect assets and compositions. Drag rows into an expanded folder, onto a folder row, or back to root space. Deleting a folder moves its contents to the project root rather than deleting them.
Click a row to select it. `Shift` selects a range and `Ctrl` toggles an item. Drag empty space for a marquee. Click a row's color tag to choose a label color. Hover a composition or asset for a thumbnail and metadata tooltip.
## Project item actions
Right-click an asset for the actions that apply to it:
* **Rename** edits the asset name.
* **Edit** opens Composition Settings.
* **Open Composition** shows that composition.
* **Add to Current Comp** creates a layer; a composition can't be added to itself.
* **Duplicate** copies compositions.
* **Re-import from File…** replaces an asset in place, so every layer using it updates. SVG-derived assets don't offer this action.
{% hint style="info" %}
**Note:** When you re-import one offline asset, Animoia looks at the others that are still missing. If they used to sit in the same folder as the file you just picked, it offers to relink that whole group in one step instead of asking you to hunt down each file individually. This is the fast way back from a project whose media folder was moved or renamed wholesale.
{% endhint %}
* **Sequence Settings…** changes an image sequence's name and fps playback rate. Frame count and dimensions are read-only; duration follows frame rate.
* **Move out of Folder** returns selected rows to root.
* **Delete** removes the selection. The project's last composition can't be deleted.
Double-click a composition to open it, a folder to expand/collapse it, or video/audio to open Footage Preview.
## Footage Preview
Footage Preview plays a composition, image sequence, video, or audio source without changing the active composition. Scrub the bar, use transport controls, or use the shared playback shortcuts. Set In and Out with the work-area commands; the markers themselves aren't draggable. **Clear** restores the full source.
Choose **Add to Composition** to place the trimmed span at the active composition's playhead. The new layer keeps the chosen source offset and may extend beyond the composition end. A trim must remain at least one source frame long.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://animoia.gitbook.io/animoia-docs/guide/project-panel.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
