# Uploading files: questions and answers

Short answers about bringing files into Talewright: every way to upload,
each accepted file type, the checks and the malware scan, the upload tray,
rejected uploads, duplicates, previews, video and uploading through the
API. Each answer links to the section of [Uploading](../files/uploading.md)
that owns the rule.

## The basics of uploading

### How do I upload a file to Talewright?

Open Files & Assets, choose "Upload" at the top of the file browser, then
"Files", and pick one or more files. You can also drag files from your
computer onto the browser. Each file shows in the upload tray until it
reads "Ready".

More: [Uploading, Where you upload](../files/uploading.md#where-you-upload)

### Where does a file go when I upload it?

Into the folder you have open. When no folder is open, it goes to the top
level of the workspace or organization folder you are in.

More: [Uploading, Where you upload](../files/uploading.md#where-you-upload)

### Who can upload files to a workspace?

Every member of the workspace. That includes the organization's owners and
admins, who reach every workspace.

More: [Uploading, Who can do what](../files/uploading.md#who-can-do-what)

### Do I need a verified email address to upload files?

No. No verified email is needed to upload.

More: [Uploading, Who can do what](../files/uploading.md#who-can-do-what)

### When does an upload become a file?

When every check has passed: size, type, whether the file opens, and the
malware scan. Until then nobody can open the bytes and no file exists. A
file never shows in a listing while it is still being sent or checked.

More: [Uploading, The three steps](../files/uploading.md#the-three-steps)

### Does Talewright compress or convert the files I upload?

No. The bytes are stored exactly as they were sent. Nothing is stripped,
converted or recompressed. Thumbnails and previews are made beside the
original, never instead of it.

More: [Uploading, The three steps](../files/uploading.md#the-three-steps)

### Does uploading a photo remove its metadata?

No. Nothing is stripped from an upload. The file is stored byte for byte
as you sent it.

More: [Uploading, The three steps](../files/uploading.md#the-three-steps)

### What name does an uploaded file get?

The name it has on your computer, extension included. You can rename it
afterwards.

More: [Uploading, What a new file starts with](../files/uploading.md#what-a-new-file-starts-with)

### Does an uploaded file start with a description, tags or alt text?

No. A new file has no description, no caption, no alt text and no tags.
Add them on the file's page after the upload.

More: [Uploading, What a new file starts with](../files/uploading.md#what-a-new-file-starts-with)

### Can I add tags or a description while I upload?

No. An upload carries the file's name, size, type and folder, nothing
else. Add details on the file's page once the upload is "Ready".

More: [Uploading, What you declare when starting](../files/uploading.md#what-you-declare-when-starting)

### Which status does a newly uploaded file have?

The organization's default status, when one is set. Otherwise the file has
no status.

More: [Uploading, What a new file starts with](../files/uploading.md#what-a-new-file-starts-with)

### Is a file public as soon as I upload it?

No. A new file is never public at once. The default status never allows
public use, and a file without a status is never public. An owner or admin
decides what becomes public.

More: [Uploading, What a new file starts with](../files/uploading.md#what-a-new-file-starts-with)

### Is it recorded who uploaded a file?

Yes. The person who uploaded a file is recorded as its creator, and every
version in the file's history names who uploaded it.

More: [Uploading, What a new file starts with](../files/uploading.md#what-a-new-file-starts-with)

### Which version number does a new upload get?

Version 1, with the size, type and SHA-256 digest of its bytes.

More: [Uploading, What a new file starts with](../files/uploading.md#what-a-new-file-starts-with)

### Does an upload make a new file or a new version?

Either. An ordinary upload makes a new file. An upload started with
"Replace file" on a file's page adds a new version to that file.

More: [Uploading, Summary](../files/uploading.md#summary)

### Can one upload create more than one version?

No. One upload makes at most one version, however often it is completed or
retried behind the scenes.

More: [Uploading, The three steps](../files/uploading.md#the-three-steps)

### Can I upload several files at the same time?

Yes. Pick several files in the file picker, or drag several onto the
browser. The app sends three at a time, in the order they were chosen, and
the rest read "Waiting".

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### Is there a limit on how many files I can upload in one go?

No such limit is set. Every chosen file is queued in the upload tray, and
three are sent at a time.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### Does the app check the file size and type before it uploads?

No. The app never checks size or type itself. Every file is offered to the
server, which answers at once for a file that is too large or of the wrong
type. No bytes are sent for those.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### Does the folder listing refresh by itself after an upload?

Yes. When a file becomes ready, the folder listing updates by itself.

More: [Uploading, Uploads and navigation](../files/uploading.md#uploads-and-navigation)

### How do I know which files I am allowed to upload?

An empty folder or an empty top level says it: "Images, raw photos, design
files, PDF, video, fonts, CSV, Word, Excel, Markdown and text up to 50 GiB
(images, PDF, Word, Excel and Figma up to 2 GiB)." The full list is 35 types
with 42 extensions.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

## Ways to upload in the app

### What is in the "Upload" menu?

Two items: "Files" and "Folder". "Files" opens your system's file picker
for one or more files. "Folder" opens your system's folder picker.

More: [Uploading, Where you upload](../files/uploading.md#where-you-upload)

### Can I drag and drop files into Talewright?

Yes. Drag files or folders from your computer onto the file browser. While
you drag, the browser dims and shows "Drop files to upload" and "to
{name}", the place the files will land.

More: [Uploading, Where you upload](../files/uploading.md#where-you-upload)

### Can I drop a file straight onto a folder to upload into it?

Yes. Dropping on a folder's row uploads into that folder: the row is
highlighted and the message names it. Dropping on the open area uploads
into the folder you have open.

More: [Uploading, Where you upload](../files/uploading.md#where-you-upload)

### Can I upload from the right-click menu?

Yes. A right-click on empty space in the browser offers "New folder",
"Upload files" and "Upload folder".

More: [Uploading, Where you upload](../files/uploading.md#where-you-upload)

### Can I start an upload from the command palette?

Yes. While the file browser is open, the command palette offers "Upload
files" and "Upload folder".

More: [Uploading, Where you upload](../files/uploading.md#where-you-upload)

### Can I paste an image from the clipboard to upload it?

No. Files are uploaded with the "Upload" button, a right-click, the
command palette or drag and drop. Save the image as a file first.

More: [Uploading, Where you upload](../files/uploading.md#where-you-upload)

### Does the file picker only show files I can upload?

No. The picker only suggests the accepted extensions. The server decides:
a file of another type is refused when the upload starts.

More: [Uploading, Where you upload](../files/uploading.md#where-you-upload)

### Why do I see no "Upload" button?

You are in the organization folder and you are not an owner or admin of the
organization. Uploading is offered to everyone in a workspace, and only to
owners and admins in the organization folder.

More: [Uploading, Where you upload](../files/uploading.md#where-you-upload)

### Can I upload to a workspace while I am looking at the organization folder?

No. Open the workspace from the folder tree first, then upload there. The
organization folder lists no workspaces.

More: [Uploading, Where you upload](../files/uploading.md#where-you-upload)

### Can I upload into a folder without opening it first?

Yes. Drag the files onto the folder's row in the browser.

More: [Uploading, Where you upload](../files/uploading.md#where-you-upload)

### What does "Drop files to upload" mean?

You are dragging files over the file browser. Letting go uploads them to
the place named under it, "to {name}": the folder you have open, or the
folder's row you hold them over.

More: [Uploading, Where you upload](../files/uploading.md#where-you-upload)

### Why does the drop message say "Anyone with the link can open files here once their status allows public use."?

The folder you are about to drop into is public, itself or through a
folder above it. The upload is not public at once: it starts with the
default status or none. It becomes public when an owner or admin gives it
a status that allows public use.

More: [Uploading, Where you upload](../files/uploading.md#where-you-upload)

### Does the drop message warn me about duplicates?

No. A browser cannot read files while you still hold them. Once you let
go, the upload's row in the tray says "Already exists" with "Already in
{place} as {name}" for a file that is already there, and asks whether to
skip it or keep both.

More: [Uploading, The "Already in ..." notice](../files/uploading.md#the-already-in--notice)

### Can I email a file into Talewright?

No. Files come in through the app's upload controls or through the API.

More: [Uploading, Summary](../files/uploading.md#summary)

### Can I upload a hidden file whose name starts with a dot?

Not from the app. Files and folders whose names start with a dot, such as
`.DS_Store`, are skipped without a message. That also applies to single
files chosen with "Files" or dropped.

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

## Uploading a folder

### How do I upload a whole folder with its subfolders?

Choose "Upload" > "Folder", choose "Upload folder" from a right-click or
the command palette, or drag the folder onto the browser. All three work
the same way.

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

### Does uploading a folder keep its folder structure?

Yes. The folder itself is recreated under the open folder, or under the
folder you dropped on, with its subfolders. Each file is uploaded into its
own folder.

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

### What happens when I upload a folder and one with the same name is already there?

The existing folder is reused and filled. Names are compared ignoring
case. Nothing in the existing folder is replaced.

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

### What happens if I upload the same folder twice?

You get one folder with every file in it twice. The existing folder is
reused, and files are never merged by name.

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

### Are empty folders created when I upload a folder?

No. Only folders that hold at least one file to upload are created.

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

### Is `.DS_Store` uploaded when I drop a folder from a Mac?

No. Files and folders whose names start with a dot are skipped without a
message.

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

### In which order are the folders and files of a folder upload created?

Files at the top of the chosen folder are queued in the upload tray at
once. Folders are created a level at a time, parents before children, and
each folder's files are queued as soon as that folder exists, so sending
starts before the whole tree is made.

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

### What happens when a folder I upload cannot be created?

The app says "Could not create {path}. {reason} Nothing in it was
uploaded." Everything inside that folder is skipped. The rest of the
upload continues.

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

### Why were some subfolders skipped when I uploaded a deep folder?

Folders nest at most 16 levels deep. A subfolder that would go deeper
cannot be created, and nothing in it is uploaded. The app names each such
folder with the reason "Folders nest at most 16 levels deep."

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

### What happens to files of an unaccepted type inside a folder I upload?

Each one is refused on its own row of the upload tray, as "Rejected: This
type of file cannot be uploaded". The accepted files in the folder are
uploaded.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### Can I upload a folder into a folder?

Yes. The uploaded folder is recreated under the folder you have open, or
under the folder you dropped it on.

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

### Can I drop several folders at once?

Yes. Files and folders can be dropped together. Each dropped folder is
recreated with its subfolders.

More: [Uploading, Where you upload](../files/uploading.md#where-you-upload)

### Is a folder name with a slash accepted when I upload a folder?

No. That folder cannot be created, with the reason "Enter a name of 1 to
200 characters without a slash." Nothing in it is uploaded.

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

## Image types you can upload

### Can I upload JPEG photos?

Yes. JPEG is accepted with the extensions `.jpg` and `.jpeg` and is stored
as `image/jpeg`. The image must decode and stay within the pixel limits.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Is a `.jpeg` file handled differently from a `.jpg` file?

No. Both extensions name the same type, JPEG.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload a `.jfif` or `.jpe` file?

No. JPEG is accepted as `.jpg` and `.jpeg` only. A name with another
extension is refused when the upload starts.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload a PNG?

Yes. `.png` is accepted and stored as `image/png`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload a GIF?

Yes. `.gif` is accepted and stored as `image/gif`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload WebP images?

Yes. `.webp` is accepted and stored as `image/webp`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload AVIF images?

Yes. `.avif` is accepted and stored as `image/avif`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload an SVG logo?

Yes. `.svg` is accepted and stored as `image/svg+xml`. The file must be
UTF-8 text whose root element is `svg`.

More: [Uploading, How the type is decided](../files/uploading.md#how-the-type-is-decided)

### Why was my SVG file rejected?

An SVG must be UTF-8 text and its root element must be `svg`. Text that
starts with any other markup is not an accepted type. An SVG must also
decode and stay within 16,384 pixels a side and 100 million pixels.

More: [Uploading, How the type is decided](../files/uploading.md#how-the-type-is-decided)

### Can I upload a favicon as an `.ico` file?

Yes. `.ico` is accepted and stored as `image/x-icon`. An ICO file is
recognized by its content and not opened further, and it has no preview.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload HEIC photos?

Yes. `.heic` is accepted and stored as `image/heic`. The image must
decode and stay within the pixel limits.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload HEIF images?

Yes. HEIF is accepted with the extensions `.heif` and `.hif` and is stored
as `image/heif`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### My `.heic` file holds HEIF content. Is it rejected?

No. HEIC and HEIF overlap. A `.heic` file may hold HEIF content and the
other way round.

More: [Uploading, How the type is decided](../files/uploading.md#how-the-type-is-decided)

### Can I upload a .psd file?

Yes. Photoshop files are accepted as `.psd` and `.psb` and stored as
`image/vnd.adobe.photoshop`. The file must decode and stay within the
pixel limits.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload a large Photoshop document saved as `.psb`?

Yes, as long as it is at most 2 GiB, the limit for images, has at most
16,384 pixels a side and at most 100 million pixels.

More: [Uploading, Verification](../files/uploading.md#verification)

### Can I upload a TIFF image?

No. Plain TIFF images are refused. Among TIFF-based files only the raw
photo formats are accepted.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload a BMP image?

No. BMP is not among the accepted types. The accepted image types are
JPEG, PNG, GIF, WebP, AVIF, SVG, ICO, HEIC, HEIF and Photoshop.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

## Raw photos you can upload

### Can I upload raw photos from my camera?

Yes, in these formats: Adobe DNG (`.dng`), Canon (`.cr2`, `.cr3`), Nikon
(`.nef`), Sony (`.arw`), Fujifilm (`.raf`), Olympus (`.orf`) and Panasonic
(`.rw2`).

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload a DNG file?

Yes. `.dng` is accepted and stored as `image/x-adobe-dng`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload Canon CR2 files?

Yes. `.cr2` is accepted and stored as `image/x-canon-cr2`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload Canon CR3 files?

Yes. `.cr3` is accepted and stored as `image/x-canon-cr3`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload Nikon NEF files?

Yes. `.nef` is accepted and stored as `image/x-nikon-nef`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload Sony ARW files?

Yes. `.arw` is accepted and stored as `image/x-sony-arw`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload Fujifilm RAF files?

Yes. `.raf` is accepted and stored as `image/x-fuji-raf`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload Olympus ORF files?

Yes. `.orf` is accepted and stored as `image/x-olympus-orf`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload Panasonic RW2 files?

Yes. `.rw2` is accepted and stored as `image/x-panasonic-rw2`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload raw photos in a format that is not on the list?

No. Only `.dng`, `.cr2`, `.cr3`, `.nef`, `.arw`, `.raf`, `.orf` and `.rw2`
are accepted as raw photos. Every other extension is refused.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Are raw photos checked for their pixel size when I upload them?

No. Raw photos are recognized by their content and not opened further.
The pixel limits apply to JPEG, PNG, GIF, WebP, AVIF, SVG, HEIC, HEIF and
Photoshop files.

More: [Uploading, Verification](../files/uploading.md#verification)

### Can I rename a TIFF to `.dng` to get it uploaded?

No. The content is read, and a plain TIFF named `.dng` is rejected with
`TYPE_NOT_ALLOWED`. Only real raw photos are accepted among TIFF-based
files.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

## Design files you can upload

### Can I upload Adobe Illustrator files?

Yes. `.ai` is accepted and stored as `application/illustrator`. An
Illustrator file may be PDF-based or PostScript-based. Both are accepted.

More: [Uploading, How the type is decided](../files/uploading.md#how-the-type-is-decided)

### Can I upload an EPS file?

Yes. EPS is accepted with the extensions `.eps` and `.epsf` and is stored
as `application/postscript`. The file must be EPS: other PostScript named
`.eps` is rejected.

More: [Uploading, How the type is decided](../files/uploading.md#how-the-type-is-decided)

### Can I upload InDesign documents?

Yes. `.indd` is accepted and stored as `application/x-indesign`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload a Figma file?

Yes. A `.fig` file is accepted and stored as `application/x-figma`. It
must really be a Figma file: the content is checked.

More: [Uploading, How the type is decided](../files/uploading.md#how-the-type-is-decided)

### Can I upload a Sketch file?

No. `.sketch` is not among the accepted types. The accepted design files
are Illustrator, EPS, InDesign and Figma.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload an Adobe XD file?

No. `.xd` is not among the accepted types. The accepted design files are
Illustrator, EPS, InDesign and Figma.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload a PostScript file that is not EPS?

Only as an Illustrator file. PostScript that is not EPS is rejected when
it is named `.eps`. A PostScript-based Illustrator file is accepted as
`.ai`.

More: [Uploading, How the type is decided](../files/uploading.md#how-the-type-is-decided)

## Fonts you can upload

### Can I upload font files?

Yes: WOFF (`.woff`), WOFF2 (`.woff2`), TrueType (`.ttf`) and OpenType
(`.otf`).

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload a WOFF2 web font?

Yes. `.woff2` is accepted and stored as `font/woff2`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload a WOFF font?

Yes. `.woff` is accepted and stored as `font/woff`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload a TTF font?

Yes. `.ttf` is accepted and stored as `font/ttf`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload an OTF font?

Yes. `.otf` is accepted and stored as `font/otf`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload an EOT font?

No. `.eot` is not among the accepted types. The accepted fonts are WOFF,
WOFF2, TrueType and OpenType.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload a font collection as `.ttc`?

No. `.ttc` is not among the accepted extensions. The accepted fonts are
`.woff`, `.woff2`, `.ttf` and `.otf`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

## Video types you can upload

### Which video formats can I upload?

MP4 (`.mp4`, `.m4v`), WebM (`.webm`) and QuickTime (`.mov`, `.qt`). A
video must hold a video stream of at most 16,384 pixels a side.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload an MP4 video?

Yes. `.mp4` and `.m4v` are accepted and stored as `video/mp4`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload an `.m4v` file?

Yes. `.m4v` is an extension of the MP4 type and is stored as `video/mp4`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload a WebM video?

Yes. `.webm` is accepted and stored as `video/webm`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload a MOV file?

Yes. QuickTime is accepted with the extensions `.mov` and `.qt` and is
stored as `video/quicktime`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload an MKV video?

No. Matroska video (`.mkv`) is refused, also when it is named `.webm`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload an AVI or WMV video?

No. Neither is among the accepted types. The accepted video types are
MP4, WebM and QuickTime.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Why was my QuickTime movie named `.mp4` rejected?

Its content is QuickTime, which is another accepted type than the name
claims, so it is rejected with `TYPE_MISMATCH`. Name it `.mov`.

More: [Uploading, How the type is decided](../files/uploading.md#how-the-type-is-decided)

### Can I upload an MP4 that holds only sound?

No. A video must hold a video stream. A `.mp4` with only sound is
rejected, with `MEDIA_INVALID` or `TYPE_NOT_ALLOWED` depending on how the
file is built.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### Can I upload audio files such as MP3 or WAV?

No. No audio type is among the accepted types.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload a video without sound?

Yes. A video needs a video stream, not sound.

More: [Uploading, Video playback](../files/uploading.md#video-playback)

## Documents you can upload

### Can I upload a PDF?

Yes. `.pdf` is accepted and stored as `application/pdf`. The PDF must open
and may have at most 500 pages.

More: [Uploading, Verification](../files/uploading.md#verification)

### Can I upload a Word document?

Yes, as `.docx`. The older `.doc` format is refused.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload an Excel spreadsheet?

Yes, as `.xlsx`. The older `.xls` format is refused.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload a PowerPoint presentation?

No. Neither `.ppt` nor `.pptx` is among the accepted types.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload a CSV file?

Yes. `.csv` is accepted and stored as `text/csv`. The file must be UTF-8
text and must hold more than blank space.

More: [Uploading, How the type is decided](../files/uploading.md#how-the-type-is-decided)

### Why was my CSV file rejected?

A CSV file must be UTF-8 text. A CSV in an older encoding with accented
letters is rejected with `TYPE_NOT_ALLOWED`, and so is a CSV that is empty
of anything but blank space. Save it as UTF-8, or upload it as `.txt`.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### Can I upload Markdown files?

Yes. `.md` and `.markdown` are accepted and stored as `text/markdown`. Any
content that reads as text passes.

More: [Uploading, How the type is decided](../files/uploading.md#how-the-type-is-decided)

### Can I upload a plain text file?

Yes. `.txt` is accepted and stored as `text/plain`. Any content that reads
as text passes: UTF-8, text in an older 8-bit encoding and UTF-16 with a
byte order mark.

More: [Uploading, How the type is decided](../files/uploading.md#how-the-type-is-decided)

### Does a text file have to be UTF-8 to be uploaded?

No, not as `.txt`, `.md` or `.markdown`. Text in an older 8-bit encoding
and UTF-16 with a byte order mark pass too. CSV and SVG files must be
UTF-8.

More: [Uploading, How the type is decided](../files/uploading.md#how-the-type-is-decided)

### Can I upload an HTML file?

No. HTML is refused.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload a JSON or XML file?

No. Neither `.json` nor `.xml` is among the accepted extensions. The
accepted documents are PDF, CSV, Word, Excel, Markdown and plain text.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload an RTF or OpenDocument file?

No. Neither is among the accepted types. The accepted documents are PDF,
CSV, Word (`.docx`), Excel (`.xlsx`), Markdown and plain text.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload Keynote, Pages or Numbers files?

No. None of them is among the accepted types.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload an old `.doc` or `.xls` file?

No. Older Office formats such as `.doc`, `.xls` and `.ppt` are refused.
Word is accepted as `.docx` and Excel as `.xlsx`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

## Types that are not accepted

### Can I upload a ZIP archive to Talewright?

No. Archives such as `.zip` are refused. Upload the files themselves, or
upload a folder: the app recreates its structure.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload a RAR or 7z archive?

No. Archives are refused.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Does Talewright unpack a ZIP after upload?

No. A ZIP cannot be uploaded at all. To bring in many files with their
folders, upload the folder.

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

### Can I upload an `.exe` or another program?

No. Programs such as `.exe` are refused.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload JavaScript or CSS files?

No. Neither `.js` nor `.css` is among the accepted extensions.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Can I upload a file that has no extension?

No. The extension decides the type, and a name such as `README` has none.
The upload is refused with `415 UNSUPPORTED_MEDIA_TYPE`.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### Can I rename a ZIP to `.docx` to get it uploaded?

No. Word, Excel and Figma files are containers, and a container that is
none of the three is rejected with `TYPE_NOT_ALLOWED`, whatever it is
named.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### Can an owner or admin allow more file types for the organization?

No. The list of accepted types is the same for everyone: 35 types with 42
extensions. Everything else is refused.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Is the list of accepted types different in the organization folder?

No. The same checks apply to uploads into a workspace and into the
organization folder.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

## How the file type is decided

### How does Talewright decide what type an uploaded file is?

Twice. When the upload starts, the extension of the file's name names the
type. During verification the content is read and must be the type the
extension claims.

More: [Uploading, How the type is decided](../files/uploading.md#how-the-type-is-decided)

### Does the case of a file extension matter when I upload?

No. Upper and lower case do not matter: `Photo.JPG` is accepted as a
JPEG.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Which extension counts for a file named `logo.svg.png`?

The last one. `logo.svg.png` is treated as a PNG.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### Can I rename a file to another extension to get it accepted?

No. The content is read during verification. Content of another accepted
type is rejected with `TYPE_MISMATCH`, and content of no accepted type
with `TYPE_NOT_ALLOWED`.

More: [Uploading, How the type is decided](../files/uploading.md#how-the-type-is-decided)

### What happens when I upload a PNG that is named `photo.jpg`?

The upload is rejected with `TYPE_MISMATCH`: the bytes are another
accepted type than the name claims. The tray reads "Rejected: Contents do
not match the file extension". Rename it `photo.png` and upload it again.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### What happens when an HTML page is named `banner.png` and uploaded?

The upload is rejected with `TYPE_NOT_ALLOWED`: the bytes are no accepted
type. The tray reads "Rejected: Contents are not an allowed file type".

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### What is the difference between `TYPE_MISMATCH` and `TYPE_NOT_ALLOWED` on an upload?

`TYPE_MISMATCH` means the content is another accepted type than the name
claims: give the file its real extension. `TYPE_NOT_ALLOWED` means the
content is no accepted type at all.

More: [Uploading, How the type is decided](../files/uploading.md#how-the-type-is-decided)

### Can I upload an SVG as a `.txt` file?

Yes. It reads as text, so it is accepted as plain text. It is then stored
and served as text, not as an image.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### Can I upload a JPEG renamed to `notes.txt`?

No. The bytes are an image, not text. The upload is rejected with
`TYPE_MISMATCH`.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### Is a text file that looks like a table accepted as `.txt`?

Yes. Any content that reads as text passes as `.txt` or `.md`, including
text that looks like a table and text that starts with markup.

More: [Uploading, How the type is decided](../files/uploading.md#how-the-type-is-decided)

### Can I upload binary data as a `.md` file?

No. Binary content does not read as text. A file with random binary
content named `data.md` is rejected with `TYPE_NOT_ALLOWED`.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### What happens when a Figma file is named `design.docx`?

The upload is rejected with `TYPE_MISMATCH`. Its content is Figma, which
is another accepted type than the name claims.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### Which type is stored for a file after it is uploaded?

The type its extension names, once the bytes were confirmed to be that
type. An SVG uploaded as `icon.txt`, for example, is stored and served as
text, not as an image.

More: [Uploading, How the type is decided](../files/uploading.md#how-the-type-is-decided)

## File size when uploading

### How large can a file be when I upload it in the app?

50 GiB, which is 53,687,091,200 bytes, on every plan. Images, PDFs, Word,
Excel and Figma files are at most 2 GiB. A larger file is refused when the
upload starts, and the tray reads "Rejected: Larger than the 50 GiB limit"
or "Rejected: Larger than the 2 GiB limit".

More: [Uploading, Size limits](../files/uploading.md#size-limits)

### What does "Rejected: Larger than the 50 GiB limit" mean?

The file is over the size limit of one upload. It was refused before any
byte was sent. Upload a smaller file.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### Why is my 3 GiB image refused when videos go up to 50 GiB?

Checking an image, a PDF, a Word, Excel or Figma file means opening the
whole file, so these are limited to 2 GiB. The tray reads "Rejected: Larger
than the 2 GiB limit". Videos, raw photos, Illustrator, EPS, InDesign,
fonts, CSV, Markdown and text go up to 50 GiB.

More: [Uploading, Size limits](../files/uploading.md#size-limits)

### What is the difference between 50 GiB and 50 GB for an upload?

A GiB is 1,073,741,824 bytes. Sizes in listings are in GB of 1,000,000,000
bytes, so the largest file that fits shows there as 53.7 GB.

More: [Uploading, Size limits](../files/uploading.md#size-limits)

### Why does a 53 GB file upload although the limit says 50?

The limit is 50 GiB, which is 53,687,091,200 bytes. Listings count in GB of
1,000,000,000 bytes, so a file of up to 53.7 GB fits.

More: [Uploading, Size limits](../files/uploading.md#size-limits)

### How is a large file sent?

In parts of 16 MiB, four at a time. A part that fails is tried again, so a
dropped connection costs at most the parts on their way.

More: [Uploading, Parts and their addresses](../files/uploading.md#parts-and-their-addresses)

### I reloaded the page while a large file was uploading. Is it lost?

No. The tray shows it as "Interrupted. Choose the same file to resume." with
"Resume". Choose the same file: the app checks its name, size and the bytes
of the parts already sent, and sends only the parts that are not stored yet.
A file that changed since starts over as a new upload. This works for 24 hours after the
upload started, in the same browser.

More: [Uploading, Uploads and navigation](../files/uploading.md#uploads-and-navigation)

### Can I upload an empty file?

No. A file is at least 1 byte. The tray reads "Rejected: The file is
empty".

More: [Uploading, Size limits](../files/uploading.md#size-limits)

### What does "Rejected: The file is empty" mean?

The file has no bytes. An empty file cannot be uploaded.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### Is my large file sent before it is refused for its size?

No. The limit is checked when the upload starts, before any byte is sent.

More: [Uploading, Size limits](../files/uploading.md#size-limits)

### Why does a file that is too large and of the wrong type say it is too large?

The size is checked before the type. A 150 MiB `.exe` is refused for its
size, not for its type.

More: [Uploading, What you declare when starting](../files/uploading.md#what-you-declare-when-starting)

### Can I upload a file larger than the limit in several parts?

No. An upload is one file sent in one piece, and a file over the limit is
refused when the upload starts.

More: [Uploading, The three steps](../files/uploading.md#the-three-steps)

### Where does the number in the "Larger than the ... MiB limit" message come from?

From the refusal itself. It states the limit in force in bytes, and the
tray divides that number by 1,048,576 and rounds down.

More: [Uploading, Size limits](../files/uploading.md#size-limits)

### Is the size limit the same for a new file and for a replacement?

Yes. A replacement is an ordinary upload, with the same size limit and the
same checks.

More: [Uploading, Size limits](../files/uploading.md#size-limits)

## Verification and virus scanning

### What is checked when I upload a file?

In this order: that the bytes arrived, that they have the declared size,
that they have the declared SHA-256 when one was declared, that the
content is an accepted type, that it is the type the name claims, that an
image, PDF or video opens within its limits, and that the scan finds no
malware.

More: [Uploading, Verification](../files/uploading.md#verification)

### Does Talewright scan uploads for viruses and malware?

Yes. Every upload is scanned for malware, whatever its type. A file in
which the scan finds something is rejected with `MALWARE` and never
becomes a file.

More: [Uploading, Verification](../files/uploading.md#verification)

### Are all file types scanned for malware, or only some?

All of them. Every upload is scanned, whatever its type.

More: [Uploading, Verification](../files/uploading.md#verification)

### My upload was rejected because it contains malware. What should I do?

Do not upload the file. The malware scan found something in it, so the
upload was rejected and the file was not added.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### Can I retry an upload that was rejected for malware?

No "Retry" is offered. Trying the same bytes again would be refused again.

More: [Uploading, Cancel and retry](../files/uploading.md#cancel-and-retry)

### What happens to a file that fails the malware scan?

It never becomes a file. Its bytes cannot be opened by anyone, through any
link, and they are deleted once the upload's address has expired.

More: [Uploading, Bytes that never became a file](../files/uploading.md#bytes-that-never-became-a-file)

### Can anyone open a file while it is still being verified?

No. Until the checks pass, nobody can open the bytes, and no file exists.

More: [Uploading, Summary](../files/uploading.md#summary)

### What does "Verifying" mean on an upload?

The file was sent and the checks are running. It ends "Ready" or
"Rejected".

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### My upload says it could not be opened or is too large to process. How do I fix it?

Export the file again or make it smaller. The image, PDF or video does
not open, or it is over a limit: 16,384 pixels a side or 100 million
pixels for an image, 500 pages for a PDF.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### Why was my very large image rejected after it uploaded?

An image may have at most 100 million pixels and at most 16,384 pixels a
side. A larger one is rejected with `MEDIA_INVALID`, even when the file is
under the size limit.

More: [Uploading, Verification](../files/uploading.md#verification)

### Why was my long PDF rejected?

A PDF may have at most 500 pages. A PDF with more is rejected with
`MEDIA_INVALID`.

More: [Uploading, Verification](../files/uploading.md#verification)

### Why was my damaged image rejected?

An image must decode. A truncated or damaged image is rejected with
`MEDIA_INVALID`. Export it again and upload the new file.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### Which file types are opened during verification and which are only recognized?

JPEG, PNG, GIF, WebP, AVIF, SVG, HEIC, HEIF, Photoshop, PDF and video
files are opened. ICO files, raw photos, design files, fonts, CSV, Word,
Excel, Markdown and text are recognized by their content and not opened
further.

More: [Uploading, Verification](../files/uploading.md#verification)

### My upload says it could not be checked. Is something wrong with my file?

Not necessarily. Verification could not be finished. Choose "Retry":
uploading the same file again may pass.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### Can an upload stay "Verifying" forever?

No. An upload never stays in verification for good. If the checks cannot
be finished, it is rejected with the reason `INGEST_FAILED`.

More: [Uploading, States](../files/uploading.md#states)

### What happens when the malware scan is temporarily unavailable?

The upload waits in verification and is tried again. If it keeps failing,
the upload is rejected with `INGEST_FAILED`.

More: [Uploading, Verification](../files/uploading.md#verification)

### Can a video be too large in pixels to upload?

Yes. A video must hold a video stream of at most 16,384 pixels a side.

More: [Uploading, Verification](../files/uploading.md#verification)

### What does `MEDIA_INVALID` mean for an upload?

The image, PDF or video does not open, or it is over its limits. A file
that cannot be opened within the time and memory the check allows is
rejected the same way.

More: [Uploading, Verification](../files/uploading.md#verification)

### Which check rejects an upload when several would fail?

The first that fails, in the order the checks run. A file whose content is
no accepted type is rejected with `TYPE_NOT_ALLOWED` before it is scanned.

More: [Uploading, Verification](../files/uploading.md#verification)

## The upload tray

### What is the upload tray?

The tray "Uploads" appears at the bottom of the window as soon as you
upload something. It lists each file with its name and its status, newest
first.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### Which statuses can a file have in the upload tray?

"Waiting", "Uploading", "Verifying", "Still verifying. Look for it in its
folder later.", "Ready", "Rejected: {reason}", "Failed: {reason}" and
"Cancelled".

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### What does "Waiting" mean in the upload tray?

The file is in line. Three files are sent at a time, in the order they
were chosen.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### What does "Uploading" mean in the upload tray?

The file is being sent. The row shows a progress bar.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### What does "Ready" mean in the upload tray?

The upload is a file now. Its name becomes a link, "Open {name}", to the
file's page.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### What does "Cancelled" mean in the upload tray?

You cancelled the upload. No file was made.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### What does "Still verifying. Look for it in its folder later." mean?

The checks did not finish within 10 minutes and the tray stopped following
the upload. The upload is not refused: it becomes a file if the checks
pass.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### Why is there no "Retry" on a row that is still verifying after 10 minutes?

The upload is not refused. It becomes a file if the checks pass, and a
retry would add it twice. The row offers "Dismiss" only.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### What does "{n} in progress" mean at the top of the upload tray?

That many rows are waiting, uploading or verifying.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### What does "All done" mean in the upload tray?

Every row is ready. Nothing is waiting, uploading or verifying.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### What does "{ready} of {total} ready" mean in the upload tray?

Nothing is in progress any more, and some rows are ready while others were
rejected, failed or cancelled, or a row is still verifying.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### What does "None uploaded" mean in the upload tray?

Nothing is in progress and no row is ready. Every upload was rejected,
failed or cancelled.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### How do I open a file straight from the upload tray?

Click its name once the row reads "Ready". The name is a link, "Open
{name}", to the file's page.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### How do I clear finished uploads from the tray?

Choose "Clear finished". It removes every ready, rejected, failed and
cancelled row.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### How do I remove one row from the upload tray?

Use its button "Dismiss {name}". A verifying row and a finished row have
it.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### Does dismissing a row that is "Verifying" stop the upload?

No. It only removes the row. The checks go on, and the file appears in its
folder when they pass.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### Can I hide the upload tray while files upload?

Yes. "Collapse uploads" folds the tray down to its heading. "Expand
uploads" opens it again.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### Does the upload tray cover the last files in the listing?

No. The tray floats over the bottom of the window, and while it is open
the file browser leaves that much room below its last rows, so they scroll
clear of the tray.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### In which order does the upload tray list files?

Newest first.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### In which order are queued files sent?

In the order they were chosen, three at a time.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### How long does the upload tray follow a file that is being verified?

10 minutes. Then the row reads "Still verifying. Look for it in its folder
later." and the tray stops asking about it.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### What does "Replacing {name}" mean on a row of the upload tray?

The upload is a replacement. It adds a new version to the file named in
the line instead of making a new file.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### Does the upload tray show the upload progress of each file?

Yes. A row that reads "Uploading" has a progress bar.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### Does the upload tray show uploads that my colleagues started?

No. The tray lists the uploads you started in this browser page. An upload
belongs to the person who started it.

More: [Uploading, Who can do what](../files/uploading.md#who-can-do-what)

## Rejected and failed uploads

### Where did my rejected file go?

Nowhere. A rejected upload leaves no file, no version and no trace in
listings. Its bytes cannot be opened and are deleted once the upload's
address has expired.

More: [Uploading, Bytes that never became a file](../files/uploading.md#bytes-that-never-became-a-file)

### Why is "Retry" offered on some rows and not on others?

"Retry" is offered on every "Failed" row and on a row that reads
"Rejected: Could not be checked". Any other rejected file would be refused
again with the same bytes.

More: [Uploading, Cancel and retry](../files/uploading.md#cancel-and-retry)

### My upload says the contents do not match the file extension. How do I fix it?

The file is of another type than its name says, for example a PNG named
`.jpg`. Rename it with its real extension and upload it again.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### My upload says the contents are not an allowed file type. What can I do?

The content of the file is no accepted type, whatever its name says.
Upload it in one of the accepted types.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### My file has an accepted extension. Why does it say this type of file cannot be uploaded?

The browser reports a type for the file that does not match its extension.
The upload is refused when the declared type and the extension disagree.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### Why was my upload refused because of its file name?

The name is longer than 200 characters or otherwise breaks the naming
rule: it holds a control character, a `/` or a `\`. Rename the file on
your computer and upload it again.

More: [Uploading, What you declare when starting](../files/uploading.md#what-you-declare-when-starting)

### Why was my upload to the organization folder rejected?

Only owners and admins of the organization upload to the organization
folder. For anyone else the row reads "Rejected: Only organization owners
and admins can change the organization folder."

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### What does "Rejected: You cannot upload here" mean?

The upload was refused in a workspace.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### My upload failed because the connection was lost. Do I have to start over?

Choose "Retry" on the row. It starts a new upload of the same file. The
row reads "Failed: Connection lost" when the network dropped while the
file was on its way.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### My upload failed with "The server had a problem". What now?

Choose "Retry". The message stands for an unexpected failure, not for
something wrong with your file.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### My upload failed because the upload expired. What do I do?

Choose "Retry". The upload was not completed within 24 hours of its start.
A retry starts a new upload of the same file.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### The folder was deleted while my file was uploading. What happens?

It depends on the moment. If the folder was trashed or deleted before the
upload started, the row reads "Rejected: The folder no longer exists". If
it was trashed while the upload was being checked, the file is created at
the top level instead.

More: [Uploading, What a new file starts with](../files/uploading.md#what-a-new-file-starts-with)

### I was signed out while files were uploading. What happens to them?

Signing out ends running transfers and empties the tray. A row whose
session ended reads "Rejected: You were signed out". Files that already
reached "Verifying" finish on the server.

More: [Uploading, Uploads and navigation](../files/uploading.md#uploads-and-navigation)

### What should I do when uploads are paused?

Try again later. New uploads are refused for the time being, and the tray
reads "Failed: Uploads are paused. Try again later". Existing files are
unaffected.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### My upload says it changed while uploading. What happened?

"Rejected: Changed while uploading" means the bytes that arrived do not
have the size or the SHA-256 that was declared when the upload started.
Upload the file again once nothing is writing to it.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### Am I notified by email when an upload is rejected?

No. The upload tray shows the result on the file's row.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

## Duplicates when uploading

### What happens when I upload a file that already exists in Talewright?

Nothing is sent yet. The row in the tray reads "Already exists" with
"Already in {place} as {name}", a link to the other file, and two buttons:
"Skip" cancels the upload, "Keep both" sends it beside the other file. For
a folder of copies, "Skip all" and "Keep all" answer every one at once.

You cannot miss it in a big upload: the tray opens, lists the waiting rows
first and says "{n} need a choice" in its header until you answer.

Files over 256 MiB are sent without this check; the notice appears once
they are ready.

More: [Uploading, The "Already in ..." notice](../files/uploading.md#the-already-in--notice)

### Does Talewright block duplicate uploads?

No. The app asks whether to skip the file or keep both, and keeps both if
you say so. The API never stops an upload for a duplicate; it names the
duplicates in the upload's `duplicates`.

More: [Uploading, Duplicates](../files/uploading.md#duplicates)

### How does Talewright recognize a duplicate upload?

By the bytes, not by the name. Two files are duplicates when their content
is the same.

More: [Uploading, Duplicates](../files/uploading.md#duplicates)

### What does "Already in {place} as {name}" mean?

The same bytes already exist somewhere you can open. `{place}` is the other
file's folder, or its workspace's name, or "Organization folder". `{name}`
is the other file's name.

More: [Uploading, The "Already in ..." notice](../files/uploading.md#the-already-in--notice)

### What happens when I upload a file with the same name as an existing file?

Both files exist. File names need not be unique: uploading `logo.png`
twice into one folder gives two files named `logo.png`. Nothing is
overwritten.

More: [Uploading, What a new file starts with](../files/uploading.md#what-a-new-file-starts-with)

### Does uploading a file with the same name replace the old one?

No. It makes a second file. To put new bytes into an existing file, use
"Replace file" on its page.

More: [Uploading, What a new file starts with](../files/uploading.md#what-a-new-file-starts-with)

### Does Talewright rename my upload when the name is already taken?

No. File names need not be unique, so the new file keeps its name beside
the other one.

More: [Uploading, What a new file starts with](../files/uploading.md#what-a-new-file-starts-with)

### I uploaded the same file twice by mistake. How do I clean up?

Next time, choose "Skip" when the tray says "Already exists". Now, move one
of the two to the trash. To find such pairs later, use Filter >
"Show" > "Duplicates".

More: [Uploading, The "Already in ..." notice](../files/uploading.md#the-already-in--notice)

### Does the duplicate notice look at other workspaces?

Yes, but only at files you can open: files of the same workspace or
organization folder, files of the organization folder, and files of your
other workspaces.

More: [Uploading, Duplicates](../files/uploading.md#duplicates)

### Will the upload tray tell me about a duplicate in a workspace I cannot open?

No. Duplicates only name files you can open.

More: [Uploading, Duplicates](../files/uploading.md#duplicates)

### Is a file in the trash named as a duplicate of my upload?

No. Trashed files are never named as duplicates.

More: [Uploading, Duplicates](../files/uploading.md#duplicates)

### Which duplicate does the "Already in ..." notice name when there are several?

The first one only. Duplicates are ordered: the upload's own workspace or
organization folder first, then the organization folder, then other
workspaces, and within each the oldest file first.

More: [Uploading, The "Already in ..." notice](../files/uploading.md#the-already-in--notice)

### Is the duplicate notice shown on a rejected or cancelled upload?

No. The notice is not shown on rows that were rejected, failed or
cancelled.

More: [Uploading, The "Already in ..." notice](../files/uploading.md#the-already-in--notice)

### How does the app know about a duplicate before the file is sent?

Before sending, the app computes the file's SHA-256 and declares it. If
the same bytes already exist somewhere you can open, the row says so.

More: [Uploading, The "Already in ..." notice](../files/uploading.md#the-already-in--notice)

### Where do I see a file's duplicates after the upload?

On the file's page, in a notice marked "Duplicate" under the file's name.
Each duplicate reads "Same file as {name} in {place}" and links to it.
"Hide" on the notice hides it for you alone.

More: [Uploading, The "Already in ..." notice](../files/uploading.md#the-already-in--notice)

### Are two files with the same name but different content duplicates?

No. Talewright compares files by their bytes, not by their names.

More: [Uploading, Duplicates](../files/uploading.md#duplicates)

## Cancelling and retrying an upload

### How do I cancel an upload in the app?

Choose "Cancel" on its row in the upload tray. "Cancel" is offered on rows
that are waiting or uploading.

More: [Uploading, Cancel and retry](../files/uploading.md#cancel-and-retry)

### Can I cancel an upload that is already "Verifying"?

No. An upload that is being verified cannot be stopped. It ends "Ready" or
"Rejected". If you did not want the file, move it to the trash.

More: [Uploading, Cancel and retry](../files/uploading.md#cancel-and-retry)

### What happens when I cancel a file that is still "Waiting"?

It is stopped before anything is sent.

More: [Uploading, Cancel and retry](../files/uploading.md#cancel-and-retry)

### What happens when I cancel a file that is "Uploading"?

The transfer stops and the upload is cancelled. The row reads "Cancelled"
and no file is made.

More: [Uploading, Cancel and retry](../files/uploading.md#cancel-and-retry)

### I cancelled an upload and the file still appeared. Why?

You cancelled at the very moment the upload was completed. The row then
returns to "Verifying" and may still end "Ready". Move the file to the
trash if you did not want it.

More: [Uploading, Cancel and retry](../files/uploading.md#cancel-and-retry)

### What does "Retry" do in the upload tray?

It starts a new upload of the same file in the same row. The earlier
upload is cancelled.

More: [Uploading, Cancel and retry](../files/uploading.md#cancel-and-retry)

### Can I pause an upload and resume it later?

No. A waiting or uploading row can be cancelled, and a failed row can be
retried. A retry starts a new upload of the whole file.

More: [Uploading, Cancel and retry](../files/uploading.md#cancel-and-retry)

### Does an interrupted upload continue where it stopped?

No. "Retry" starts a new upload of the same file from the beginning.

More: [Uploading, Cancel and retry](../files/uploading.md#cancel-and-retry)

### Can I cancel all uploads at once?

No. There is no single control for that. "Cancel" is offered per row, on
rows that are waiting or uploading.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### I uploaded the wrong file. How do I undo it?

While its row reads "Waiting" or "Uploading", choose "Cancel". Once it is
"Verifying" or "Ready", move the file to the trash.

More: [Uploading, Cancel and retry](../files/uploading.md#cancel-and-retry)

### I uploaded files into the wrong folder. What now?

Move them. Select the files and choose "Move", or drag them onto the right
folder. Nothing needs to be uploaded again.

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

## Uploading and moving around the app

### Can I keep working in Talewright while files upload?

Yes. The tray stays while you move around the app. You can open other
pages, other folders and other tabs inside the app, and the uploads
continue.

More: [Uploading, Uploads and navigation](../files/uploading.md#uploads-and-navigation)

### What happens if I close the browser tab while files are uploading?

Uploads that are still being sent end, and the tray is emptied. Files that
already reached "Verifying" are safe: they finish on the server and appear
in the folder.

More: [Uploading, Uploads and navigation](../files/uploading.md#uploads-and-navigation)

### What happens if I reload the page during an upload?

The same as closing the tab: transfers that are still running stop. They
and the files still waiting come back in the tray as "Interrupted. Choose
the same file to resume.", and files that were "Verifying" still appear in
their folder when the checks pass. For a folder, "Resume all" in the tray
continues every interrupted file at once: choose the same folder again.

More: [Uploading, Uploads and navigation](../files/uploading.md#uploads-and-navigation)

### Why does the browser ask whether I want to leave the page?

A row is still "Waiting" or "Uploading", or a form has unsaved changes.
Leaving would stop those transfers. Rows that are "Verifying" or
"Interrupted" do not make the browser ask.

More: [Uploading, Uploads and navigation](../files/uploading.md#uploads-and-navigation)

### I reloaded the page and the upload tray is empty. Are my files lost?

Not in the browser you used: waiting and sending files come back as
"Interrupted" there, unless its site data was cleared. In another browser
the tray starts empty. Files that had reached "Verifying" finish on the
server and appear in their folder.

More: [Uploading, Uploads and navigation](../files/uploading.md#uploads-and-navigation)

### Do uploads continue when I switch to another tab inside the app?

Yes. Uploads keep running whichever of the app's tabs you look at.

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

### What happens to my uploads if I lose access to the workspace?

Its rows disappear from the tray.

More: [Uploading, Uploads and navigation](../files/uploading.md#uploads-and-navigation)

### Do uploads continue after I close the browser?

No. A transfer runs in the page, so closing the browser ends uploads that
are still being sent. Verification runs on the server and finishes without
the browser.

More: [Uploading, Uploads and navigation](../files/uploading.md#uploads-and-navigation)

## Uploading into public folders

### What happens when I upload a file into a public folder?

The file appears in the folder, restricted, with the default status or
none. It is not public and it is not listed in the folder's public
gallery, until an owner or admin gives it a status that allows public use.

More: [Uploading, What a new file starts with](../files/uploading.md#what-a-new-file-starts-with)

### Can a member upload into a public folder?

Yes. Every member of the workspace can upload there. The upload makes
nothing public: the new file is restricted.

More: [Uploading, What a new file starts with](../files/uploading.md#what-a-new-file-starts-with)

### Why is the file I uploaded into a public folder not in its gallery?

An upload is never public at once. The file is created restricted, with
the default status or none, so the gallery does not list it.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### How does a file I uploaded into a public folder become public?

An owner or admin gives it a status that allows public use.

More: [Uploading, What a new file starts with](../files/uploading.md#what-a-new-file-starts-with)

### Can I choose a status for a file while I upload it?

No. A new file gets the organization's default status, when one is set,
or no status. Owners and admins set another status afterwards.

More: [Uploading, What a new file starts with](../files/uploading.md#what-a-new-file-starts-with)

### What status do new uploads get when the organization has no default status?

None. New files then have no status, and a file without a status is never
public.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

## Uploading to the organization folder

### Which roles can start an upload in the organization folder?

Owners and admins of the organization. Other members read the organization
folder and see no upload controls there.

More: [Uploading, Who can do what](../files/uploading.md#who-can-do-what)

### What happens when a plain member starts an upload in the organization folder?

It is refused. A member who starts an upload in the organization folder gets
`403 FORBIDDEN`. In the app there is no upload control for them.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### Can I drag a file onto the organization folder when I am a member?

No. Uploading to the organization folder is offered to organization owners
and admins only. Upload the file into a workspace instead.

More: [Uploading, Where you upload](../files/uploading.md#where-you-upload)

### Are uploads to the organization folder checked the same way as uploads to a workspace?

Yes. The same three steps, the same accepted types, the same size limit
and the same checks apply.

More: [Uploading, Summary](../files/uploading.md#summary)

### Can I upload one file to a workspace and the organization folder at the same time?

No. An upload goes into one workspace or into the organization folder.
Uploading the same bytes to both gives two independent files, and each names
the other as a duplicate to people who can open both.

More: [Uploading, Duplicates](../files/uploading.md#duplicates)

## Previews after uploading

### When does the thumbnail of an uploaded file appear?

A moment after the file. The thumbnail and the preview are made once the
upload is ready, so a file is listed a moment before its thumbnail
appears.

More: [Uploading, Previews](../files/uploading.md#previews)

### Why does my new file show an icon instead of a thumbnail?

Its thumbnail is still being made, its type has no preview, or the preview
failed. Until a thumbnail is ready, and for types without one, the file
shows its type icon.

More: [Uploading, Previews in the app](../files/uploading.md#previews-in-the-app)

### What format are the thumbnail and the preview that Talewright makes?

Both are WebP images. The thumbnail fits 320 pixels and the preview fits
1,600 pixels.

More: [Uploading, Previews](../files/uploading.md#previews)

### Which file types get no preview at all?

ICO files, fonts, CSV, Word, Excel, Markdown and plain text.

More: [Uploading, Previews](../files/uploading.md#previews)

### Does Talewright preview HEIC photos?

Yes. The preview of a HEIC or HEIF file is the image.

More: [Uploading, Previews](../files/uploading.md#previews)

### Does Talewright show a preview of a Photoshop file?

Yes. For `.psd` and `.psb` the preview is the flattened image the file
holds.

More: [Uploading, Previews](../files/uploading.md#previews)

### Does Talewright show a preview of a raw photo?

Yes, when the file embeds a JPEG: the preview is the largest JPEG the file
embeds. A raw photo that embeds none has no preview.

More: [Uploading, Previews](../files/uploading.md#previews)

### Does Talewright show a preview of an Illustrator file?

Only for a PDF-based `.ai` file: page 1. A PostScript-based `.ai` file has
no preview.

More: [Uploading, Previews](../files/uploading.md#previews)

### Does Talewright show a preview of an EPS file?

Only when the file embeds a preview image. That image is shown. An EPS
without one has no preview.

More: [Uploading, Previews](../files/uploading.md#previews)

### Does Talewright show a preview of an InDesign document?

Only when the file embeds a thumbnail. That thumbnail is shown. An
InDesign file without one has no preview.

More: [Uploading, Previews](../files/uploading.md#previews)

### Does Talewright show a preview of a Figma file?

Yes: the thumbnail the `.fig` file holds.

More: [Uploading, Previews](../files/uploading.md#previews)

### What does the preview of a PDF show?

Page 1.

More: [Uploading, Previews](../files/uploading.md#previews)

### What does the thumbnail of a video show?

One frame, 10% into the video and at most 3 seconds in.

More: [Uploading, Previews](../files/uploading.md#previews)

### Does Talewright show a preview of an SVG?

Yes. The preview of an SVG is the image, made as a WebP.

More: [Uploading, Previews](../files/uploading.md#previews)

### Can I see what a font looks like in Talewright?

No. Fonts have no preview. A font shows its type icon, and its page says
"Preview unavailable".

More: [Uploading, Previews](../files/uploading.md#previews)

### Can I read a Word or Excel file inside Talewright?

No. Word and Excel files have no preview. Download the file to open it.

More: [Uploading, Previews](../files/uploading.md#previews)

### Does Talewright show the content of a CSV, Markdown or text file?

No. These types have no preview. A CSV's page shows "Preview unavailable".

More: [Uploading, Previews in the app](../files/uploading.md#previews-in-the-app)

### Does an ICO file get a thumbnail?

No. ICO has no preview and shows its type icon.

More: [Uploading, Previews](../files/uploading.md#previews)

### What does "Preparing preview" mean?

The preview of the file is still being made. The page checks again every
3 seconds while that goes on.

More: [Uploading, Previews in the app](../files/uploading.md#previews-in-the-app)

### What does the `previewStatus` `pending` mean?

The thumbnail and the preview are being made.

More: [Uploading, Previews](../files/uploading.md#previews)

### What does the `previewStatus` `ready` mean?

The thumbnail and the preview both exist. `thumbnailURL` and `previewURL`
are set.

More: [Uploading, Previews](../files/uploading.md#previews)

### What does the `previewStatus` `unsupported` mean?

The file's type has no preview, or the file embeds none.

More: [Uploading, Previews](../files/uploading.md#previews)

### What does the `previewStatus` `failed` mean?

A preview could not be made from this file. The file itself exists and
downloads as usual.

More: [Uploading, Previews](../files/uploading.md#previews)

### Is a failed preview tried again?

No. A preview that failed is not tried again by itself.

More: [Uploading, Previews](../files/uploading.md#previews)

### Does a failed preview mean my upload failed?

No. Previews are made after the file exists and do not decide whether it
is accepted. A damaged Photoshop file that passes the checks but cannot be
rendered exists as a file with `previewStatus` `failed`.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### Why does my raw photo have no thumbnail?

The preview of a raw photo is the image it embeds. A raw photo that embeds
no JPEG is accepted, and its `previewStatus` is `unsupported`.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### How do I get a thumbnail for a design file that shows none?

The preview comes from what the file embeds. Save the Illustrator file as
PDF-based, or save the EPS or InDesign file with an embedded preview, and
upload it again.

More: [Uploading, Previews](../files/uploading.md#previews)

### What does a file's page show as its preview?

The image "Preview of {name}". For a PDF that is its first page.

More: [Uploading, Previews in the app](../files/uploading.md#previews-in-the-app)

## Video after uploading

### Why does my uploaded video say "Preparing video"?

Its format is one that browsers may not play, so a playback rendition is
being prepared. The original is kept and is what downloads.

More: [Uploading, Video in the app](../files/uploading.md#video-in-the-app)

### What is a playback rendition?

A copy of a video that browsers can play: an MP4 with H.264 video and
stereo AAC audio, at most 1,920 by 1,080 pixels, or 1,080 by 1,920 for a
portrait video. It is only for playing in the app.

More: [Uploading, Video playback](../files/uploading.md#video-playback)

### Which uploaded videos get a playback rendition?

Every QuickTime movie, an MP4 whose video is not 8-bit 4:2:0 H.264 or
whose audio is something other than AAC, and a WebM whose video is not
VP8, VP9 or AV1 or whose audio is something other than Opus or Vorbis.

More: [Uploading, Video playback](../files/uploading.md#video-playback)

### Does an MP4 with H.264 and AAC need to be converted to play?

No. It plays as it is. Its `playbackStatus` is `original`.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### Does an HEVC video play in Talewright?

Yes, through a playback rendition. Not every browser plays HEVC, so an MP4
with HEVC video gets a rendition prepared.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### Does a QuickTime movie play in the app?

Yes, once its playback rendition is ready. Until then its page says
"Preparing video".

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### Does converting a video for playback change my original?

No. The rendition is only for playing in the app. Downloads and public
links always serve the original file.

More: [Uploading, Video playback](../files/uploading.md#video-playback)

### What does "Loading video" mean?

The player is fetching the address it plays from.

More: [Uploading, Video in the app](../files/uploading.md#video-in-the-app)

### What picture does the video player show before I press play?

The video's preview frame, as the player's poster.

More: [Uploading, Video in the app](../files/uploading.md#video-in-the-app)

### What happens when a video stops playing in the app?

The player fetches a fresh address once and continues where it stopped.
If it fails again, the page says "This video cannot play here. Download it
instead."

More: [Uploading, Video in the app](../files/uploading.md#video-in-the-app)

### What does the `playbackStatus` `original` mean?

The original plays as it is, or the file is not a video.

More: [Uploading, Video playback](../files/uploading.md#video-playback)

### What does the `playbackStatus` `pending` mean?

The playback rendition is being prepared.

More: [Uploading, Video playback](../files/uploading.md#video-playback)

### What does the `playbackStatus` `failed` mean?

No playback rendition could be made. The original may still play, and it
still downloads.

More: [Uploading, Video playback](../files/uploading.md#video-playback)

### What happens when a video's playback rendition cannot be made in time?

Its `playbackStatus` becomes `failed`. Preparing takes at most 30 minutes
and yields at most 2 GiB. Past either, no rendition is made.

More: [Uploading, Video playback](../files/uploading.md#video-playback)

### Does a silent video need a playback rendition?

Not for that reason alone. A video without sound needs no rendition
because of its missing audio.

More: [Uploading, Video playback](../files/uploading.md#video-playback)

### Which version of a video plays in the app?

The playback rendition once it is ready. Otherwise the original.

More: [Uploading, Video in the app](../files/uploading.md#video-in-the-app)

## Uploading through the API

### What are the `partURLs` of an upload?

The addresses of the first 100 parts, answered when the upload starts. Each
accepts exactly its part's `sizeBytes`, for 15 minutes. Ask for the others
with `POST .../uploads/{uploadID}/part-urls`.

More: [Uploading, Parts and their addresses](../files/uploading.md#parts-and-their-addresses)

### How do I cut a file into parts?

Every part is `partSizeBytes` long, 16 MiB, except the last, which holds
the rest. Part `n` starts at byte `(n - 1) × partSizeBytes`. A file of up to
16 MiB is one part.

More: [Uploading, Parts and their addresses](../files/uploading.md#parts-and-their-addresses)

### Which headers does a part's `PUT` need?

None but what any HTTP client sends with a body. The address binds the
part's length; send no `Content-Type` and no `Authorization`.

More: [Uploading, Parts and their addresses](../files/uploading.md#parts-and-their-addresses)

### What does `expiresAt` on an upload say?

When a pending upload expires unless completed: 24 hours after it was
started. Each part's address has its own `expiresAt`, 15 minutes after it
was made.

More: [Uploading, States](../files/uploading.md#states)

### Is a part's address a secret?

Yes, for as long as it works. Whoever has it can send that part. It never
lets anyone read anything.

More: [Uploading, Parts and their addresses](../files/uploading.md#parts-and-their-addresses)

### Can someone who has a part's address download my file?

No. The address only accepts bytes. It never lets anyone read anything.

More: [Uploading, Parts and their addresses](../files/uploading.md#parts-and-their-addresses)

### How does a script resume an upload after a crash?

`GET .../uploads/{uploadID}/parts` lists the parts already stored with
their `etag`. Send the missing parts, then complete with every part.

More: [Uploading, Resuming](../files/uploading.md#resuming)

### Which fields are required to start an upload?

`fileName`, `sizeBytes` and `contentType`. Over MCP `requestID` is
required too.

More: [Uploading, What you declare when starting](../files/uploading.md#what-you-declare-when-starting)

### Can I leave `contentType` empty when I start an upload?

Yes. An empty string, or `application/octet-stream`, goes by the extension
alone.

More: [Uploading, What you declare when starting](../files/uploading.md#what-you-declare-when-starting)

### What does "contentType text/html does not match a .png file" mean?

The declared `contentType` does not agree with the extension of
`fileName`. The start is refused with `415 UNSUPPORTED_MEDIA_TYPE`.
Declare the type of the extension, an empty string or
`application/octet-stream`.

More: [Uploading, How the type is decided](../files/uploading.md#how-the-type-is-decided)

### Is `image/png; charset=binary` accepted as the content type of a PNG?

Yes. Anything after a `;` in `contentType` is ignored, and case does not
matter.

More: [Uploading, How the type is decided](../files/uploading.md#how-the-type-is-decided)

### Can I declare a `.csv` upload as `application/vnd.ms-excel`?

Yes. Some systems label CSV files as Excel documents, so that content type
is accepted for a `.csv`.

More: [Uploading, How the type is decided](../files/uploading.md#how-the-type-is-decided)

### Which content types are accepted for an Illustrator upload?

`application/illustrator`, `application/postscript`, `application/pdf` and
`application/vnd.adobe.illustrator`, besides an empty string and
`application/octet-stream`.

More: [Uploading, How the type is decided](../files/uploading.md#how-the-type-is-decided)

### Which content types are accepted for a Photoshop upload?

`image/vnd.adobe.photoshop`, `image/photoshop`, `image/x-photoshop`,
`image/psd`, `application/photoshop`, `application/x-photoshop` and
`application/psd`, besides an empty string and `application/octet-stream`.

More: [Uploading, How the type is decided](../files/uploading.md#how-the-type-is-decided)

### Which content types are accepted for font uploads?

The stored types `font/woff`, `font/woff2`, `font/ttf` and `font/otf`, and
also `application/font-woff`, `application/font-woff2`,
`application/x-font-ttf`, `application/font-sfnt`,
`application/x-font-otf` and `application/vnd.ms-opentype` for the
matching font type.

More: [Uploading, How the type is decided](../files/uploading.md#how-the-type-is-decided)

### Can I declare a Markdown upload as `text/plain`?

Yes. `text/plain` and `text/x-markdown` are accepted for `.md` and
`.markdown`, besides `text/markdown`.

More: [Uploading, How the type is decided](../files/uploading.md#how-the-type-is-decided)

### Can `fileName` contain a folder path such as `folder/logo.png`?

No. That answers `422 VALIDATION_FAILED` on `fileName`. A name must not
contain a path. Put the file in a folder with `folderID`.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### How do I upload a file into a specific folder through the API?

Name the folder in `folderID` when you start the upload. It must be a live
folder of the same workspace or organization folder. Left out, the file goes
to the top level.

More: [Uploading, What you declare when starting](../files/uploading.md#what-you-declare-when-starting)

### What happens when `folderID` names a folder in the trash or in another workspace?

The start answers `422 VALIDATION_FAILED` on `folderID`, the same as for
an unknown ID. A file goes into a live folder of its own workspace or
organization folder.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### In which order are the checks made when an upload starts?

Sign-in, reach of the workspace or organization, the organization folder
role, whether uploads are paused, `fileName`, `sizeBytes`, the size limit,
the type, `sha256`, the fields of a replacement, the file being replaced,
and last `folderID`. The first that fails decides the answer, and no upload
is created.

More: [Uploading, What you declare when starting](../files/uploading.md#what-you-declare-when-starting)

### What happens when I `PUT` fewer or more bytes than a part's `sizeBytes`?

The storage refuses the `PUT` with `403`. Each address accepts exactly its
part's length.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### What happens when I `PUT` a part after its address expired?

The storage refuses with `403`. Ask for a new address with
`POST .../uploads/{uploadID}/part-urls` and send the part again.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### A part's address stopped working while the upload is still `pending`. What do I do?

Ask for a new one with `POST .../uploads/{uploadID}/part-urls`. Past the
upload's `expiresAt`, start a new upload.

More: [Uploading, Worked example](../files/uploading.md#worked-example)

### What do I send when I complete an upload?

`{"parts": [...]}` naming every part from 1 to `partCount` once, each with
the `ETag` its `PUT` answered. The order does not matter.

More: [Uploading, Completing](../files/uploading.md#completing)

### What does completing an upload answer?

`202` with the upload, now in the state `verifying`. The checks start.

More: [Uploading, Completing](../files/uploading.md#completing)

### Is it harmful to complete the same upload twice?

No. Completing an upload that is already `verifying`, `ready` or
`rejected` answers `202` with the upload unchanged. The checks start only
once.

More: [Uploading, Completing](../files/uploading.md#completing)

### What should a script do when the complete call times out?

Send it again. Completing twice is harmless.

More: [Uploading, Worked example](../files/uploading.md#worked-example)

### What does the reason `PARTS_MISSING` mean when I complete an upload?

Some parts were never stored. `details.partNumbers` names them. The upload
stays `pending`: send them and complete again.

More: [Uploading, Completing](../files/uploading.md#completing)

### What does the reason `PART_MISMATCH` mean when I complete an upload?

The storage holds other bytes, or another size, for the parts
`details.partNumbers` names than the `ETag`s you sent. Send those parts
again and complete with the new `ETag`s.

More: [Uploading, Completing](../files/uploading.md#completing)

### What does the reason `OBJECT_MISSING` mean when I complete an upload?

The upload's parts are gone. The message reads "The upload's parts are
gone; start a new upload". Start a new upload.

More: [Uploading, Completing](../files/uploading.md#completing)

### What does the reason `EXPIRED` mean when I complete an upload?

The upload expired. Completing is possible until 5 minutes after
`expiresAt`. After that the message reads "The upload expired; start a new
one".

More: [Uploading, Completing](../files/uploading.md#completing)

### What does the reason `NOT_PENDING` mean on an upload?

You cancelled an upload that is not pending, or you completed a cancelled
one. Start a new upload if you still need one.

More: [Uploading, Errors](../files/uploading.md#errors)

### Can a cancelled upload be completed after all?

No. A cancelled upload can never be completed, even if parts were sent,
and its parts are discarded.

More: [Uploading, Cancelling](../files/uploading.md#cancelling)

### What does cancelling an upload through the API answer?

`204` for a `pending` upload. In any other state it answers `409 CONFLICT`
with reason `NOT_PENDING`.

More: [Uploading, Cancelling](../files/uploading.md#cancelling)

### Does cancelling a `ready` upload remove the file it made?

No. Cancelling a `ready` or `rejected` upload answers `409 CONFLICT` with
reason `NOT_PENDING`, and the file, if any, stays. To remove the file,
move it to the trash.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### Do I have to cancel an upload that I no longer need?

No. A pending upload that is not completed becomes `expired` by itself,
24 hours and 5 minutes after it was started, and its parts are discarded.

More: [Uploading, States](../files/uploading.md#states)

### What does the upload state `pending` mean?

The upload was started. It waits for the parts and for you to complete it.
From there it becomes `verifying`, `cancelled` or `expired`.

More: [Uploading, States](../files/uploading.md#states)

### What does the upload state `verifying` mean?

The upload was completed and the checks are running. It ends `ready` or
`rejected`.

More: [Uploading, States](../files/uploading.md#states)

### What does the upload state `ready` mean?

The checks passed. `fileID` and `versionID` name the file and the version
the upload made. The state is final.

More: [Uploading, States](../files/uploading.md#states)

### What does the upload state `rejected` mean?

The checks refused the bytes. `rejectReason` says why. No file or version
was made, and the state is final.

More: [Uploading, States](../files/uploading.md#states)

### What does the upload state `expired` mean?

The upload was never completed. The state is final: start a new upload.

More: [Uploading, States](../files/uploading.md#states)

### What does the upload state `cancelled` mean?

You cancelled the upload while it was pending. The state is final.

More: [Uploading, States](../files/uploading.md#states)

### What do `completedAt` and `finishedAt` on an upload say?

`completedAt` is set when the upload is completed. `finishedAt` is set
when it reaches a final state.

More: [Uploading, States](../files/uploading.md#states)

### How do I find the file an API upload created?

Read the upload once it is `ready`. `fileID` names the file and
`versionID` the version it made. Both are `null` in every other state.

More: [Uploading, What an upload holds](../files/uploading.md#what-an-upload-holds)

### How often should a script read an upload while it is `verifying`?

Wait a little longer between reads each time, until `state` is `ready` or
`rejected`.

More: [Uploading, Worked example](../files/uploading.md#worked-example)

### How do I fix an upload that was rejected with `SIZE_MISMATCH`?

Declare the exact size and upload again. The bytes that arrived were not
the declared `sizeBytes`.

More: [Uploading, Errors](../files/uploading.md#errors)

### How do I fix an upload that was rejected with `DIGEST_MISMATCH`?

Declare the right digest, or none, and upload again. The bytes did not
have the `sha256` you declared.

More: [Uploading, Errors](../files/uploading.md#errors)

### Should I upload a file again after `INGEST_FAILED`?

Yes. Verification could not be finished, so the same bytes may pass the
next time.

More: [Uploading, Errors](../files/uploading.md#errors)

### Can an upload that was rejected with `MALWARE` still be let through?

No. A file in which the scan finds malware never becomes a file, whoever
uploads it.

More: [Uploading, Errors](../files/uploading.md#errors)

### Do I have to send a `sha256` when I start an upload?

No. It is optional. If you give one, bytes with another digest are
rejected with `DIGEST_MISMATCH`, and duplicates can be named while the
upload is still `pending`.

More: [Uploading, What you declare when starting](../files/uploading.md#what-you-declare-when-starting)

### What does `duplicates` on an upload hold?

Up to 10 other live files in the organization with the same bytes that you
can open. Each has `id`, `name`, `workspaceID` (`null` for the organization
folder), `fileSpaceName` and `folderPath`.

More: [Uploading, Duplicates](../files/uploading.md#duplicates)

### Why is `duplicates` empty while my upload is still `pending`?

While an upload is `pending` or `verifying`, the comparison uses the
`sha256` you declared. Without a declared `sha256` there are no duplicates
yet. Once the upload is `ready`, the stored digest is used.

More: [Uploading, Duplicates](../files/uploading.md#duplicates)

### Does the `duplicates` list of an upload include the file it just made?

No. Once the upload is `ready`, the file the upload made, or the file it
replaced, is left out.

More: [Uploading, Duplicates](../files/uploading.md#duplicates)

### Which duplicates does a credential see on its uploads?

Only files in the workspaces the credential lists, and in the organization
folder.

More: [Uploading, Duplicates](../files/uploading.md#duplicates)

### What is `requestID` for when I start an upload?

It makes the start safe to repeat. The same request with the same
`requestID` within 24 hours returns the upload the first request made
instead of a second one.

More: [Uploading, What you declare when starting](../files/uploading.md#what-you-declare-when-starting)

### What happens when I reuse a `requestID` with a different upload?

The start answers `409 CONFLICT` with reason `REQUEST_REUSED`. A
`requestID` names one request. Use a new one.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### Can I use the same `requestID` for a workspace upload and an organization folder upload?

Yes. Starting an upload in a workspace and in the organization folder are two
operations, and each keeps its own request IDs. The second start answers
`201` with a new upload.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### How do I list my uploads through the API?

`GET .../uploads` lists your own uploads, newest first, 50 a page, or 1 to
100 with `limit`. `active=true` keeps those that are `pending` or
`verifying`.

More: [Uploading, Operations](../files/uploading.md#operations)

### Can an admin see or finish an upload that someone else started?

No. An upload belongs to the person who started it. Nobody else can read,
complete or cancel it, admins included. They get `404 NOT_FOUND`.

More: [Uploading, Who can do what](../files/uploading.md#who-can-do-what)

### Can a key with only `files:read` start an upload?

No. Starting needs `files:write`. The answer is `403 FORBIDDEN` with
reason `INSUFFICIENT_SCOPE`. With `files:read` a key can read and list its
member's uploads.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### Can an API key upload to a workspace it does not list?

No. A credential must list the workspace. It reaches the organization folder
of its own organization.

More: [Uploading, Who can do what](../files/uploading.md#who-can-do-what)

### Can an agent upload into the organization folder?

Only when its credential acts for an owner or admin of the organization.
For any other member the start answers `403 FORBIDDEN`.

More: [Uploading, Who can do what](../files/uploading.md#who-can-do-what)

### Which capability IDs do the upload operations have?

`workspace.uploads.create`, `workspace.uploads.list`,
`workspace.uploads.get`, `workspace.uploads.sign_parts`,
`workspace.uploads.list_parts`, `workspace.uploads.complete` and
`workspace.uploads.cancel`. The organization folder (the API's library) has
the same seven with `library.` in front.

More: [Uploading, Operations](../files/uploading.md#operations)

### Does reading an upload give me part addresses?

No. Only starting it answers `partURLs`. Reading it later answers
`partURLs: null`; ask for addresses with `POST .../uploads/{uploadID}/part-urls`.

More: [Uploading, Parts and their addresses](../files/uploading.md#parts-and-their-addresses)

### What does an upload answer when `sizeBytes` is 0?

`422 VALIDATION_FAILED` on `sizeBytes`. An empty file cannot be uploaded.

More: [Uploading, Edge cases](../files/uploading.md#edge-cases)

### What does `details.limitBytes` hold when an upload is too large?

The size limit in force, in bytes. The start answers `413
PAYLOAD_TOO_LARGE` with it.

More: [Uploading, Size limits](../files/uploading.md#size-limits)

## What uploading does not do

### Is there a desktop app or a sync folder for uploading files?

No. Files are uploaded in the web app or through the API.

More: [Uploading, Summary](../files/uploading.md#summary)

### Can I import files from another cloud storage service in the app?

No. The app uploads files and folders from your computer: you choose them
or drag them in.

More: [Uploading, Where you upload](../files/uploading.md#where-you-upload)

### Is an email sent to my team when I upload a file?

No. No email is sent about an upload. The new file shows in its folder,
and "Recent activity" in the Details pane lists the files changed last.

More: [Uploading, Uploads and navigation](../files/uploading.md#uploads-and-navigation)

### Can someone outside my organization upload files to my workspace?

No. Uploading needs a member of the workspace, or a credential that acts
for one. There is no upload link for outsiders.

More: [Uploading, Who can do what](../files/uploading.md#who-can-do-what)

### Does Talewright convert HEIC photos to JPEG when I upload them?

No. The bytes are stored exactly as they were sent. A preview image is
made beside the original.

More: [Uploading, The three steps](../files/uploading.md#the-three-steps)

### Does Talewright shrink large images when I upload them?

No. Nothing is converted or recompressed. An image over 16,384 pixels a
side or 100 million pixels is rejected, not resized.

More: [Uploading, Verification](../files/uploading.md#verification)
