# Organizing files: questions and answers

Short answers about keeping files in order and finding them again:
folders, moving and renaming, favorites, search, filters, sorting, the
grid and the list, the Details pane and a file's details, and what happens
when two people change the same thing. Each answer links to the section of
[Folders, moving and finding](../files/organizing.md) that owns the rule.

## Getting around Files & Assets

### How do I open Files & Assets?

Choose "Files & Assets" in the sidebar. It opens the files of the
workspace you are in. The keys G then F go there from anywhere in a
workspace, and the command palette offers "Go to Files & Assets".

More: [Files & Assets overview, Opening Files & Assets](../files/overview.md#opening-files--assets)

### What does "All files" open?

The top level of the open workspace or organization folder.

More: [Folders, moving and finding, Getting around](../files/organizing.md#getting-around)

### What is the "Folders" tree beside the file listing?

A tree of everything you can browse. Its root is the organization, which is
the folder shared across the organization and opens it. Below it come your
workspaces of that organization as workspace folders, each with its folders,
then the organization folder's own folders.

More: [Folders, moving and finding, Getting around](../files/organizing.md#getting-around)

### How do I switch to another workspace's files?

Click the workspace in the "Folders" tree, or use the workspace switcher
at the top of the sidebar.

More: [Folders, moving and finding, Getting around](../files/organizing.md#getting-around)

### How do I open a folder from the folder tree?

Click its name. Clicking the arrow beside it only opens or closes the
folder in the tree.

More: [Folders, moving and finding, Getting around](../files/organizing.md#getting-around)

### Can I use the keyboard in the folder tree?

Yes. The arrow keys move through the tree. Right and Left open and close a
folder. Enter or Space opens it in the listing.

More: [Folders, moving and finding, Getting around](../files/organizing.md#getting-around)

### What does the number beside a folder in the tree mean?

The number of files directly in that folder. Files in its subfolders are
not counted.

More: [Folders, moving and finding, Getting around](../files/organizing.md#getting-around)

### What is the "Folder path" above the listing?

The breadcrumb. It shows where you are: "Files & Assets", then the
workspace's name, or the organization's name and "Organization folder", then the
folders down to the one you have open.

More: [Folders, moving and finding, Getting around](../files/organizing.md#getting-around)

### What is the "..." in the breadcrumb?

A menu that holds the folders in between. When more than one folder lies
between the start and the open folder, the older ones fold into it.

More: [Folders, moving and finding, Getting around](../files/organizing.md#getting-around)

### What happens when I click the last crumb of the breadcrumb?

It opens the folder's menu. The last crumb is the open folder, as a button
"Folder actions for {name}".

More: [Folders, moving and finding, Getting around](../files/organizing.md#getting-around)

### Where did the navigation go on my small window?

On a narrow window the navigation becomes a row. Its "Folders" button
opens the favorites and the tree in a panel that closes when you open a
folder.

More: [Folders, moving and finding, Getting around](../files/organizing.md#getting-around)

### I bookmarked a folder and it has been moved since. Does my bookmark still work?

Yes. A folder's address holds the folders above it. When the folder, or
one above it, was moved since, the app finds the folder where it is now,
opens it and corrects the address.

More: [Folders, moving and finding, Getting around](../files/organizing.md#getting-around)

### What does "This folder was deleted." mean?

The folder in the address is in the trash or was deleted. The app offers
the link "Go to the top level". If it is still in the trash, it can be
restored from there.

More: [Folders, moving and finding, Getting around](../files/organizing.md#getting-around)

### Can I keep a folder open in one tab and a file in another?

Yes. The app has its own tabs above the work area. "New tab" (Alt+T) opens
another, and each tab is named after its page.

More: [Files & Assets overview, Tabs](../files/overview.md#tabs)

### Can I share the address of a folder with a teammate?

Yes. The view, the sort, the filters and the search are part of the page's
address, so a copied address opens the same view for someone who can open
that workspace or organization folder.

More: [Folders, moving and finding, Grid and list](../files/organizing.md#grid-and-list)

## Folders

### What is a folder in Talewright?

A place that holds files and other folders. Each workspace has one tree of
folders, and the organization folder has its own.

More: [Folders, moving and finding, Folders](../files/organizing.md#folders)

### Can a file be in two folders at once?

No. A file sits in exactly one folder, or at the top level, which is no
folder at all.

More: [Folders, moving and finding, Folders](../files/organizing.md#folders)

### Can I make a shortcut or alias to a file in another folder?

No. A file sits in exactly one place. To reach it quickly from anywhere,
add it to your favorites.

More: [Folders, moving and finding, Favorites](../files/organizing.md#favorites)

### Does a file have to be in a folder?

No. A file can sit at the top level of its workspace or of the organization
folder.

More: [Folders, moving and finding, Folders](../files/organizing.md#folders)

### Can a folder be empty?

Yes. An empty folder is allowed and stays until someone moves it to the
trash.

More: [Folders, moving and finding, Folders](../files/organizing.md#folders)

### Are empty folders removed automatically?

No. An empty folder stays until someone moves it to the trash.

More: [Folders, moving and finding, Folders](../files/organizing.md#folders)

### Can a folder belong to two workspaces?

No. A folder belongs to exactly one workspace or to the organization folder,
and it cannot be moved to another.

More: [Folders, moving and finding, Folders](../files/organizing.md#folders)

### Do the file counts of a folder include its subfolders?

No. `folderCount` and `fileCount` count the folders and the live files
directly inside the folder. Files in subfolders are not counted.

More: [Folders, moving and finding, Folders](../files/organizing.md#folders)

### Are trashed files counted in a folder's file count?

No. A folder counts its live files only.

More: [Folders, moving and finding, Folders](../files/organizing.md#folders)

### In which order are folders listed?

By name. Folders always come before files, whatever the sort.

More: [Folders, moving and finding, Sorting](../files/organizing.md#sorting)

### Can I give a folder a color, an icon or a description?

No. A folder has a name, a place and a general access. It has no color,
icon or description of its own.

More: [Folders, moving and finding, Requests and answers](../files/organizing.md#requests-and-answers)

### Do workspaces and the organization folder use the same folders?

No. Every workspace has its own folders, and so does the organization
folder.

More: [Folders, moving and finding, Summary](../files/organizing.md#summary)

## Creating folders

### How do I create a folder?

Choose "New folder": the button at the top, the icon beside "Folders", a
right-click on empty space, or the command palette. Enter a "Name" in the
dialog "New folder" and choose "Create folder".

More: [Folders, moving and finding, Creating a folder](../files/organizing.md#creating-a-folder-1)

### Where is a new folder created?

In the folder you have open, or at the top level when no folder is open.
The app says "Created folder {name}".

More: [Folders, moving and finding, Creating a folder](../files/organizing.md#creating-a-folder-1)

### Who can create a folder in a workspace?

Every member of the workspace.

More: [Folders, moving and finding, Who can do what](../files/organizing.md#who-can-do-what)

### Which roles can create folders in the organization folder?

Owners and admins of the organization. Other members read the organization
folder and see no "New folder" there.

More: [Folders, moving and finding, Who can do what](../files/organizing.md#who-can-do-what)

### How do I create a subfolder?

Open the folder it should go into, then choose "New folder". The new
folder is created in the folder you have open.

More: [Folders, moving and finding, Creating a folder](../files/organizing.md#creating-a-folder-1)

### Is a new folder public or restricted?

Restricted. A new folder is empty and restricted.

More: [Folders, moving and finding, Creating a folder](../files/organizing.md#creating-a-folder)

### Why does the "New folder" dialog say "Enter a name of 1 to 200 characters without a slash."?

The name is blank, too long or holds a `/`. A folder name is 1 to 200
characters long and must not contain `/` or a control character.

More: [Folders, moving and finding, Creating a folder](../files/organizing.md#creating-a-folder-1)

### Why can't I create a folder with a name that already exists?

A folder name is unique among the folders in the same place, ignoring
case. The dialog shows `A folder named "{name}" already exists here.
Choose another name.`

More: [Folders, moving and finding, Folder names](../files/organizing.md#folder-names)

### Why can't I create a folder inside this folder?

You are at the depth limit. Folders nest at most 16 levels deep, and the
dialog shows "Folders nest at most 16 levels deep."

More: [Folders, moving and finding, How deep folders nest](../files/organizing.md#how-deep-folders-nest)

### Can I create several folders at once?

Not with "New folder", which makes one folder. Uploading a folder from
your computer recreates its whole structure of subfolders.

More: [Uploading, Uploading a folder](../files/uploading.md#uploading-a-folder)

### Can I create a folder from a template or copy a folder structure?

No. Folders are created one by one, or recreated from a folder you upload.

More: [Folders, moving and finding, Creating a folder](../files/organizing.md#creating-a-folder-1)

### Can an agent create folders through the API?

Yes, with a credential that holds `files:write`: `POST W/folders` with a
`name` and, to nest it, a `parentID`. Left out, the folder goes to the top
level.

More: [Folders, moving and finding, Creating a folder](../files/organizing.md#creating-a-folder)

### What happens when an API call creates a folder under a parent that is in the trash?

It answers `422 VALIDATION_FAILED` on `parentID`. The parent must be a
live folder of the same workspace or organization folder.

More: [Folders, moving and finding, Creating a folder](../files/organizing.md#creating-a-folder)

### Is creating a folder safe to retry through the API?

Yes, with a `requestID`. Repeating the same request within 24 hours returns
the folder the first request made. A workspace and the organization folder
keep their request IDs apart.

More: [Folders, moving and finding, Creating a folder](../files/organizing.md#creating-a-folder)

## Folder names

### Which characters are not allowed in a folder name?

`/` and control characters, such as a tab or a line break.

More: [Folders, moving and finding, Folder names](../files/organizing.md#folder-names)

### Can two folders have the same name in different places?

Yes. A folder name is unique only among the folders in the same place.

More: [Folders, moving and finding, Folder names](../files/organizing.md#folder-names)

### Can "Brand" and "brand" both exist in one folder?

No. Sibling names are compared ignoring case. The second answers `409
CONFLICT` with reason `NAME_TAKEN` and the message "That name is already
taken here".

More: [Folders, moving and finding, Folder names](../files/organizing.md#folder-names)

### Are spaces at the start or end of a folder name kept?

No. Spaces at the start and end are removed before the name is measured
and stored.

More: [Folders, moving and finding, Folder names](../files/organizing.md#folder-names)

### Can a folder and a file in the same place have the same name?

Yes. Folder names are unique only among folders, and file names need not
be unique at all.

More: [Folders, moving and finding, Folder names](../files/organizing.md#folder-names)

### Can a folder name contain an emoji or accented letters?

Yes. Any character is allowed except `/` and control characters.

More: [Folders, moving and finding, Folder names](../files/organizing.md#folder-names)

### What does "That name is already taken here" mean?

A live folder in the same place already has that name, ignoring case. The
answer is `409 CONFLICT` with `details.reason` `NAME_TAKEN`. Choose
another name.

More: [Folders, moving and finding, Folder names](../files/organizing.md#folder-names)

## Renaming folders

### How do I rename a folder?

Choose "Rename" in the folder's menu. The dialog "Rename folder" has the
field "Name", filled in, and the button "Rename". An open folder can also
be renamed in the Details pane, in the form "Folder name".

More: [Folders, moving and finding, Renaming](../files/organizing.md#renaming)

### Does renaming a folder change anything else about it?

No. A rename changes the name and nothing else: the folder's ID, its
content, its place and its general access stay.

More: [Folders, moving and finding, Renaming a folder](../files/organizing.md#renaming-a-folder)

### Does renaming a public folder break its gallery link?

No. A public folder's gallery link keeps working after a rename.

More: [Folders, moving and finding, Renaming a folder](../files/organizing.md#renaming-a-folder)

### Can I rename a folder that is in the trash?

No. A trashed folder cannot be renamed: `409 CONFLICT`, reason `IN_TRASH`.
Restore it first.

More: [Folders, moving and finding, Renaming a folder](../files/organizing.md#renaming-a-folder)

### Who can rename a folder?

Every member of the workspace. In the organization folder, owners and admins
of the organization.

More: [Folders, moving and finding, Who can do what](../files/organizing.md#who-can-do-what)

### Can I rename and move a folder in one step through the API?

Yes. A rename and a move can be sent together in one request: `name` and
`parentID` in the same `PATCH`.

More: [Folders, moving and finding, Moving a folder](../files/organizing.md#moving-a-folder)

### Do the files inside a folder change when I rename the folder?

No. The rename changes the folder's name and nothing else.

More: [Folders, moving and finding, Renaming a folder](../files/organizing.md#renaming-a-folder)

## Renaming files

### How do I rename a file?

Choose "Rename" in the file's menu, or press R with one item selected. The
dialog "Rename file" has "Name" and "Rename". A file can also be renamed
on its page, in the section "Details".

More: [Folders, moving and finding, Renaming](../files/organizing.md#renaming)

### Does renaming a file break links to it?

No. A rename keeps the file's ID, its versions and its links. A public
link keeps working under the new name, and old addresses with the old name
in them keep working too.

More: [Folders, moving and finding, File names](../files/organizing.md#file-names)

### Can I change a file's extension by renaming it?

Yes, the name includes the extension and renaming can change it. That does
not change the file's type: the type comes from the bytes of the current
version.

More: [Folders, moving and finding, File names](../files/organizing.md#file-names)

### Does renaming `logo.png` to `logo.jpg` convert the image?

No. The name changes and the file is still a PNG.

More: [Folders, moving and finding, Edge cases](../files/organizing.md#edge-cases)

### Can two files in the same folder have the same name?

Yes. File names need not be unique.

More: [Folders, moving and finding, File names](../files/organizing.md#file-names)

### Why does renaming a file show "Enter a name of 1 to 200 characters."?

The name is blank, too long or holds `/` or `\`. A file name is 1 to 200
characters long after spaces at the start and end are removed.

More: [Folders, moving and finding, Renaming](../files/organizing.md#renaming)

### Can a file name contain a slash or a backslash?

No. A name must not contain `/` or `\`. A file goes into a folder by its
`folderID`, never by its name. Any other character is allowed, except
control characters.

More: [Folders, moving and finding, File names](../files/organizing.md#file-names)

### Can I rename several files at once?

No. "Rename" works on one item: the R key applies when one item is
selected or a file is open. Rename the files one by one.

More: [Folders, moving and finding, Keyboard shortcuts](../files/organizing.md#keyboard-shortcuts)

### An old file has a slash in its name. Can I still edit its details?

Yes. Only a name being set is checked. A file whose name holds `/` or `\`
keeps it, and everything else about the file can still be changed. A
request that sends that name again as `name` is refused.

More: [Folders, moving and finding, File names](../files/organizing.md#file-names)

### Who can rename a file?

Every member of the workspace. In the organization folder, owners and admins
of the organization.

More: [Folders, moving and finding, Who can do what](../files/organizing.md#who-can-do-what)

### Does renaming a file create a new version?

No. A rename keeps the file's versions. Only replacing a file adds a
version.

More: [Folders, moving and finding, File names](../files/organizing.md#file-names)

## Moving files

### How do I move a file to another folder?

There are four ways. Choose "Move" in the file's menu or press M and pick
the folder in the Move dialog. Drag the file onto a folder. Choose "Move
to parent folder" in its menu. Or use "Move" under "Location" in the
Details pane.

More: [Folders, moving and finding, Moving](../files/organizing.md#moving)

### How does the Move dialog work?

The dialog "Move {name}" says "Open the folder to move to, then choose Move
here." It shows the folders of the same workspace or organization folder.
Click a folder to open it, "Parent folder" goes back up, and "Move here"
moves the items into the folder you have open in the dialog.

More: [Folders, moving and finding, Moving](../files/organizing.md#moving)

### Why is "Move here" disabled in the Move dialog?

The folder you have open in the dialog is where the items already are.
Open another folder.

More: [Folders, moving and finding, Moving](../files/organizing.md#moving)

### What does "No subfolders here." mean in the Move dialog?

The folder you opened in the dialog holds no folders. You can still choose
"Move here" to move the items into it.

More: [Folders, moving and finding, Moving](../files/organizing.md#moving)

### Can I drag and drop files between folders?

Yes. Drag a row onto a folder's row, onto a folder in the tree, or onto a
crumb of the breadcrumb. Dragging a selected row drags the whole
selection, with the number of items shown beside the pointer.

More: [Folders, moving and finding, Moving](../files/organizing.md#moving)

### How do I move a file out of a folder to the top level?

Drag it onto its workspace, or onto "Organization folder", in the folder
tree, or go up with "Parent folder" in the Move dialog until you are at the
top level and choose "Move here". For a file one level down, "Move to parent
folder" does the same.

More: [Folders, moving and finding, Moving](../files/organizing.md#moving)

### What does "Move to parent folder" do?

It moves the item one level up. The item is shown to whoever may change
it, when it is inside a folder.

More: [Folders, moving and finding, Moving](../files/organizing.md#moving)

### How do I move several files at once?

Select them and choose "Move" in the selection bar, press M, or drag one
of the selected rows. The dialog is then titled "Move 3 files", for
example.

More: [Folders, moving and finding, Moving](../files/organizing.md#moving)

### Can I undo a move in the app?

Yes. After a move the app says "Moved {name} to {destination}" with
"Undo". Cmd+Z or Ctrl+Z does the same. Undo puts each item back where it
was, and the app says "Moved {name} back".

More: [Folders, moving and finding, Moving](../files/organizing.md#moving)

### The Undo for my move is gone. How do I put the file back?

Move it back yourself. "Undo" is offered for 8 seconds after the move.
After that, use "Move" or drag the file to where it was.

More: [Folders, moving and finding, Moving](../files/organizing.md#moving)

### Undo of my move says some items could not move back. What do I do?

Move those items yourself. "Some items could not move back. Move them by
hand." means that Undo could not put every item back where it was.

More: [Folders, moving and finding, Moving](../files/organizing.md#moving)

### What happens when I move several items and some of them fail?

The ones that moved stay moved, and the app says what went wrong with the
first that did not.

More: [Folders, moving and finding, Moving](../files/organizing.md#moving)

### Can I move a file from a workspace into the organization folder?

No. There is no way to move items to another workspace or between a
workspace and the organization folder. An owner or admin uploads the file to the
organization folder instead.

More: [Folders, moving and finding, Moving](../files/organizing.md#moving)

### Can I move a file from the organization folder into a workspace?

No. A file moves only within its own workspace or within the organization
folder. To have it in a workspace too, download it and upload it there.

More: [Folders, moving and finding, Moving a file](../files/organizing.md#moving-a-file)

### How do I get a file into another workspace when it cannot be moved?

Download it and upload it there. The copy is a new file: it starts with
version 1 and without the first file's details.

More: [Folders, moving and finding, Moving a file](../files/organizing.md#moving-a-file)

### Can I copy or duplicate a file?

No. There is no copy action. To get a second file with the same content,
download the file and upload it again.

More: [Folders, moving and finding, The menu of a file or folder](../files/organizing.md#the-menu-of-a-file-or-folder)

### What stays the same when I move a file?

Everything except its folder: the file's ID, name, versions, status,
details, tags and its own general access.

More: [Folders, moving and finding, Moving a file](../files/organizing.md#moving-a-file)

### Does moving a file break its links?

No. The file keeps its ID, and a file that is public by its own general
access keeps its link wherever it goes. Only a public link that a public
folder gave the file stops when the file leaves that folder.

More: [Folders, moving and finding, Moves that change who can open files](../files/organizing.md#moves-that-change-who-can-open-files)

### Can a move fail because a file of that name is already in the folder?

No. File names need not be unique, so a move never fails because of a
name. Both files stay.

More: [Folders, moving and finding, Moving a file](../files/organizing.md#moving-a-file)

### Does moving a file overwrite a file with the same name in the destination?

No. Nothing is overwritten. Two files with the same name end up in one
folder.

More: [Folders, moving and finding, Edge cases](../files/organizing.md#edge-cases)

### Can I move a file that is in the trash?

No. A trashed file cannot be moved: `409 CONFLICT`, reason `IN_TRASH`.
Restore it first.

More: [Folders, moving and finding, Moving a file](../files/organizing.md#moving-a-file)

### Can I move a file into a folder that is in the trash?

No. The destination must be a live folder. Through the API that answers
`422 VALIDATION_FAILED` on `folderID`.

More: [Folders, moving and finding, Moving a file](../files/organizing.md#moving-a-file)

### What does "The destination folder no longer exists." mean?

The folder you chose was trashed or deleted while you were moving. Nothing
moved. Choose another folder.

More: [Folders, moving and finding, Moving](../files/organizing.md#moving)

### What does "This file no longer exists." mean when I move a file?

The file is gone, so nothing can be moved. A file that is only in the
trash reads "This file is in the trash." instead.

More: [Folders, moving and finding, Moving](../files/organizing.md#moving)

### Why can't I move files in the organization folder?

Only organization owners and admins change the organization folder. The app says
"Only organization owners and admins can change the organization folder."

More: [Folders, moving and finding, Moving](../files/organizing.md#moving)

### What happens when a file is moved into a folder at the very moment that folder is trashed?

Either the move lands first and the file goes to the trash with the
folder, or the trash lands first and the move is refused. A file is never
left live inside a trashed folder.

More: [Folders, moving and finding, Edge cases](../files/organizing.md#edge-cases)

### Does moving a file count as an update to it?

Yes. A file's "updated" time moves when its details or place change, so a
moved file goes to the top of a listing sorted by "Recently updated".

More: [Folders, moving and finding, Sorting](../files/organizing.md#sorting)

### I moved a file to the wrong folder. How do I fix it?

Choose "Undo" right after the move, or press Cmd+Z or Ctrl+Z. Later, move
the file again to where it belongs.

More: [Folders, moving and finding, Moving](../files/organizing.md#moving)

## Moving folders

### How do I move a folder?

The same ways as a file: "Move" in its menu, drag and drop, "Move to
parent folder", or "Move" under "Location" in the Details pane.

More: [Folders, moving and finding, Moving](../files/organizing.md#moving)

### What happens to the files and subfolders when I move a folder?

They move with it. A folder moves with everything inside it.

More: [Folders, moving and finding, Moving a folder](../files/organizing.md#moving-a-folder)

### Can I move a folder into one of its own subfolders?

No. A folder cannot be moved into itself or into a folder below it. The
app says "A folder cannot move into itself or one of its subfolders."

More: [Folders, moving and finding, Moving a folder](../files/organizing.md#moving-a-folder)

### Why is a folder greyed out as "(being moved)" in the Move dialog?

It is one of the folders you are moving. A folder cannot be moved into
itself, so it is disabled as a destination.

More: [Folders, moving and finding, Moving](../files/organizing.md#moving)

### Why can't I move my folder into a folder where one of the same name exists?

A folder name is unique among the folders in the same place, ignoring
case. Rename one of the two first.

More: [Folders, moving and finding, Edge cases](../files/organizing.md#edge-cases)

### Why can't I move my folder into a deeply nested folder?

The whole moved tree must fit within 16 levels. A folder with three levels
below it cannot be moved into a folder at level 14. Nothing moves.

More: [Folders, moving and finding, How deep folders nest](../files/organizing.md#how-deep-folders-nest)

### Can I move a folder to another workspace?

No. A folder moves only within its own workspace or organization folder.

More: [Folders, moving and finding, Moving a folder](../files/organizing.md#moving-a-folder)

### Can I merge two folders by moving one onto the other?

No. Moving a folder onto another puts it inside that folder. To merge
them, move the files of one into the other and trash the empty folder.

More: [Folders, moving and finding, Moving a folder](../files/organizing.md#moving-a-folder)

### What does `CYCLE` mean when a folder move is refused?

The folder would move into itself or into a folder below it. The answer is
`409 CONFLICT` with reason `CYCLE` and the message "A folder cannot move
into itself or its subfolders". Choose another destination.

More: [Folders, moving and finding, Moving a folder](../files/organizing.md#moving-a-folder)

### What happens when two people move two folders into each other at the same time?

One move succeeds. The other gets `409 CONFLICT` with reason `CYCLE`. Two
moves at the same moment can never build a loop together.

More: [Folders, moving and finding, Edge cases](../files/organizing.md#edge-cases)

### How do I move a folder to the top level through the API?

Send `parentID: null` with the folder's current `expectedLockVersion`.

More: [Folders, moving and finding, Moving a folder](../files/organizing.md#moving-a-folder)

### Can I drop a folder onto a workspace in the tree to move it?

Yes, within the same workspace or organization folder. Dropping onto a
workspace or "Organization folder" in the tree moves to that top level. The
organization at the tree's root takes no drops.

More: [Folders, moving and finding, Moving](../files/organizing.md#moving)

### Can I drag a file onto another workspace in the tree to move it there?

No. Dropping onto a workspace in the tree moves to that top level only
within the same workspace or organization folder.

More: [Folders, moving and finding, Moving](../files/organizing.md#moving)

## Moves that change who can open files

### Can moving a file make it public?

Yes. A file moved into a public folder becomes public, if its status
allows public use. Such a move is never done silently, and only owners and
admins can make files public this way.

More: [Folders, moving and finding, Moves that change who can open files](../files/organizing.md#moves-that-change-who-can-open-files)

### Can moving a file stop its public link?

Yes. A file moved out of a public folder loses the public link the folder
gave it. The app asks before it does that.

More: [Folders, moving and finding, Moves that change who can open files](../files/organizing.md#moves-that-change-who-can-open-files)

### Why does the app ask for a confirmation before it moves my files?

The move would start or stop public links. The dialog "Change who can open
these files?" says what would happen, for example "3 files will become
public via Press kit." or "2 public links will stop working."

More: [Folders, moving and finding, When a move changes who can open files](../files/organizing.md#when-a-move-changes-who-can-open-files)

### What happens when I cancel the "Change who can open these files?" dialog?

The items the dialog asked about stay where they were. Items that could
move without changing access have already moved.

More: [Folders, moving and finding, When a move changes who can open files](../files/organizing.md#when-a-move-changes-who-can-open-files)

### Why can't I, as a member, move a file into a public folder?

The file's status allows public use, so the move would make it public.
Only an owner or admin can do that. The app says "That would make 1 file
public. Only an owner or admin can make files public." and the file stays
where it was.

More: [Folders, moving and finding, When a move changes who can open files](../files/organizing.md#when-a-move-changes-who-can-open-files)

### Can a member move a file that is not approved for public use into a public folder?

Yes, without a confirmation. A file whose status does not allow public use
stays restricted there, so the move makes nothing public.

More: [Folders, moving and finding, Moves that change who can open files](../files/organizing.md#moves-that-change-who-can-open-files)

### I moved a file out of a public folder as a member. Why can't I undo it?

Putting it back would make it public again, and only an owner or admin can
make files public. The app shows the same refusal as for the move itself.
Ask an owner or admin to move it back.

More: [Folders, moving and finding, When a move changes who can open files](../files/organizing.md#when-a-move-changes-who-can-open-files)

### Does undoing a move restore the access the files had?

Yes. Undo of a move that changed access puts the items back and restores
the access they had, without asking again.

More: [Folders, moving and finding, When a move changes who can open files](../files/organizing.md#when-a-move-changes-who-can-open-files)

### Does a file that is public on its own lose its link when I move it?

No. A file that is public by its own general access moves without a
confirmation and keeps its link wherever it goes.

More: [Folders, moving and finding, Edge cases](../files/organizing.md#edge-cases)

### What happens when I move a folder under a public folder?

The eligible files inside it become public: those whose status allows
public use. An owner or admin is asked to confirm first. A member's move
is refused when any file would become public.

More: [Folders, moving and finding, Moves that change who can open files](../files/organizing.md#moves-that-change-who-can-open-files)

### Can a member move an empty folder under a public folder?

Yes. Nothing becomes public, so the folder moves.

More: [Folders, moving and finding, Edge cases](../files/organizing.md#edge-cases)

### Are owners and admins also asked before a move makes files public?

Yes. Nothing changes without a confirmation. An owner's unconfirmed move
answers `409 CONFLICT` with reason `VISIBILITY_CHANGE` and the counts.

More: [Folders, moving and finding, Edge cases](../files/organizing.md#edge-cases)

### What happens when one move would both make files public and stop other links?

It follows the stricter rule: it needs an owner or admin, and the
confirmation.

More: [Folders, moving and finding, Moves that change who can open files](../files/organizing.md#moves-that-change-who-can-open-files)

### What do `becomePublic`, `stopPublic` and `publicVia` say on a refused move?

`becomePublic` is how many files would become public. `stopPublic` is how
many public links would stop. `publicVia` is the `id` and `name` of the
public folder that shares the destination, or `null`.

More: [Folders, moving and finding, Moves that change who can open files](../files/organizing.md#moves-that-change-who-can-open-files)

### How does an API client confirm a move that changes who can open files?

It sends the same request again with `confirmVisibilityChange: true`. An
agent does not confirm that by itself: it shows the counts to a person and
repeats the request on their yes.

More: [Folders, moving and finding, Worked example: make a folder and move a file into it](../files/organizing.md#worked-example-make-a-folder-and-move-a-file-into-it)

### Which scopes does a credential need for a move that makes files public?

`files:write` and `files:approve`. Its member must be an owner or admin
with a verified email, and the confirmation is still needed.

More: [Folders, moving and finding, Moves that change who can open files](../files/organizing.md#moves-that-change-who-can-open-files)

### Which scope does a credential need for a move that only stops public links?

`files:write`, and the confirmation.

More: [Folders, moving and finding, Moves that change who can open files](../files/organizing.md#moves-that-change-who-can-open-files)

### Does the app move anything while it waits for my confirmation?

Yes. It first moves the items it can move without changing access. For the
rest it asks once.

More: [Folders, moving and finding, When a move changes who can open files](../files/organizing.md#when-a-move-changes-who-can-open-files)

### Are the files in a restricted subfolder of a public folder public?

Yes, when their status allows public use. A folder below a public folder
is shared with it.

More: [Folders, moving and finding, Edge cases](../files/organizing.md#edge-cases)

## Selecting several items

### How do I select several files?

Tick the checkbox "Select {name}" on each row. A file's checkbox shows
when you point at the file. Shift-click selects everything between the
last item you picked and this one.

More: [Folders, moving and finding, Selecting several items](../files/organizing.md#selecting-several-items)

### How do I select all files in a folder?

Press Cmd+A on a Mac or Ctrl+A elsewhere, or select one item and tick
"Select all" in the bar that appears. Both select everything shown. When
there is more than is shown, the app says "All {count} on this page are
selected." and offers "Select everything here", which selects up to
1,000 more files each time it is chosen.

More: [Folders, moving and finding, Selecting several items](../files/organizing.md#selecting-several-items)

### Where is "Select all"?

In the bar that appears at the bottom of the listing once something is
selected. With nothing selected, press Cmd+A or Ctrl+A, or choose "Select
all" in the command palette.

More: [Folders, moving and finding, Selecting several items](../files/organizing.md#selecting-several-items)

### What can I do with a selection of files?

The bar at the bottom of the listing shows "Select all", "{n} selected"
and the actions "Download", "Move", "Set status", "Set field", "Move to
trash" and "Clear selection".

More: [Folders, moving and finding, Selecting several items](../files/organizing.md#selecting-several-items)

### How do I clear a selection?

Press Escape or choose "Clear selection".

More: [Folders, moving and finding, Selecting several items](../files/organizing.md#selecting-several-items)

### Why did my selection disappear?

The selection is cleared when you open another folder or change the
search, a filter or the sort.

More: [Folders, moving and finding, Selecting several items](../files/organizing.md#selecting-several-items)

### Why are there no checkboxes on the files?

A file's checkbox shows when you point at the file or reach it with the Tab key,
and on every file once something is selected. On a touch screen it always shows.
A folder's card shows its checkbox the same way, in place of its icon; a
folder's row in the list view always shows it. Checkboxes exist only where you
may change files: a member sees none in the organization folder, which only
owners and admins change.

More: [Folders, moving and finding, Selecting several items](../files/organizing.md#selecting-several-items)

### Can I select files and folders together?

Yes. A selection can hold both, and "Move", "Download" and "Move to trash"
act on all of it.

More: [Folders, moving and finding, Selecting several items](../files/organizing.md#selecting-several-items)

## Menus of files and folders

### What is in the menu of a file or a folder?

"Open", "Download", "Share", "Make public" or "Make restricted", "Copy
link", "Rename", "Move", "Move to parent folder", "Set status", "Add to
favorites" or "Remove from favorites" and "Move to trash". You see the
items you may use.

More: [Folders, moving and finding, The menu of a file or folder](../files/organizing.md#the-menu-of-a-file-or-folder)

### How do I open the menu of a file?

Use its "File actions for {name}" button, or right-click the row. A
folder has "Folder actions for {name}" and the same right-click.

More: [Folders, moving and finding, The menu of a file or folder](../files/organizing.md#the-menu-of-a-file-or-folder)

### Why do I not see "Rename" or "Move" in a file's menu?

Those items are shown to whoever may change the item: every member in a
workspace, and owners and admins in the organization folder.

More: [Folders, moving and finding, The menu of a file or folder](../files/organizing.md#the-menu-of-a-file-or-folder)

### Why do I not see "Set status" in a file's menu?

"Set status" is shown to owners and admins.

More: [Folders, moving and finding, The menu of a file or folder](../files/organizing.md#the-menu-of-a-file-or-folder)

### What does "Copy link" copy for a file?

The address of the file's page in the app. The app confirms with "Copied
the link". That address opens for people who can open the file in
Talewright.

More: [Folders, moving and finding, The menu of a file or folder](../files/organizing.md#the-menu-of-a-file-or-folder)

### What does "Copy link" copy for a public folder?

The folder's gallery link.

More: [Folders, moving and finding, The menu of a file or folder](../files/organizing.md#the-menu-of-a-file-or-folder)

### Do the folders in the tree have a right-click menu?

Yes. The folders of the open workspace in the tree have the same menu on
right-click as in the listing.

More: [Folders, moving and finding, The menu of a file or folder](../files/organizing.md#the-menu-of-a-file-or-folder)

### Which menu items does a member see on an organization folder file?

"Open", "Download", "Share", "Copy link" and "Add to favorites".

More: [Files & Assets overview, What a member of the organization folder sees](../files/overview.md#what-a-member-of-the-organization-folder-sees)

## Grid view and list view

### How do I switch between the grid and the list?

Use the view switch, which has "Grid view" and "List view". The grid is
the default.

More: [Folders, moving and finding, Grid and list](../files/organizing.md#grid-and-list)

### What does the grid view show?

Folders first, as small cards with their counts, such as "2 folders, 14
files". Files follow as tiles with a thumbnail or a type icon, the name,
and a line with the status and the size, such as "Approved for public use
· 2.4 MB". A file without a status shows only its size.

More: [Folders, moving and finding, Grid and list](../files/organizing.md#grid-and-list)

### Which columns does the list view have?

"Name", "Status", "Size" and "Modified". A file's row also shows its tags.

More: [Folders, moving and finding, Grid and list](../files/organizing.md#grid-and-list)

### Can I add, remove or reorder columns in the list view?

No. The list has the columns "Name", "Status", "Size" and "Modified".

More: [Folders, moving and finding, Grid and list](../files/organizing.md#grid-and-list)

### How do I see who last changed a file?

In the list view, hover the modified time. It shows "Updated by {name}".

More: [Folders, moving and finding, Grid and list](../files/organizing.md#grid-and-list)

### How many files does the listing show at once?

50 at first. "Load more" shows the next 50.

More: [Folders, moving and finding, Grid and list](../files/organizing.md#grid-and-list)

### What do "Public" and "Public via folder" mean on a file in the listing?

Anyone with the link can open the file. "Public" means by the file's own
general access. "Public via folder" means through a public folder above
it.

More: [Folders, moving and finding, Grid and list](../files/organizing.md#grid-and-list)

### Is the grid or list view part of the page's address?

Yes, together with the sort, the filters and the search. A copied or
bookmarked address opens the same view.

More: [Folders, moving and finding, Grid and list](../files/organizing.md#grid-and-list)

### Can I sort the list by clicking a column heading?

Yes, for two of them. Clicking "Name" or "Modified" sorts by it.

More: [Folders, moving and finding, Grid and list](../files/organizing.md#grid-and-list)

### What does "No files yet. Upload files to start." mean?

The top level is empty and you may upload.

More: [Folders, moving and finding, Grid and list](../files/organizing.md#grid-and-list)

### Why does an empty top level only say "No files yet."?

The top level is empty and you may not upload there, for example as a
member in the organization folder.

More: [Folders, moving and finding, Grid and list](../files/organizing.md#grid-and-list)

### What does "This folder is empty." mean?

The open folder holds nothing: no files and no folders.

More: [Folders, moving and finding, Grid and list](../files/organizing.md#grid-and-list)

### What does "No files match." mean?

A search, status, field or tag filter matches nothing. Choose "Clear
search and filters" below the message to see every file again.

More: [Folders, moving and finding, Grid and list](../files/organizing.md#grid-and-list)

### What does "No images here." mean?

The type filter "Images" matches nothing in the open folder and the
folders below it. The same goes for "No videos here.", "No PDFs here.",
"No fonts here." and "No design files here."

More: [Folders, moving and finding, Grid and list](../files/organizing.md#grid-and-list)

### What does "Clear search and filters" do?

It empties the search and turns every filter off. It keeps the open
folder, the sort and the view.

More: [Folders, moving and finding, Grid and list](../files/organizing.md#grid-and-list)

## Searching for files

### How do I search for a file?

Type into "Search files". The results appear a moment after you stop
typing, or at once when you press Enter.

More: [Folders, moving and finding, Searching](../files/organizing.md#searching)

### What does file search look at?

A file's name, description, caption, alt text, tags and the values of its
text fields.

More: [Folders, moving and finding, Search](../files/organizing.md#search)

### Does search look inside my files?

No. Search does not look inside files. It matches the name, description,
caption, alt text, tags and text fields.

More: [Folders, moving and finding, Search](../files/organizing.md#search)

### Can I search for text inside a PDF or an image?

No. Search does not look inside files. Put the words you want to find in
the file's description, caption, alt text or tags.

More: [Folders, moving and finding, Search](../files/organizing.md#search)

### Does search find folders by name?

No. Search does not match folder names, and results list files only. Each
result says where it is: "In {folder} / {subfolder}".

More: [Folders, moving and finding, Searching](../files/organizing.md#searching)

### Does search only look in the folder I have open?

No. It looks through every folder of the open workspace or organization
folder. The line "Showing matches from every folder." says so.

More: [Folders, moving and finding, Searching](../files/organizing.md#searching)

### Does search look through all my workspaces at once?

No. Search stays within one workspace or the organization folder. A word in
a file of another workspace is not found.

More: [Folders, moving and finding, Edge cases](../files/organizing.md#edge-cases)

### Why doesn't search find my file by part of a word?

A word matches from the start of a word: "quart" finds "quarterly". It
does not match in the middle: "port" does not find "report".

More: [Folders, moving and finding, Search](../files/organizing.md#search)

### Do I have to type the whole word to find a file?

No. The start of a word is enough: "quart" finds "quarterly".

More: [Folders, moving and finding, Search](../files/organizing.md#search)

### Does a search with two words find files with either word or with both?

With both. Every word must match: "spring poster" finds files that have
both.

More: [Folders, moving and finding, Search](../files/organizing.md#search)

### Is file search case-sensitive?

No. Upper and lower case do not matter.

More: [Folders, moving and finding, Search](../files/organizing.md#search)

### How does search treat hyphens, dots and underscores in a file name?

Punctuation separates words, in what you type and in file names:
`prometheus-future-city.jpg` is found by "future", by "city" and by "jpg".

More: [Folders, moving and finding, Search](../files/organizing.md#search)

### Can I find files by their extension?

Yes. The extension is a word of the file's name, so "jpg" finds
`prometheus-future-city.jpg`. The "Type" filter is the other way to narrow
by kind.

More: [Folders, moving and finding, Search](../files/organizing.md#search)

### Can I search for a file by its status name?

No. Search does not match status names. Use the "Status" filter instead.

More: [Folders, moving and finding, Search](../files/organizing.md#search)

### Can I search by the value of a date, number or select field?

No. Search matches the values of text fields only. For a select field,
use its group in the "Filter" menu.

More: [Folders, moving and finding, Search](../files/organizing.md#search)

### Does the file search box also match a file's tags?

Yes. Tags are searched, and the "Filter" menu also has a "Tag" group when
there is at least one tag.

More: [Folders, moving and finding, Search](../files/organizing.md#search)

### How soon is a renamed or newly described file found by search?

At once. A change is searchable at once.

More: [Folders, moving and finding, Search](../files/organizing.md#search)

### Does search rank the best matches first?

No. Search does not reorder the results. They come in the order of the
chosen sort.

More: [Folders, moving and finding, Search](../files/organizing.md#search)

### What happens when I search for only punctuation?

Every file is listed. A query without any letter or digit filters nothing.

More: [Folders, moving and finding, Search](../files/organizing.md#search)

### What happens to the words past the tenth in a long search?

They are ignored. The first 10 words of a query count.

More: [Folders, moving and finding, Search](../files/organizing.md#search)

### How do I clear the search?

Choose "Clear search". It empties the box.

More: [Folders, moving and finding, Searching](../files/organizing.md#searching)

### Why are my folders hidden while I search?

While any filter or a search is on, folders are hidden and each file says
which folder it is in.

More: [Folders, moving and finding, Filtering and sorting](../files/organizing.md#filtering-and-sorting)

### Can I combine a search with filters?

Yes. Filters combine: a file must pass every one of them, and the search
too.

More: [Folders, moving and finding, Filters](../files/organizing.md#filters)

### Can I use quotes, AND, OR or wildcards in a file search?

No. Search has no operators. Punctuation separates words, every word must
match, and each word matches from the start of a word.

More: [Folders, moving and finding, Search](../files/organizing.md#search)

### Can I save a search to use it again?

No. There is no saved-search feature. The search, the filters, the sort
and the view are part of the page's address, so you can bookmark the
address and open the same view again.

More: [Folders, moving and finding, Grid and list](../files/organizing.md#grid-and-list)

### Is a file found after its alt text was cleared?

Not by the words that were in the alt text. Search follows every change at
once.

More: [Folders, moving and finding, Edge cases](../files/organizing.md#edge-cases)

### Can a member use file search in the organization folder?

Yes. Every member of the organization can list and search the organization
folder's files.

More: [Folders, moving and finding, Who can do what](../files/organizing.md#who-can-do-what)

## Filtering files

### How do I filter the files I see?

Open the "Filter" menu. It has the groups "Type", "Status", one group per
select or multi-select field of the organization, "Show" and, when there
is at least one tag, "Tag".

More: [Folders, moving and finding, Filtering and sorting](../files/organizing.md#filtering-and-sorting)

### How do I show only images?

Click the "Images" card above the listing, or choose Filter > "Type" >
"Images".

More: [Folders, moving and finding, Filtering and sorting](../files/organizing.md#filtering-and-sorting)

### Which file types count as images in the type filter?

JPEG, PNG, GIF, WebP, AVIF, SVG, ICO, HEIC, HEIF, Photoshop and raw
photos.

More: [Folders, moving and finding, Filters](../files/organizing.md#filters)

### Which file types count as videos in the type filter?

MP4, WebM and QuickTime.

More: [Folders, moving and finding, Filters](../files/organizing.md#filters)

### Which file types count as design files in the type filter?

Illustrator, EPS, InDesign and Figma. Photoshop files count as images.

More: [Folders, moving and finding, Filters](../files/organizing.md#filters)

### Which file types count as fonts in the type filter?

WOFF, WOFF2, TrueType and OpenType.

More: [Folders, moving and finding, Filters](../files/organizing.md#filters)

### How do I show only PDFs?

Click the "PDFs" card above the listing, or choose Filter > "Type" >
"PDFs".

More: [Folders, moving and finding, Filtering and sorting](../files/organizing.md#filtering-and-sorting)

### Is there a filter for Word, Excel, CSV and text files?

Not in the app. The API has the type `other` for CSV, Word, Excel,
Markdown and text, but the app has no filter for it. An address that names
it opens the listing unfiltered.

More: [Folders, moving and finding, Filtering and sorting](../files/organizing.md#filtering-and-sorting)

### Does a type filter look in subfolders?

Yes. A type filter alone looks through the open folder and every folder
below it.

More: [Folders, moving and finding, Filtering and sorting](../files/organizing.md#filtering-and-sorting)

### Which filters look through the whole workspace instead of the open folder?

Search, status, field, tag and duplicates. Only a type filter alone stays
within the open folder and the folders below it.

More: [Folders, moving and finding, Filtering and sorting](../files/organizing.md#filtering-and-sorting)

### How do I find duplicate files in a workspace?

Choose Filter > "Show" > "Duplicates". It lists the files whose bytes are
the same as another live file's in the same workspace or organization folder.

More: [Folders, moving and finding, Filters](../files/organizing.md#filters)

### Does the duplicates filter compare files across workspaces?

No. It compares current versions only, within one workspace or the
organization folder, and ignores trashed files.

More: [Folders, moving and finding, Filters](../files/organizing.md#filters)

### Does the duplicates filter find files with the same name?

No. It finds files whose bytes are the same. Names play no part.

More: [Folders, moving and finding, Filters](../files/organizing.md#filters)

### What does "No duplicates here." mean?

The duplicates filter matches nothing: no file in this workspace or
organization folder has the same bytes as another live file there.

More: [Folders, moving and finding, Grid and list](../files/organizing.md#grid-and-list)

### How do I narrow the file listing to files that have no status?

Choose Filter > "Status" > "No status".

More: [Folders, moving and finding, Filtering and sorting](../files/organizing.md#filtering-and-sorting)

### Can I use several filters at the same time?

Yes. A file must pass every filter that is on, and the search too.

More: [Folders, moving and finding, Filters](../files/organizing.md#filters)

### How do I know how many filters are on?

The "Filter" button shows the number. To screen readers it reads "Filter,
{n} on".

More: [Folders, moving and finding, Filtering and sorting](../files/organizing.md#filtering-and-sorting)

### How do I turn all filters off?

Choose "Clear filters". It turns them all off and keeps the search and the
sort.

More: [Folders, moving and finding, Filtering and sorting](../files/organizing.md#filtering-and-sorting)

### What is the difference between "Clear filters" and "Clear search and filters"?

"Clear filters" turns every filter off and keeps the search. "Clear search
and filters" also empties the search. Both keep the sort.

More: [Folders, moving and finding, Filtering and sorting](../files/organizing.md#filtering-and-sorting)

### Does the type filter go by the file's name or by its content?

By the current version's type, which comes from the bytes. A PNG renamed
to `logo.jpg` is still filtered as a PNG image.

More: [Folders, moving and finding, Filters](../files/organizing.md#filters)

### Can I filter files by who uploaded them or by date?

No. The filters are type, status, select fields, duplicates and tag.

More: [Folders, moving and finding, Filtering and sorting](../files/organizing.md#filtering-and-sorting)

### Can I filter files by size?

No. The filters are type, status, select fields, duplicates and tag.

More: [Folders, moving and finding, Filtering and sorting](../files/organizing.md#filtering-and-sorting)

### Why does the "Filter" menu have no "Tag" group?

The "Tag" group is shown when there is at least one tag in the workspace
or organization folder.

More: [Folders, moving and finding, Filtering and sorting](../files/organizing.md#filtering-and-sorting)

## Sorting files

### How can I sort files?

The "Sort" menu has "Recently updated", the default, and "Name".

More: [Folders, moving and finding, Filtering and sorting](../files/organizing.md#filtering-and-sorting)

### What is the default sort order of files?

"Recently updated": the most recently updated file first.

More: [Folders, moving and finding, Sorting](../files/organizing.md#sorting)

### Can I sort files by size or by upload date?

No. Files sort by "Recently updated" or by "Name". There is no
descending-by-name or oldest-first order either.

More: [Folders, moving and finding, Sorting](../files/organizing.md#sorting)

### Can I sort files from Z to A or oldest first?

No. There is no descending-by-name or oldest-first order.

More: [Folders, moving and finding, Sorting](../files/organizing.md#sorting)

### How does sorting by name treat upper and lower case?

They are sorted together. Sorting by name orders the way a person would.

More: [Folders, moving and finding, Sorting](../files/organizing.md#sorting)

### What counts as an update for "Recently updated"?

A file's "updated" time moves when its details or place change, when it
gets a new version and when it is trashed or restored.

More: [Folders, moving and finding, Sorting](../files/organizing.md#sorting)

### Does sorting change the order of folders?

No. Sorting orders files. Folders stay first, by name.

More: [Folders, moving and finding, Filtering and sorting](../files/organizing.md#filtering-and-sorting)

### Can I arrange files in a custom order by dragging?

No. Files are ordered by "Recently updated" or by "Name". Dragging a file
moves it to another folder.

More: [Folders, moving and finding, Sorting](../files/organizing.md#sorting)

## Favorites

### How do I add a file to my favorites?

On the file's page, click the star beside the name, which reads "Add to
favorites". In a listing, choose "Add to favorites" in the file's menu.

More: [Folders, moving and finding, Favorites in the app](../files/organizing.md#favorites-in-the-app)

### Can I add a folder to my favorites?

Yes. Choose "Add to favorites" in the folder's menu. A folder favorite
opens the folder.

More: [Folders, moving and finding, Favorites in the app](../files/organizing.md#favorites-in-the-app)

### Where do I find my favorites?

Under "Favorites" in the navigation of Files & Assets, in the order you
added them. It reads "No favorites yet" while you have none.

More: [Folders, moving and finding, Favorites in the app](../files/organizing.md#favorites-in-the-app)

### Can other people see my favorites?

No. Favorites are private. Nobody else sees or changes yours, admins
included.

More: [Folders, moving and finding, Favorites](../files/organizing.md#favorites)

### Are favorites shared across workspaces?

No. Favorites are kept per workspace and for the organization folder
separately. Each list shows while you are in that workspace or in the
organization folder.

More: [Folders, moving and finding, Favorites](../files/organizing.md#favorites)

### Can I star an organization folder file when I cannot change the organization folder?

Yes. Anyone who can read a workspace or the organization folder can star
what is in it.

More: [Folders, moving and finding, Favorites](../files/organizing.md#favorites)

### Can I reorder my favorites?

Not in the app, which has no control for it. Through the REST API you can
reorder them by sending all of them in the new order.

More: [Folders, moving and finding, Favorites in the app](../files/organizing.md#favorites-in-the-app)

### What happens to a favorite when its file is moved to the trash?

It is hidden. It comes back when the file is restored.

More: [Folders, moving and finding, Favorites](../files/organizing.md#favorites)

### What happens to a favorite when its file is deleted for good?

The favorite is gone for good.

More: [Folders, moving and finding, Favorites](../files/organizing.md#favorites)

### Does removing a favorite delete the file?

No. Removing a favorite does nothing to the file or folder.

More: [Folders, moving and finding, Favorites](../files/organizing.md#favorites)

### Does a favorite keep working after its file is renamed or moved?

Yes. A favorite follows its target: it shows the target's current name,
and a folder favorite carries the folders above it.

More: [Folders, moving and finding, Favorites](../files/organizing.md#favorites)

### What happens when I star something that is already a favorite?

Nothing changes. The existing favorite is returned, and its place in your
list stays.

More: [Folders, moving and finding, Favorites](../files/organizing.md#favorites)

### What does "Could not add to favorites. Try again." mean?

Starring was refused, and the star stays as it was. Try again. Unstarring
has the matching message "Could not remove from favorites. Try again."

More: [Folders, moving and finding, Favorites in the app](../files/organizing.md#favorites-in-the-app)

### Can a credential manage favorites through the REST API?

Yes, with `files:read`. It lists, adds, reorders and removes the favorites
of the member it acts for. There are no MCP tools for favorites.

More: [Folders, moving and finding, Operations](../files/organizing.md#operations)

### Can I favorite a file in another workspace from this one?

No. Only a live file or folder of that workspace or organization folder can be
starred there. A favorite that names a file of another workspace answers
`404 NOT_FOUND`.

More: [Folders, moving and finding, Edge cases](../files/organizing.md#edge-cases)

### Where does a new favorite go in my list?

To the end of your list.

More: [Folders, moving and finding, Favorites](../files/organizing.md#favorites)

## The Details pane

### What is the Details pane?

The pane beside the listing. It shows the open folder, or the workspace or
organization folder at the top level: its name, how many folders and files
are inside, and who can open it.

More: [Folders, moving and finding, The Details pane](../files/organizing.md#the-details-pane)

### How do I open the Details pane on a small screen?

Use the "Details" button, or press Cmd+I or Ctrl+I. Escape closes it.

More: [Folders, moving and finding, The Details pane](../files/organizing.md#the-details-pane)

### What do "Restricted", "Every workspace", "Public" and "Public, from {folder}" mean in "Folder details"?

They say who can open what you have open. "Every workspace" stands for the
organization folder. "Public, from {folder}" means the folder is public
through a public folder above it.

More: [Folders, moving and finding, The Details pane](../files/organizing.md#the-details-pane)

### What does the "Recent activity" card show?

The files changed last in the folder and below it.

More: [Folders, moving and finding, The Details pane](../files/organizing.md#the-details-pane)

### What does the "People" card show?

Who can open the workspace or the organization folder.

More: [Folders, moving and finding, The Details pane](../files/organizing.md#the-details-pane)

### What does the "Location" card of a folder show?

The folders above it, with "Move".

More: [Folders, moving and finding, The Details pane](../files/organizing.md#the-details-pane)

### Can I rename the open folder from the Details pane?

Yes. Inside a folder, "About" holds the form "Folder name" with "Rename".

More: [Folders, moving and finding, The Details pane](../files/organizing.md#the-details-pane)

### What does "added" mean in "Recent activity"?

The file was not changed since its upload.

More: [Files & Assets overview, The Details pane](../files/overview.md#the-details-pane)

## A file's name, description, caption and alt text

### Where do I edit a file's description, caption and alt text?

On the file's page, in the section "Details" under the preview.

More: [Folders, moving and finding, Editing a file's details](../files/organizing.md#editing-a-files-details)

### What is the difference between a description, a caption and alt text?

All three are text about a file. The description is the longest, the
caption is a short text to show with the file, and alt text describes an
image for people who cannot see it.

More: [Folders, moving and finding, Details: description, caption, alt text](../files/organizing.md#details-description-caption-alt-text)

### Why is there no "Alt text" field on my PDF?

The app offers "Alt text" for images only. Over the API, alt text can be
set on any file.

More: [Folders, moving and finding, Details: description, caption, alt text](../files/organizing.md#details-description-caption-alt-text)

### How do I save changes to a file's details?

Choose "Save details". It is enabled only while there is something to
save. Beside the button the form says "Unsaved changes", then "Saved".

More: [Folders, moving and finding, Editing a file's details](../files/organizing.md#editing-a-files-details)

### Why is "Save details" greyed out when nothing changed?

"Save details" is enabled only while there is something to save.

More: [Folders, moving and finding, Editing a file's details](../files/organizing.md#editing-a-files-details)

### Are a file's details saved automatically?

No. Choose "Save details". Unsaved changes are kept for that browser tab
if you leave the page, and are back when you return to the file.

More: [Folders, moving and finding, Editing a file's details](../files/organizing.md#editing-a-files-details)

### What happens to my unsaved details when I leave the file's page?

They are kept for that browser tab and are back when you return to the
file. Closing or reloading the tab asks before discarding them.

More: [Folders, moving and finding, Editing a file's details](../files/organizing.md#editing-a-files-details)

### How do I remove a file's description?

Empty the field and save. Blank text clears a detail.

More: [Folders, moving and finding, Details: description, caption, alt text](../files/organizing.md#details-description-caption-alt-text)

### Can a description or a caption have line breaks?

Yes. Line breaks are allowed in a description and in a caption. Alt text
is one run of text.

More: [Folders, moving and finding, Details: description, caption, alt text](../files/organizing.md#details-description-caption-alt-text)

### Why can't I save a tab character in a file's name or alt text?

A name and an alt text hold no control character. The save is refused
with "Remove the tab or other character that cannot be saved." under that
field. A description and a caption may hold tabs and line breaks.

More: [Folders, moving and finding, Editing a file's details](../files/organizing.md#editing-a-files-details)

### Are a file's description, caption and alt text required?

No. Each is optional and starts empty. Only the name is required.

More: [Folders, moving and finding, Details: description, caption, alt text](../files/organizing.md#details-description-caption-alt-text)

### What does a member who can only read see instead of the detail fields?

"Description", "Caption", "Alt text" and "Tags" as text, each "None" when
empty.

More: [Folders, moving and finding, Editing a file's details](../files/organizing.md#editing-a-files-details)

### Does "Save details" also save the "Fields" section?

No. The "Fields" section has its own "Save fields". Saving one keeps what you
typed in the other.

More: [Folders, moving and finding, Editing a file's details](../files/organizing.md#editing-a-files-details)

### Does saving details send every field or only what I changed?

Only the fields you changed are sent. A detail that is left out of a
request stays as it is.

More: [Folders, moving and finding, Editing a file's details](../files/organizing.md#editing-a-files-details)

### Why does saving a file's details fail with "Could not save the details. Try again."?

The save failed for a reason other than a field's own rule, the trash or
the organization folder's permissions. Choose "Save details" again.

More: [Folders, moving and finding, Editing a file's details](../files/organizing.md#editing-a-files-details)

### Can I edit the details of several files at once?

No. Name, description, caption and alt text are edited on one file's
page. A selection offers "Move", "Set status", "Set field", "Download" and
"Move to trash".

More: [Folders, moving and finding, Selecting several items](../files/organizing.md#selecting-several-items)

### Is the alt text of a file used when the file is found by search?

Yes. Description, caption and alt text are all searchable.

More: [Folders, moving and finding, Details: description, caption, alt text](../files/organizing.md#details-description-caption-alt-text)

### Where do I see a file's size, type and dimensions?

On the file's page, in the "Properties" section in "Details": "Type", "Size",
"Dimensions", "Updated" and "Created".

More: [Files & Assets overview, A file's page](../files/overview.md#a-files-page)

### Who can edit a file's details?

Every member of the workspace. In the organization folder, owners and admins
of the organization.

More: [Folders, moving and finding, Who can do what](../files/organizing.md#who-can-do-what)

## When someone else changed it first

### What happens when two people edit the same file's details at the same time?

The first save is applied. The second is refused instead of overwriting
the first, and the page shows "This file changed since you opened it.
Reloading keeps your unsaved edits." with the button "Reload latest".

More: [Folders, moving and finding, When someone else changed it first](../files/organizing.md#when-someone-else-changed-it-first)

### What does "Reload latest" do?

It loads the current file. Fields you changed keep your text. Fields you
did not touch show the other person's values. Your next save then applies.

More: [Folders, moving and finding, When someone else changed it first](../files/organizing.md#when-someone-else-changed-it-first)

### Do I lose what I typed when the file changed since I opened it?

No. What you typed stays in the fields, also after "Reload latest".

More: [Folders, moving and finding, When someone else changed it first](../files/organizing.md#when-someone-else-changed-it-first)

### Which buttons are disabled on a file's page until I reload the latest version?

"Save details", "Save fields", "Replace file", "Move" and "Move to trash".

More: [Folders, moving and finding, When someone else changed it first](../files/organizing.md#when-someone-else-changed-it-first)

### Can my save overwrite a colleague's change to the same file?

No. The app never overwrites another person's change. A change is checked
against what you last saw, and it is refused if someone changed the file
first.

More: [Folders, moving and finding, When someone else changed it first](../files/organizing.md#when-someone-else-changed-it-first)

### What does "This file changed since the list loaded. The list is up to date now; try again." mean?

You renamed, moved or trashed an item in a listing that someone changed
after the list loaded. The change was refused, and the list refreshed by
itself. Do it again.

More: [Folders, moving and finding, When someone else changed it first](../files/organizing.md#when-someone-else-changed-it-first)

### Do I have to reopen the Rename or Move dialog after "changed since the list loaded"?

No. The dialog stays open. Choosing "Rename" or "Move here" again applies
the change to the current item.

More: [Folders, moving and finding, When someone else changed it first](../files/organizing.md#when-someone-else-changed-it-first)

### Does the app retry my change by itself when someone else changed the file first?

No. Nothing is retried silently. You see what happened and decide.

More: [Folders, moving and finding, When someone else changed it first](../files/organizing.md#when-someone-else-changed-it-first)

### Does a new version of a file block me from saving its details?

No. A file's `lockVersion` does not move when the file gets a new version,
so your save applies.

More: [Folders, moving and finding, Lock versions](../files/organizing.md#lock-versions)

### Why was my save refused although nobody edited the file's text?

A file's `lockVersion` also moves when the file is moved, trashed or
restored, when a tag it carries is renamed or deleted, and when a field or
choice it had a value for is deleted. Any of these makes your page stale.

More: [Folders, moving and finding, Lock versions](../files/organizing.md#lock-versions)

### What changes a folder's lock version?

Renaming, moving, trashing or restoring the folder.

More: [Folders, moving and finding, Lock versions](../files/organizing.md#lock-versions)

### Does saving a value that is already set count as a change?

Yes. A request that sets a value to what it already is counts as a change
and moves `lockVersion` on by one. A request that names nothing to change
succeeds and leaves it as it is.

More: [Folders, moving and finding, Lock versions](../files/organizing.md#lock-versions)

### Is there a way to lock a file so that nobody else can edit it?

No. There is no file locking or check-out. Instead every change is checked
against what you last saw, so nobody's change is overwritten unseen.

More: [Folders, moving and finding, Lock versions](../files/organizing.md#lock-versions)

### Can I see who else has a file open right now?

No. The app does not show who else is viewing a file. If someone changes
it while you have it open, your next save is refused and you are asked to
reload.

More: [Folders, moving and finding, When someone else changed it first](../files/organizing.md#when-someone-else-changed-it-first)

## Keyboard shortcuts for files

### Which keyboard shortcuts work in Files & Assets?

G then F goes to Files & Assets. R renames, M moves, Cmd+Backspace or
Ctrl+Backspace moves to the trash, Cmd+A or Ctrl+A selects everything
shown, Cmd+I or Ctrl+I toggles the details, Cmd+Z or Ctrl+Z undoes, and
Escape clears the selection. On the Suggestions page, A runs the front
card's "Review" or "Hide" and S is "Not now".

More: [Folders, moving and finding, Keyboard shortcuts](../files/organizing.md#keyboard-shortcuts)

### What is the keyboard shortcut for renaming a file?

R, while one item is selected or a file is open.

More: [Folders, moving and finding, Keyboard shortcuts](../files/organizing.md#keyboard-shortcuts)

### What is the keyboard shortcut for moving files?

M, while at least one item is selected or a file is open.

More: [Folders, moving and finding, Keyboard shortcuts](../files/organizing.md#keyboard-shortcuts)

### Why do the R and M keys do nothing?

Single keys do nothing while you type in a field or while a dialog or menu
is open. R also needs exactly one selected item or an open file.

More: [Folders, moving and finding, Keyboard shortcuts](../files/organizing.md#keyboard-shortcuts)

### Does the command palette have file actions?

Yes. It offers "New folder", "Go to Organization folder", "Download" and
"Share", besides "Upload files", "Upload folder" and "Go to Files & Assets".

More: [Folders, moving and finding, Keyboard shortcuts](../files/organizing.md#keyboard-shortcuts)

### Is there a keyboard shortcut for the Details pane?

Yes. Cmd+I or Ctrl+I toggles it while the Details pane is a drawer, which
is on a narrow window.

More: [Folders, moving and finding, Keyboard shortcuts](../files/organizing.md#keyboard-shortcuts)

## Organizing the organization folder

### Who can organize files in the organization folder?

Owners and admins of the organization. They create, rename and move
folders, and rename, move and describe files. Every other member reads the
organization folder.

More: [Folders, moving and finding, Who can do what](../files/organizing.md#who-can-do-what)

### What can a member do with files in the organization folder?

List folders, list and search files, open and download them, and star
favorites. A member cannot rename, move or describe organization folder files.

More: [Folders, moving and finding, Who can do what](../files/organizing.md#who-can-do-what)

### Which role counts for organizing files: my workspace role or my organization role?

In a workspace, your effective workspace role. In the organization folder, your
organization role.

More: [Folders, moving and finding, Who can do what](../files/organizing.md#who-can-do-what)

### What happens when a member tries to rename an organization folder file through the API?

The answer is `403 FORBIDDEN`. Only owners and admins change the
organization folder.

More: [Folders, moving and finding, Edge cases](../files/organizing.md#edge-cases)

### Can someone outside a workspace see its folder names?

No. Someone outside the workspace who lists its files or folders gets `404
NOT_FOUND`, as for an unknown workspace. Outsiders cannot tell it exists.

More: [Folders, moving and finding, Edge cases](../files/organizing.md#edge-cases)

## Organizing files through the API

### Which API operations organize files and folders?

`GET W/files` and `GET W/files/{fileID}` read, `PATCH W/files/{fileID}`
changes a file, `GET W/folders` and `POST W/folders` list and create
folders, and `PATCH W/folders/{folderID}` changes one. Every operation
exists for the organization folder too.

More: [Folders, moving and finding, Operations](../files/organizing.md#operations)

### What can one `PATCH` of a file change?

Any of `name`, `description`, `caption`, `altText`, `tags`, `folderID` and
`fields`, together with the required `expectedLockVersion`. The answer is
the file with its new `lockVersion`.

More: [Folders, moving and finding, Requests and answers](../files/organizing.md#requests-and-answers)

### How do I move a file to the top level through the API?

Send `folderID: null` in the `PATCH`, with the file's current
`expectedLockVersion`.

More: [Folders, moving and finding, Moving a file](../files/organizing.md#moving-a-file)

### How do I clear a file's description through the API?

Send `description: null` or blank text. A detail you leave out of the
request stays as it is.

More: [Folders, moving and finding, Details: description, caption, alt text](../files/organizing.md#details-description-caption-alt-text)

### What happens when an API move names the folder the file is already in?

It succeeds and `lockVersion` goes up by one. Naming a value counts as a
change.

More: [Folders, moving and finding, Edge cases](../files/organizing.md#edge-cases)

### What happens when an API move names a folder of another workspace?

It answers `422 VALIDATION_FAILED` on `folderID`, the same as for an
unknown ID. Moves stay within one workspace or the organization folder.

More: [Folders, moving and finding, Edge cases](../files/organizing.md#edge-cases)

### How do I read one folder by its ID through the API?

You cannot. There is no operation that reads one folder by its ID. List
the folders of its parent.

More: [Folders, moving and finding, Requests and answers](../files/organizing.md#requests-and-answers)

### How do I list the folders at the top level through the API?

Call `GET W/folders` without `parentID`. With `parentID` it lists the
folders inside that folder.

More: [Folders, moving and finding, Requests and answers](../files/organizing.md#requests-and-answers)

### What does a folder hold in an API answer?

`id`, `name`, `parentID`, `folderCount`, `fileCount`, `lockVersion`,
`visibility`, `publicURL`, `publicVia`, `createdAt`, `updatedAt`,
`deletedAt` and `purgeAfter`.

More: [Folders, moving and finding, Requests and answers](../files/organizing.md#requests-and-answers)

### What is `folderPath` on a listed file?

The folders from the top level down to the file's own folder, each with
`id` and `name`. It is empty for a file at the top level.

More: [Folders, moving and finding, Listing files](../files/organizing.md#listing-files)

### How do I list only the files at the top level through the API?

Send `root=true`. Without any of `folderID`, `root` and `under`, a listing
returns every live file in every folder.

More: [Folders, moving and finding, Listing files](../files/organizing.md#listing-files)

### How do I list all files in a folder and its subfolders through the API?

Send `under` with the folder's ID. It lists the files in that folder and
in every live folder below it. Trashed folders and their files are left
out.

More: [Folders, moving and finding, Listing files](../files/organizing.md#listing-files)

### Which `sort` values does a file listing accept?

`updated`, the default, and `name`.

More: [Folders, moving and finding, Sorting](../files/organizing.md#sorting)

### Which `type` values does a file listing accept?

`image`, `video`, `font`, `pdf`, `design` and `other`. `other` covers CSV,
Word, Excel, Markdown and text.

More: [Folders, moving and finding, Filters](../files/organizing.md#filters)

### What happens when a `tag` filter names a tag of another workspace?

It filters everything out. It is not an error.

More: [Folders, moving and finding, Filters](../files/organizing.md#filters)

### How do I add a favorite through the REST API?

`POST W/favorites` with `kind` (`file` or `folder`) and `targetID`. It
answers `201` when the favorite is new and `200` when it already existed.

More: [Folders, moving and finding, Requests and answers](../files/organizing.md#requests-and-answers)

### How do I reorder favorites through the REST API?

`PUT W/favorites/order` with `favoriteIDs`: every favorite once, in the
new order. Leaving one out or naming one twice answers `422
VALIDATION_FAILED` on `favoriteIDs`.

More: [Folders, moving and finding, Edge cases](../files/organizing.md#edge-cases)

### What does a favorite hold in an API answer?

`id`, `kind`, `targetID`, `name`, `createdAt`, `file` (a file summary, for
a file) and `folderPath` (for a folder).

More: [Folders, moving and finding, Requests and answers](../files/organizing.md#requests-and-answers)

### Which scope does an agent need to organize files?

`files:write`. With it an agent creates folders, moves and renames files
and folders, and sets details and tags. `files:read` is enough to list,
search and read.

More: [Folders, moving and finding, Who can do what](../files/organizing.md#who-can-do-what)

### What does `EMAIL_NOT_VERIFIED` mean on a file move?

A credential's move would make files public, and its member's email is not
verified. Verify the email address.

More: [Folders, moving and finding, Errors](../files/organizing.md#errors)

### Can a folder be created and a file moved into it in one API call?

No. Create the folder with `POST W/folders`, then move the file with a
`PATCH` that names the new folder's ID in `folderID`.

More: [Folders, moving and finding, Worked example: make a folder and move a file into it](../files/organizing.md#worked-example-make-a-folder-and-move-a-file-into-it)

### Can I move many files in one API request?

No. A file is moved by a `PATCH` of that file, with its own
`expectedLockVersion`. Move the files one request each.

More: [Folders, moving and finding, Requests and answers](../files/organizing.md#requests-and-answers)

## What organizing does not do

### Can I add comments or notes to a file for my team?

No. There are no comments on files. A file has a description, a caption,
alt text, tags and field values, which everyone who can open the file
sees.

More: [Folders, moving and finding, Details: description, caption, alt text](../files/organizing.md#details-description-caption-alt-text)

### Can I hide a folder from some members of the workspace?

No. Every member of the workspace can list its folders and files. To keep
files apart from some people, use another workspace.

More: [Folders, moving and finding, Who can do what](../files/organizing.md#who-can-do-what)

### Can I set permissions on a single folder?

No. In a workspace every member works with every folder. A folder's
general access only decides whether anyone with the link can open it.

More: [Folders, moving and finding, Who can do what](../files/organizing.md#who-can-do-what)

### Are there smart folders or collections that gather files automatically?

No. A file sits in exactly one folder. To gather files across folders,
use tags, filters or your favorites.

More: [Folders, moving and finding, Folders](../files/organizing.md#folders)

### Can I pin a folder to the top of the listing?

No. Folders are always listed by name. Add the folder to your favorites to
reach it from the navigation.

More: [Folders, moving and finding, Favorites](../files/organizing.md#favorites)
