The tab row
The tab row runs along the top of the main panel. It holds the Preview Agent 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), Share and Present (see Sharing), 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). 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 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 panel on the right. Above them, the Desktop app card offers the desktop app 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.
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 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. 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.
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 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.
- Close, Close other tabs, Close tabs to the right, Close all tabs. Middle-click an unpinned tab to close it.
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 menu. A 3D world opens in a tab as a space you can move around in; 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.