> ## Documentation Index
> Fetch the complete documentation index at: https://docs.preview.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Tabs and files

> How a project is organized: everything is a file, everything opens in a tab, and any two tabs can sit side by side.

A project works like a browser over a file system. Canvases, shotlists, scripts, documents, characters, locations, props, and folders are all files in the project, and each one opens in its own tab. There's no separate mode to switch into: to work on something, open it.

## The tab row

The tab row runs along the top of the main panel. It holds the [Preview Agent](https://docs.preview.io/preview/agent.md) orb if you can edit the project, your open tabs, and **+** to open a new tab. The left sidebar, the agent, and the right sidebar run the full height of the window beside the main panel, with the agent between the left sidebar and the main panel, or between the main panel and the right sidebar after **Move to right** in its **⋯** menu.

A tab shows its file's name. A generated file with no name of its own shows its prompt, or its kind and when it was made (such as **Image · 12:52 PM**); hover the tab for the full date and time.

## The sidebars

The **left sidebar** starts with collaborators' avatars (in the desktop app, also **Back** and **Forward**, to retrace your steps across tabs), then the **project name** (click it to rename the project; the arrow beside it opens the [Project menu](https://docs.preview.io/preview/settings-menu.md)), **Share** and **Present** (see [Sharing](https://docs.preview.io/preview/sharing.md)), then **New**, then **Files** and **History** (each goes to a tab already showing it, else takes the place of the New tab page, else opens in a new tab; **Files** also shows All files in place of a folder you're browsing, but never moves a pinned tab off its folder; as with a Files item, Alt-click or **Open in new tab** in its right-click menu opens a new tab, and a middle click or ⌘/Ctrl-click opens one in the background; History keeps one tab, so these don't open a second one), and **Search** (the [command palette](https://docs.preview.io/preview/command-palette.md)). **New** makes a canvas, shotlist, script, character, location, prop or folder at the top level of All files and opens it by the same rule as **Files**. A canvas, shotlist or script opens on its own page; a character, location, prop or folder opens on its own Files page with its name ready to type. If you go elsewhere or pick **New** again before it opens, it stays in Files instead. People who can't edit the project don't see **New**. Below these rows, **Chats** lists your [Preview Agent](https://docs.preview.io/preview/agent.md) chats in this project. People who can't edit the project don't see **Chats**. At the sidebar's bottom, **Help** opens the Help panel, What's new, support chat, and **Get the desktop app**, and **Analytics** opens the project's [Analytics](https://docs.preview.io/preview/project-analytics.md) panel on the right. Above them, the **Desktop app** card offers the [desktop app](https://docs.preview.io/preview/desktop-app.md) for your system: **Download for Mac** or **Download for Windows**, with the other system's build under **⋯**. Close the card with **×** and it shrinks into a download button after **Analytics**, labelled **Desktop app** for the first week and an icon after that; click it, or Help's **Get the desktop app**, to open the card agai... (line truncated to 2000 chars)

The row for what you're looking at is highlighted: **Files** on a Files page and **History** on the History tab. **Search** isn't highlighted, even while the command palette is open. In Split view, the side you're working in decides.

In **Help**, **Help and docs** returns to the overview, even after you open **Keyboard shortcuts**. Opening Help does not change whether the right sidebar opens on your next visit. **Contact support** appears only when support chat is available and stays disabled while chat loads.

The **right sidebar** holds the **Files** panel, with **Comments** beside it.

* **Close and reopen**: each sidebar's toggle sits at that top corner of the window, and stays there while the sidebar slides away and back; click it to close or reopen the sidebar. **⌘/Ctrl .** toggles the left sidebar and **⌘/Ctrl ⇧ .** the right one.
* **Peek**: with a sidebar closed, rest the pointer on that edge of the window or on its toggle, and the sidebar slides out over the page; click the toggle to keep it open. Turn this off with **Show sidebar on hover** in [Preferences](https://docs.preview.io/preview/settings-menu.md).

## Open something

* **From the Files panel**: double-click anything in the sidebar's **Files** panel to open it (**⌘Enter** or Alt-click opens it in a new tab).
* **From a new tab**: click **+**. While the New tab page is open, **+** becomes its tab and reads **New tab**. The page lets you search your files, create a canvas, shotlist, or script (a character, location, or prop starts in the sidebar's Files panel instead; **Folder** and **Upload** are under the **⋯**; hover a button to see what it creates), or reopen one of your 20 most recent files in this project. A recent file's **⋯** has **Remove from recent**.
* **From History**: **History** in the left sidebar opens the project's whole [history](https://docs.preview.io/preview/history.md) in a tab. A window has one History tab: choosing it again takes you to it.
* **From inside the work**: actions like **Open in new tab** on a timeline sequence or a Files item open their own tabs. (**Play full screen** is the exception: it opens the Player in a separate browser tab.)
* **Drag from Files**: drop items from the Files panel onto the tab row to open each as a tab, or onto the left or right edge of the open document (or the New tab page) to open it in [split view](#split-view). Drag an image or video from History to the same targets. For audio in History, use **Open in new tab** or **Split view** in the file's menu.

**All files** is the permanent first tab (the folder icon): the whole project's file browser, which can't be closed.

## Manage tabs

Right-click a tab for:

* **Pin tab**: keeps it at the front, right after All files (up to five pinned tabs). Pins are saved to your account, so they follow you to other devices; other open tabs last only as long as this browser tab.
* **Split view**, **Open on left**, **Open on right**: see below.
* **Copy link**, **View containing folder** (opens its folder in a new tab), and **Reveal in file tree** (opens the Files panel with the item selected). Every tab of a folder or file in Files has Reveal in file tree, as does every card in a folder's grid; All files, Annotate, History, and unsaved take tabs don't.
* **Show in History**, on canvas tabs: opens the [History](https://docs.preview.io/preview/history.md) tab filtered to what is placed on that canvas. Its link ends in `?canvas=`, so you can share it; if that canvas has been deleted, History shows the whole project and says so. On the tab of an uploaded image or video, or an audio file, it opens History at that file, once History lists it.
* **Move to new window** or **Move to window**, in the desktop app: see [Multiple windows](https://docs.preview.io/preview/desktop-app.md#multiple-windows).
* **Close**, **Close other tabs**, **Close tabs to the right**, **Close all tabs**. Middle-click an unpinned tab to close it.

In the [desktop app](https://docs.preview.io/preview/desktop-app.md), tabs get native shortcuts: ⌘T, ⌘W, ⌘⇧T to reopen a closed tab, and more. Drag a tab out of its window to open it in a new one, or into another window of the project to move it there.

## Split view

Any two tabs can sit side by side: a script beside its canvas, a shotlist beside a reference folder. Right-click a tab and choose **Split view**, **Open on left**, or **Open on right**, or drag a tab or a Files item onto the left or right edge of the open panel. What you drop lands on that side; the other side keeps what the tab showed, and a document it replaces in a split moves to its own tab.

On the tab you're viewing, **Split view** puts the New tab page in the other panel, so you can search for the second document or create one there.

**Split view** in any menu (a Files or History item, a file on the canvas, a sequence, the Player's **More** menu) opens the item beside the open document, usually on the right. When the New tab page or **All files** is showing, there's no document to sit beside: the item opens in a tab of its own with the New tab page beside it, so you can pick its partner, and the tab underneath stays as it was (unless the item is that tab's own document, which then splits that tab). A drop works the same way, on the side you dropped it. A pinned tab's split can't change until you unpin it, and an item that's already in a split takes you to that split instead.

Right-click a split tab (or the divider between the panels) to **Swap panels**, **Show stacked** (top and bottom instead of side by side), **Reset panel size**, close one side (closing the document beside the New tab page closes the tab), or **Separate tabs** to go back to one at a time. Drag the divider to resize; double-click it to even the panels out. When a split opens or closes, a canvas you haven't panned or zoomed since it was fitted (by **Shift+1**, fit in its zoom controls, or opening it for the first time) fits again, so you still see everything. Once you pan or zoom, it keeps the same zoom and keeps what was at its centre in the centre, as every canvas does when the panels swap or stack. Moving the divider, resizing the window, opening, closing or resizing a sidebar or the agent, and moving the agent to the other side move only the canvas's edges: everything on the canvas stays where it is on screen. Press **Shift+1** to fit the canvas to its new size.

Each panel needs about 320 px across (and about 280 px tall when stacked). When there isn't room for both, only the active panel shows; click the other half of the split tab, or choose **Focus left panel** or **Focus right panel** (top or bottom when stacked) from its menu, to switch. Both come back when there's room again. The canvas you can see doesn't fit again either time: everything on it stays where it is on screen.

Both sidebars and the agent resize the same way: drag the edge beside the page, or drag it past its minimum to close the panel. Click the edge to close the panel, or right-click it to **Reset width**. On a touch screen, tapping the edge with a finger does nothing; press and hold it for **Close**, and for **Reset width** once you've changed the width. The left sidebar is 230 to 320 wide. Until you resize the agent, it opens at 45% of the room both sidebars would leave it and the page, from 360 to 680 wide (narrower only when the window is too small for that), so opening or closing a sidebar doesn't move it. **Reset width** brings that back. Once the open tab is as narrow as it goes, widening either sidebar narrows the agent instead, down to its smallest width, and the agent keeps that width afterwards. Widening the agent never narrows a sidebar.

When the window gets too narrow for the open tab beside the sidebars and the agent, the right sidebar (Files) closes first, then the left sidebar, then the agent. The one you just opened stays open. Nothing reopens when the window widens: open it again, or reload in a wider window.

While the agent or a sidebar is open, **Expand page** at the end of the tab row hides them all, and the page fills the window. **Expand** in the agent header's **⋯** menu lets the agent cover the page while the sidebars stay. Both switch at once, without a slide. **Collapse page** or **Collapse agent**, **Esc**, or a sidebar or agent toggle ends Expand, and after Expand page the panels you had open come back as they were; a toggle for a panel that was closed also opens it. A closed sidebar still peeks over the expanded page when you rest the pointer on its edge. Expand isn't remembered: a reload shows your panels unexpanded.

Until a browser has saved a layout, projects open with the left sidebar and the agent (for people who can edit the project) and the right sidebar closed. Which panels are open and their widths are remembered. Reloading a tab brings back that tab's own panels; a new tab or window opens them the way you last left them.

To resize from the keyboard, Tab to a divider or panel edge and use the arrow keys; **Home** and **End** jump to the smallest and largest size.

## The Files panel

The right sidebar's **Files** panel holds the whole project as folders and files. Its **More options** button (beside search at the top of the panel in the tree, on the folder's title row in the grid) switches **Mode** between **File tree**, the default (nested, expandable folders, with **Expand folders** / **Collapse folders**), and **Grid view** (cards, one folder at a time with breadcrumbs). The tree shows at the top level; inside a folder, and in a folder's own tab, it's always the grid.

**Sort**, in the same menu and first in a folder's own tab, sorts by **Name**, **Date modified**, **Date created**, or **Kind**. **Order** is **A to Z** / **Z to A** for Name and Kind and **Newest first** / **Oldest first** for dates; a newly picked field starts at A to Z or Newest first. **Folders on top** is on by default; turn it off to sort folders and files as one list. The tree, the grid, and folder pages share one sort, and it's saved for your account in this browser, across projects.

In a folder's own tab, the row under the header holds **Sort**, **Filter** (**Modified**, **Created**, **Created by**, **Source**) and **All types**, with search at its right end. A filter you set shows on its pill (more than one shows as a count), and **Clear** removes them all. Filters reset when you open another folder.

* **Open**: double-click (in the grid, double-clicking a folder steps into it). **Alt-click** opens in a new tab, middle-click in a background tab, and a row's menu has **Open in new tab** and **Split view**. A PDF has no viewer in Files, so double-clicking or dragging it onto the tab row doesn't open it. To read a PDF, choose **Show in History** from its Files menu, then **View** from its [History](https://docs.preview.io/preview/history.md) menu. A 3D world opens in a tab as a space you can [move around in](https://docs.preview.io/preview/preview-window.md); **View** on a world in History opens the same space in a dialog.
* **Folder cards**: in the grid and in All files, a folder's card shows its first files and what it holds, such as "2 folders" or "7 files" (or "Empty"). Hover a folder in the file tree to preview its contents.
* **Create** from the **+** at the top of Files (on the folder's title row in the grid), the **+** on a folder row in the tree, or by right-clicking: Canvas, Shotlist, Script, Character, Location, Prop, Document, Folder, or Upload. People who can't edit the project don't see these.
* **Move** by dragging between folders, onto a breadcrumb, or onto Back, or with **Move to** in an item's menu. Hold a drag over a folder and it springs open. Drag files from your desktop onto a plain folder to upload them there. Uploads also have **Add to folder**, which files the same upload in a second folder without moving it.
* **Select several**: drag across empty space in the grid to box-select (Shift or ⌘ adds to it), or ⌘A for everything.
* **Keyboard**: **F2** renames, **/** or **⌘F** searches, **⌘↑** goes to the enclosing folder, **⌘D** duplicates, **⌫** deletes, and **⌘Z** undoes a create, rename, move, delete, or duplicate (the last 50, for this session).
* **Open folders** in the tree stay open after a reload. In the desktop app each window keeps its own after you quit and relaunch; a new window or browser tab opens the folders you opened or closed last, except that a tab opened from another tab can start with that tab's folders.

Characters, locations, and props are folders too, holding their variations, descriptions, and voices: see [Project Library](https://docs.preview.io/preview/project-library.md).

Switch the right sidebar from **Files** to **Comments** to review discussion. For images, videos, audio files, PDFs, and 3D worlds from across the project, open **[History](https://docs.preview.io/preview/history.md)** from the left sidebar.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.