# Downloading files: questions and answers

Short answers about getting files out of Talewright: downloading one file,
an earlier version, a selection or a folder as a ZIP, what is inside a
ZIP, temporary links and how long they work, and which files open in the
browser instead of saving. Each answer links to the section of
[Downloading](../files/downloading.md) that owns the rule.

## The basics of downloading

### How do I download a file from Talewright?

Open the file's page and choose "Download", above the preview. In a
listing, choose "Download" in the file's menu. The browser saves the file
under its name.

More: [Downloading, Downloading one file](../files/downloading.md#downloading-one-file)

### Is the downloaded file the same as the one that was uploaded?

Yes. Every file downloads exactly as it was uploaded: the stored original,
byte for byte. Nothing is converted or stripped on the way out.

More: [Downloading, Three ways to get a file's bytes](../files/downloading.md#three-ways-to-get-a-files-bytes)

### Who can download a file?

Anyone who can open it: every member of the workspace, and for an
organization folder file every member of the organization. Downloading needs
only the right to read.

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

### Can I let someone see a file but not download it?

No. There is no role or setting that lets someone see a file but not
download it. Whoever can open a file can download it.

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

### Does downloading from the organization folder need an owner or admin?

No. Every member of the organization can download from the organization folder,
although only owners and admins change it.

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

### What are the ways to get a file's bytes out of Talewright?

Three. Through the API, with your session or credential. Through a
temporary link, which works for 10 minutes without a sign-in. Or through a
public link, for as long as the file is public. All three serve the same
bytes.

More: [Downloading, Three ways to get a file's bytes](../files/downloading.md#three-ways-to-get-a-files-bytes)

### Does "Download" give me the thumbnail or the full file?

The full file. Thumbnails and previews are never what "Download" gives
you. Downloads always serve the original.

More: [Downloading, Thumbnails, previews and playback](../files/downloading.md#thumbnails-previews-and-playback)

### What name does a downloaded file have?

The file's current name in Talewright.

More: [Downloading, Downloading through the API](../files/downloading.md#downloading-through-the-api)

### Does downloading a photo strip its metadata?

No. Nothing is converted or stripped on the way out. The bytes are the
stored original.

More: [Downloading, Three ways to get a file's bytes](../files/downloading.md#three-ways-to-get-a-files-bytes)

### Does downloading a video give me the original or the converted copy?

The original. The playback rendition is only for playing in the app. It is
never what "Download" gives you.

More: [Downloading, Thumbnails, previews and playback](../files/downloading.md#thumbnails-previews-and-playback)

### Can I download a file in another format than it was uploaded in?

No. A download is the original file. Resized and reformatted images of a
public file are a separate feature of public links.

More: [Downloading, Thumbnails, previews and playback](../files/downloading.md#thumbnails-previews-and-playback)

### Are downloads logged?

Only ZIP downloads. Asking for a ZIP is recorded in the audit trail, with
the number of folders, files and bytes. Downloads of single files are not
recorded, and neither is making a temporary link.

More: [Downloading, ZIP downloads](../files/downloading.md#zip-downloads)

### Can I see how often a file was downloaded?

No. Downloads of single files are not recorded, so there is no download
count.

More: [Downloading, Signed links](../files/downloading.md#signed-links)

### Can someone outside my organization download a file?

Only with a link: a temporary link someone hands them, which works for 10
minutes, or the public link of a file that is public.

More: [Downloading, Three ways to get a file's bytes](../files/downloading.md#three-ways-to-get-a-files-bytes)

## Downloading one file in the app

### Where is the "Download" button for a file?

On the file's page, above the preview. "Download" is also in the file's
menu in a listing, in the bar "Selected files" and in the command palette.

More: [Downloading, Downloading one file](../files/downloading.md#downloading-one-file)

### Does "Download" in the app open the file in a new tab?

No. The browser saves the file under its name, whatever its type. Nothing
opens in a tab.

More: [Downloading, Downloading one file](../files/downloading.md#downloading-one-file)

### Which version do I get when I download from a listing that is out of date?

The newest. From a listing the app first asks which version is current, so
a file replaced since the listing loaded still downloads as its newest
version.

More: [Downloading, Downloading one file](../files/downloading.md#downloading-one-file)

### Does the "Download" button stop working when a page has been open for hours?

No. The download of a single file needs no temporary link, so the button
works however long the page has been open.

More: [Downloading, Downloading one file](../files/downloading.md#downloading-one-file)

### How does the app download a single file?

Through the API, with your session. It downloads the original of the
current version.

More: [Downloading, Downloading one file](../files/downloading.md#downloading-one-file)

### Why is there no "Download" button on a file in the trash?

A trashed file's page shows no preview and no "Download" button. Restore
the file to download it in the app. Its versions are still listed in
"History".

More: [Downloading, Downloading one file](../files/downloading.md#downloading-one-file)

### Can I download a file that has no preview?

Yes. A file without a preview shows "Preview unavailable" and its type
icon. "Download" works all the same.

More: [Downloading, Looking instead of downloading](../files/downloading.md#looking-instead-of-downloading)

### Can I download a file from the command palette?

Yes. The command palette offers "Download" for the selection or the open
file.

More: [Downloading, Downloading one file](../files/downloading.md#downloading-one-file)

### What happens when I select one file and choose "Download"?

That file downloads as itself, not as a ZIP.

More: [Downloading, Downloading one file](../files/downloading.md#downloading-one-file)

### Can I look at a file without downloading it?

Yes. A file's page shows its preview, the image "Preview of {name}", and a
video's page has a player.

More: [Downloading, Looking instead of downloading](../files/downloading.md#looking-instead-of-downloading)

### Where does my browser save a file I download from Talewright?

Where your browser saves its downloads. The app hands the file to the
browser, which saves it under the file's name.

More: [Downloading, Downloading one file](../files/downloading.md#downloading-one-file)

## Downloading an earlier version

### How do I download an old version of a file?

Open the file's page and look at the "History" section in "Details". Each
version has its own "Download".

More: [Downloading, Downloading an earlier version](../files/downloading.md#downloading-an-earlier-version)

### Can I download all versions of a file at once?

No. Each version has its own "Download" in the "History" section. A ZIP holds
the current version of each file only.

More: [Downloading, What is inside a ZIP](../files/downloading.md#what-is-inside-a-zip)

### Can I get a temporary link to an earlier version?

Yes. A signed link can be asked for any version, and it serves that
version.

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

## Downloading a folder or a selection

### How do I download a whole folder?

Choose "Download" in the folder's menu. You get a ZIP named after the
folder, with the folder's structure inside.

More: [Downloading, Downloading a folder or a selection](../files/downloading.md#downloading-a-folder-or-a-selection)

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

Tick the items and choose "Download" in the bar "Selected files". You get
one ZIP.

More: [Downloading, Downloading a folder or a selection](../files/downloading.md#downloading-a-folder-or-a-selection)

### Can I download files and folders together in one ZIP?

Yes. Files and folders can be mixed in a selection. You get one ZIP named
"{workspace} files" or "Library files".

More: [Downloading, Downloading a folder or a selection](../files/downloading.md#downloading-a-folder-or-a-selection)

### Does the app show the progress of a ZIP download?

No. The ZIP opens as a download in the browser. The app shows no progress
of its own. The browser's download list does.

More: [Downloading, Downloading a folder or a selection](../files/downloading.md#downloading-a-folder-or-a-selection)

### How do I download several organization folder files as a member?

One file or one folder at a time, from its menu. Selecting is offered where
you may change files, and a member may not change the organization folder. A
folder's "Download" still gives you everything in it as one ZIP.

More: [Downloading, Downloading a folder or a selection](../files/downloading.md#downloading-a-folder-or-a-selection)

### Why can't I download my folder as one ZIP?

It is over a limit. A ZIP holds at most 10,000 files, and the files may
add up to at most 20 GiB. Download fewer files at once, for example its
subfolders one by one.

More: [Downloading, ZIP downloads](../files/downloading.md#zip-downloads)

### Can I download everything in a workspace at once?

Yes, as long as it fits in one ZIP: at most 10,000 files and 20 GiB.
Select everything at the top level and choose "Download". Past either
limit, download in parts.

More: [Downloading, ZIP downloads](../files/downloading.md#zip-downloads)

### When are the limits of a ZIP checked?

When you ask, before anything is downloaded. Both the 10,000 files and the
20 GiB are checked then.

More: [Downloading, ZIP downloads](../files/downloading.md#zip-downloads)

### Can I download an empty folder?

Yes. The link is made, and the ZIP holds the empty folder.

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

### What happens when a file in my selection was trashed just before I chose "Download"?

No ZIP is made. Every item you name must exist and be live, and the app
says "Could not download {name}. Try again."

More: [Downloading, Downloading a folder or a selection](../files/downloading.md#downloading-a-folder-or-a-selection)

### Is a ZIP of files prepared in advance?

No. The link is made first, and the ZIP is put together when the link is
opened.

More: [Downloading, Between asking for a ZIP and downloading it](../files/downloading.md#between-asking-for-a-zip-and-downloading-it)

### Can I download files from two workspaces in one ZIP?

No. A ZIP holds items of one workspace or of the organization folder.

More: [Downloading, ZIP downloads](../files/downloading.md#zip-downloads)

## What is inside a ZIP

### How is a downloaded ZIP organized?

Each folder you named sits at the top of the ZIP under its own name, with
the live folders and files below it, arranged as they are in Talewright.
Each file you named by itself sits at the top of the ZIP.

More: [Downloading, What is inside a ZIP](../files/downloading.md#what-is-inside-a-zip)

### Does a ZIP of a folder keep the subfolders?

Yes. The live folders and files below the folder are arranged in the ZIP
as they are in Talewright.

More: [Downloading, What is inside a ZIP](../files/downloading.md#what-is-inside-a-zip)

### Are empty folders included in a ZIP?

Yes. Empty folders are included.

More: [Downloading, What is inside a ZIP](../files/downloading.md#what-is-inside-a-zip)

### Which version of each file is in a ZIP?

The current version, as the original bytes.

More: [Downloading, What is inside a ZIP](../files/downloading.md#what-is-inside-a-zip)

### Are trashed files included in a ZIP of their folder?

No. Trashed files and trashed folders are left out.

More: [Downloading, What is inside a ZIP](../files/downloading.md#what-is-inside-a-zip)

### Is a ZIP from Talewright compressed?

No. Files are stored in the ZIP as they are, without compression. The ZIP
is about as large as the files together.

More: [Downloading, What is inside a ZIP](../files/downloading.md#what-is-inside-a-zip)

### What date do the files inside a ZIP have?

The time each file's current version was uploaded, in UTC.

More: [Downloading, What is inside a ZIP](../files/downloading.md#what-is-inside-a-zip)

### What is a downloaded ZIP called?

For exactly one folder and nothing else, the folder's name, such as `Press
kit.zip`. For anything else, `{workspace name} files.zip` in a workspace
and `Library files.zip` in the organization folder.

More: [Downloading, What is inside a ZIP](../files/downloading.md#what-is-inside-a-zip)

### Why does a file have another name inside the ZIP?

Names inside the ZIP are made safe for every operating system. `/`, `\`,
`:`, `*`, `?`, `"`, `<`, `>`, `|` and control characters in a name become
`_`. The names in Talewright are not changed by this.

More: [Downloading, What is inside a ZIP](../files/downloading.md#what-is-inside-a-zip)

### What happens to two files with the same name in one folder of a ZIP?

They are told apart by a number, which goes before the extension.
`Logo.png` and `logo.PNG` become `Logo.png` and `logo (2).PNG`. Case is
ignored when names are compared.

More: [Downloading, What is inside a ZIP](../files/downloading.md#what-is-inside-a-zip)

### What happens in a ZIP when a file has the same name as a folder beside it?

The file gets the number. A file `Logos` beside a folder `Logos` becomes
`Logos (2)`.

More: [Downloading, What is inside a ZIP](../files/downloading.md#what-is-inside-a-zip)

### Does a file appear twice in a ZIP when I select it and its folder?

No. A file you named that is also inside a folder you named appears once,
in its folder.

More: [Downloading, What is inside a ZIP](../files/downloading.md#what-is-inside-a-zip)

### What happens when I select a folder and one of its subfolders for a ZIP?

The subfolder appears once, in its place inside the other folder.

More: [Downloading, What is inside a ZIP](../files/downloading.md#what-is-inside-a-zip)

### What happens to spaces and dots at the end of a name inside a ZIP?

Spaces at the start, and dots and spaces at the end, are removed. A name
that is `.` or `..`, or has nothing left, becomes `_`.

More: [Downloading, What is inside a ZIP](../files/downloading.md#what-is-inside-a-zip)

### Does downloading a ZIP rename my files in Talewright?

No. Only the names inside the ZIP are made safe. The names in Talewright
stay as they are.

More: [Downloading, What is inside a ZIP](../files/downloading.md#what-is-inside-a-zip)

### Does a ZIP include thumbnails, descriptions or tags?

No. A ZIP holds the files themselves, each as the original bytes of its
current version, in their folders.

More: [Downloading, What is inside a ZIP](../files/downloading.md#what-is-inside-a-zip)

### What do `fileCount` and `sizeBytes` say about a ZIP?

`fileCount` is the number of files in the ZIP. `sizeBytes` is the total
size of those files. The ZIP itself is slightly larger.

More: [Downloading, ZIP downloads](../files/downloading.md#zip-downloads)

## Between asking for a ZIP and downloading it

### Is a file that was added after I asked for the ZIP included?

No. The ZIP holds the files that were counted when you asked, and no
others.

More: [Downloading, Between asking for a ZIP and downloading it](../files/downloading.md#between-asking-for-a-zip-and-downloading-it)

### What happens to a ZIP when a file in it is replaced before I download?

The file downloads as its new current version.

More: [Downloading, Between asking for a ZIP and downloading it](../files/downloading.md#between-asking-for-a-zip-and-downloading-it)

### What happens to a ZIP when a file in it is renamed before I download?

The file has its new name in the ZIP.

More: [Downloading, Between asking for a ZIP and downloading it](../files/downloading.md#between-asking-for-a-zip-and-downloading-it)

### Can I open a ZIP link more than once?

Yes, within its 10 minutes. Each time gives the ZIP as things are at that
moment.

More: [Downloading, Between asking for a ZIP and downloading it](../files/downloading.md#between-asking-for-a-zip-and-downloading-it)

### Can a ZIP download be incomplete without my noticing?

No. If something goes wrong while the ZIP is being sent, the download
fails. You never get a ZIP that looks complete but is missing files.

More: [Downloading, Between asking for a ZIP and downloading it](../files/downloading.md#between-asking-for-a-zip-and-downloading-it)

### What makes a ZIP link stop working?

Its 10 minutes are over, or the workspace or organization is deleted. It
then answers `403`.

More: [Downloading, Between asking for a ZIP and downloading it](../files/downloading.md#between-asking-for-a-zip-and-downloading-it)

### Does a ZIP link need a sign-in?

No. It works for 10 minutes without a sign-in, like a signed link. Anyone
who has it can use it while it works.

More: [Downloading, ZIP downloads](../files/downloading.md#zip-downloads)

### Can I send a ZIP link to a client?

Yes, but it works for 10 minutes only, and for anyone who has it. To hand
over files reliably, download the ZIP and send them the file.

More: [Downloading, ZIP downloads](../files/downloading.md#zip-downloads)

## Temporary download links

### What is a signed link?

A temporary link to a file, also called a signed URL. It is a web address
that serves exactly one thing, one variant of one version of one file, for
10 minutes and then stops.

More: [Downloading, Signed links](../files/downloading.md#signed-links)

### How long does a temporary download link to a file last?

10 minutes. Asking again gives a new link with a new 10 minutes.

More: [Downloading, Signed links](../files/downloading.md#signed-links)

### Does a signed link need me to be signed in?

No. It needs no cookie and no `Authorization` header. The address itself
is the permission.

More: [Downloading, Signed links](../files/downloading.md#signed-links)

### Is it safe to send a signed link to someone?

Only to someone who should have the file. Treat it like a secret while it
works: anyone you send it to can use it, signed in or not, inside or
outside the organization.

More: [Downloading, Signed links](../files/downloading.md#signed-links)

### Can a signed link be used more than once?

Yes. It can be used any number of times until it stops.

More: [Downloading, Signed links](../files/downloading.md#signed-links)

### Can I make a signed link last longer than 10 minutes?

No. A signed link works for 10 minutes. Ask for a new one when you need
more time. For lasting sharing, use the public link of a public file.

More: [Downloading, Signed links](../files/downloading.md#signed-links)

### Can I revoke a signed link before its 10 minutes are over?

No. There is no control that revokes one link. A signed link stops when
its 10 minutes pass, and at once when the file is moved to the trash.

More: [Downloading, What makes a signed link stop](../files/downloading.md#what-makes-a-signed-link-stop)

### Does an older signed link stop when I ask for a new one?

No. Earlier links keep their own time.

More: [Downloading, Signed links](../files/downloading.md#signed-links)

### Does a signed link keep working after the person who made it loses access?

Yes, until it expires. It is not checked who uses a link, so it keeps
working when the person who asked for it signs out or is removed from the
workspace.

More: [Downloading, What makes a signed link stop](../files/downloading.md#what-makes-a-signed-link-stop)

### Does a signed link follow the file when it gets a new version?

No. It keeps serving the version it was made for. The public link is the
one that follows the current version.

More: [Downloading, What makes a signed link stop](../files/downloading.md#what-makes-a-signed-link-stop)

### Does a signed link survive renaming the file?

Yes. It keeps working, and a download now carries the new name.

More: [Downloading, What makes a signed link stop](../files/downloading.md#what-makes-a-signed-link-stop)

### Does a signed link survive moving the file to another folder?

Yes. It keeps working.

More: [Downloading, What makes a signed link stop](../files/downloading.md#what-makes-a-signed-link-stop)

### Does a signed link stop when the file's status changes?

No. It keeps working.

More: [Downloading, What makes a signed link stop](../files/downloading.md#what-makes-a-signed-link-stop)

### Does making a file restricted stop its signed links?

No. Signed links and public links are independent. A signed link keeps
working when the file is made public or restricted.

More: [Downloading, What makes a signed link stop](../files/downloading.md#what-makes-a-signed-link-stop)

### Does a signed link work again after the file is restored from the trash?

No. Links from before the trash never come back. Ask for a new one.

More: [Downloading, What makes a signed link stop](../files/downloading.md#what-makes-a-signed-link-stop)

### What happens when I change a character in a signed link?

It never works. An altered link answers `403`.

More: [Downloading, What makes a signed link stop](../files/downloading.md#what-makes-a-signed-link-stop)

### Does a stopped signed link say why it stopped?

No. A link that has stopped answers `403`, and the answer does not say
why.

More: [Downloading, What makes a signed link stop](../files/downloading.md#what-makes-a-signed-link-stop)

### Is making a signed link recorded in the audit trail?

No. Making a signed link is not recorded.

More: [Downloading, Signed links](../files/downloading.md#signed-links)

### Can I use a signed link as an image address on my website?

No. It stops after 10 minutes. To use a file from another website, for
example as a web font or an image on a page, use its public link.

More: [Downloading, What a signed link serves](../files/downloading.md#what-a-signed-link-serves)

### Which things can a signed link serve?

One of four variants of a version: `original`, the version's own bytes,
`thumb`, a WebP image that fits 320 pixels, `preview`, a WebP image that
fits 1,600 pixels, and `playback`, a video's MP4 rendition.

More: [Downloading, Signed links](../files/downloading.md#signed-links)

### Does a signed link set or read cookies?

No. No cookie is read and none is set.

More: [Downloading, What a signed link serves](../files/downloading.md#what-a-signed-link-serves)

### What is a preview or playback download called?

It is named after the file with the rendering's extension: `poster.webp`
for the preview of `poster.psd`, `clip.mp4` for the playback rendition of
`clip.mov`.

More: [Downloading, What a signed link serves](../files/downloading.md#what-a-signed-link-serves)

### Where does the app itself use temporary links?

For ZIPs, previews and video. It downloads a single file through the API
instead, and it makes new links as needed.

More: [Downloading, Summary](../files/downloading.md#summary)

### Can I get a signed link for a file in the trash?

No. Asking answers `409 CONFLICT`, reason `IN_TRASH`. Restore the file
first. Its versions can still be downloaded through the API.

More: [Downloading, Signed links](../files/downloading.md#signed-links)

### Does a signed link work for someone who is not a Talewright user?

Yes, while it works. The address is the permission, so it opens for anyone
who has it.

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

### What happens to a signed link when the file is deleted for good?

It stops.

More: [Downloading, What makes a signed link stop](../files/downloading.md#what-makes-a-signed-link-stop)

## What opens in the browser and what saves

### Why did my file open in a browser tab instead of downloading?

You opened a temporary or public link. Images, PDFs and MP4 or WebM videos
are shown by the browser there. Use the browser's "Save as" to keep the
file, or choose "Download" in the app, which always saves.

More: [Downloading, What opens in the browser and what downloads](../files/downloading.md#what-opens-in-the-browser-and-what-downloads)

### Which file types open in the browser from a link?

JPEG, PNG, GIF, WebP, AVIF and ICO images, PDF, MP4 and WebM video, and
every thumbnail, preview and playback rendition.

More: [Downloading, What opens in the browser and what downloads](../files/downloading.md#what-opens-in-the-browser-and-what-downloads)

### Which file types always download from a link?

SVG, HEIC, HEIF, Photoshop, raw photos, Illustrator, EPS, InDesign, Figma,
fonts, QuickTime, CSV, Word, Excel, Markdown and plain text.

More: [Downloading, What opens in the browser and what downloads](../files/downloading.md#what-opens-in-the-browser-and-what-downloads)

### What decides whether a link shows a file or downloads it?

The type alone. A signed link or a public link opened in a browser either
shows the file in place or downloads it, depending on its type.

More: [Downloading, What opens in the browser and what downloads](../files/downloading.md#what-opens-in-the-browser-and-what-downloads)

### Does a link to a PDF open in the browser or download?

It opens in the browser. PDF is shown in place. Downloading through the
API, and "Download" in the app, always save it.

More: [Downloading, What opens in the browser and what downloads](../files/downloading.md#what-opens-in-the-browser-and-what-downloads)

### Why does a link to an SVG download instead of showing the image?

An SVG is never shown in place, although browsers can draw it. Its preview
is a WebP image and is shown.

More: [Downloading, What opens in the browser and what downloads](../files/downloading.md#what-opens-in-the-browser-and-what-downloads)

### Does a link to a JPEG or PNG show the image in the browser?

Yes. JPEG and PNG are shown in place.

More: [Downloading, What opens in the browser and what downloads](../files/downloading.md#what-opens-in-the-browser-and-what-downloads)

### Does a link to a GIF, WebP or AVIF image open in the browser?

Yes. GIF, WebP and AVIF are shown in place.

More: [Downloading, What opens in the browser and what downloads](../files/downloading.md#what-opens-in-the-browser-and-what-downloads)

### Does a link to a HEIC photo open in the browser?

No. HEIC and HEIF always download. In the app you see the photo's preview.

More: [Downloading, What opens in the browser and what downloads](../files/downloading.md#what-opens-in-the-browser-and-what-downloads)

### Does a link to a Photoshop file open in the browser?

No. Photoshop files (`.psd`, `.psb`) always download.

More: [Downloading, What opens in the browser and what downloads](../files/downloading.md#what-opens-in-the-browser-and-what-downloads)

### Does a link to a raw photo open in the browser?

No. Raw photos always download.

More: [Downloading, What opens in the browser and what downloads](../files/downloading.md#what-opens-in-the-browser-and-what-downloads)

### Does a link to an MP4 or WebM video play in the browser?

Yes. MP4 and WebM are shown in place.

More: [Downloading, What opens in the browser and what downloads](../files/downloading.md#what-opens-in-the-browser-and-what-downloads)

### Does a link to a MOV file play in the browser?

No. A QuickTime original downloads. In the app it plays through its
playback rendition.

More: [Downloading, What opens in the browser and what downloads](../files/downloading.md#what-opens-in-the-browser-and-what-downloads)

### Does a link to a font file open in the browser?

No. Fonts always download.

More: [Downloading, What opens in the browser and what downloads](../files/downloading.md#what-opens-in-the-browser-and-what-downloads)

### Does a link to a Word, Excel or CSV file open in the browser?

No. CSV, Word and Excel always download.

More: [Downloading, What opens in the browser and what downloads](../files/downloading.md#what-opens-in-the-browser-and-what-downloads)

### Does a link to a text or Markdown file show the text in the browser?

No. Markdown and plain text always download.

More: [Downloading, What opens in the browser and what downloads](../files/downloading.md#what-opens-in-the-browser-and-what-downloads)

### Does a link to an Illustrator, EPS, InDesign or Figma file open in the browser?

No. Design files always download.

More: [Downloading, What opens in the browser and what downloads](../files/downloading.md#what-opens-in-the-browser-and-what-downloads)

### Does a link to an ICO file open in the browser?

Yes. ICO is shown in place.

More: [Downloading, What opens in the browser and what downloads](../files/downloading.md#what-opens-in-the-browser-and-what-downloads)

### How do I save a file that a link shows in the browser?

Use the browser's "Save as", or download it through the API. In the app,
"Download" does the latter and always saves.

More: [Downloading, What opens in the browser and what downloads](../files/downloading.md#what-opens-in-the-browser-and-what-downloads)

### Can a file that opens in the browser run as a web page?

No. Whatever is shown in place is shown as a file, never run as a web
page.

More: [Downloading, What opens in the browser and what downloads](../files/downloading.md#what-opens-in-the-browser-and-what-downloads)

### What do "inline" and "attachment" mean for a file link?

"Shown in place" means the link carries `Content-Disposition: inline`.
"Always downloads" means `attachment`.

More: [Downloading, What opens in the browser and what downloads](../files/downloading.md#what-opens-in-the-browser-and-what-downloads)

### Does a ZIP link ever open in the browser?

No. A ZIP always downloads.

More: [Downloading, What opens in the browser and what downloads](../files/downloading.md#what-opens-in-the-browser-and-what-downloads)

## Thumbnails, previews and playback renditions

### What is the difference between a thumbnail, a preview and the original?

A thumbnail is a WebP image that fits 320 pixels, used in listings. A
preview is a WebP image that fits 1,600 pixels, used on a file's page. The
original is the file itself, and it is what downloads.

More: [Downloading, Thumbnails, previews and playback](../files/downloading.md#thumbnails-previews-and-playback)

### Can I download the preview image of a file?

Not with "Download", which always gives the original. Through the API you
can ask for a signed link with the variant `preview` or `thumb`.

More: [Downloading, Signed links](../files/downloading.md#signed-links)

### Do thumbnails and previews have a public address?

No. They are reached only through signed links. They have no public
address.

More: [Downloading, Thumbnails, previews and playback](../files/downloading.md#thumbnails-previews-and-playback)

### What does `NO_PLAYBACK` mean when I ask for a playback link?

The original plays as it is, or the file is not a video. Use the variant
`original`.

More: [Downloading, Signed links](../files/downloading.md#signed-links)

### What does `PLAYBACK_PENDING` mean?

The playback rendition is still being prepared. Try again shortly, or use
`original`.

More: [Downloading, Signed links](../files/downloading.md#signed-links)

### What does `PLAYBACK_FAILED` mean?

No playback rendition could be made. Use `original`.

More: [Downloading, Signed links](../files/downloading.md#signed-links)

### What are `thumbnailURL` and `previewURL` on a file?

Ready-made signed links: `thumbnailURL` on every file, and `previewURL`
when a single file is read. Both are `null` until the preview is ready and
while the file is in the trash. They work for 10 to 15 minutes: they stop
on a five-minute mark of the clock, so every read within the same five
minutes carries the same link.

More: [Downloading, Signed links](../files/downloading.md#signed-links)

### Can I link to a thumbnail from another website?

No. Thumbnails have no public address, and a signed link stops after 10
minutes.

More: [Downloading, Thumbnails, previews and playback](../files/downloading.md#thumbnails-previews-and-playback)

## Downloading through the API

### Which API operations download files?

`GET W/files/{fileID}/versions/{versionID}/content` answers with a
version's bytes, `POST W/files/{fileID}/versions/{versionID}/signed-url`
makes a temporary link, and `POST W/files/archive` makes a ZIP link. The
organization folder has the same three.

More: [Downloading, Operations](../files/downloading.md#operations)

### Does downloading through the API ever show a file in the browser?

No. The answer is always a download: it carries `Content-Disposition:
attachment`, whatever the type.

More: [Downloading, Downloading through the API](../files/downloading.md#downloading-through-the-api)

### Which headers does a download through the API carry?

`Content-Disposition: attachment` with the file's current name,
`Content-Type` with the version's type, `ETag` with the version's digest,
`Content-Length` with the size in bytes, and `Cache-Control: private,
no-cache`.

More: [Downloading, Downloading through the API](../files/downloading.md#downloading-through-the-api)

### What is the `ETag` of a downloaded version?

The version's digest, written `"sha256:<hex>"`. You can use it to check
that you received what was stored.

More: [Downloading, Downloading through the API](../files/downloading.md#downloading-through-the-api)

### How do I verify that a download is complete and unchanged?

Compare the SHA-256 of what you received with the version's `digest`.

More: [Downloading, Worked example: download a file](../files/downloading.md#worked-example-download-a-file)

### How do I resume an interrupted download?

Send a `Range` header for the bytes that are missing, for example
`bytes=1048576-`. The answer is `206` with `Content-Range`.

More: [Downloading, Parts of a file](../files/downloading.md#parts-of-a-file)

### Which forms of `Range` does a download accept?

One range: `bytes=0-99`, `bytes=100-` or `bytes=-100` for the last 100
bytes. A range that reaches past the end is cut off at the end.

More: [Downloading, Parts of a file](../files/downloading.md#parts-of-a-file)

### What happens when a download asks for several ranges at once?

They are ignored and the whole content is served with `200`. The same goes
for another unit than `bytes` and for a malformed range.

More: [Downloading, Parts of a file](../files/downloading.md#parts-of-a-file)

### What does `416 RANGE_NOT_SATISFIABLE` mean on a download?

The range starts past the end of the version. The answer carries
`details.sizeBytes` and `Content-Range: bytes */<size>`.

More: [Downloading, Parts of a file](../files/downloading.md#parts-of-a-file)

### What does `If-Range` do on a temporary or public link?

A range sent with `If-Range` is honored only when `If-Range` holds the
current `ETag`. Otherwise the whole content is served, so a resumed
download of a replaced file never mixes two versions.

More: [Downloading, Parts of a file](../files/downloading.md#parts-of-a-file)

### Does a download through the API answer `304 Not Modified`?

No. Downloading through the API always sends the bytes. A signed link
answers `304` when `If-None-Match` names its `ETag`, for as long as the
link works.

More: [Downloading, What a signed link serves](../files/downloading.md#what-a-signed-link-serves)

### Is an expired signed link checked before `If-None-Match`?

Yes. The link is checked before the tag. An expired or stopped link
answers `403` whatever the request sends.

More: [Downloading, What a signed link serves](../files/downloading.md#what-a-signed-link-serves)

### What does a ZIP request through the API return?

`200` with `url`, `expiresAt`, `name`, `fileCount` and `sizeBytes`. `url`
is a temporary link to the ZIP that works for 10 minutes.

More: [Downloading, ZIP downloads](../files/downloading.md#zip-downloads)

### What happens when a ZIP request names no folder and no file?

It answers `422 VALIDATION_FAILED` on `fileIDs`. There is nothing to
download.

More: [Downloading, ZIP downloads](../files/downloading.md#zip-downloads)

### What happens when one of the IDs in a ZIP request is in the trash?

The whole request answers `404 NOT_FOUND` and no link is made. Every named
item must exist and be live. Trashed files inside a named folder are only
skipped.

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

### What does "an archive holds at most 10000 files" mean?

The ZIP you asked for would hold more than 10,000 files. The request
answers `422 VALIDATION_FAILED` on `fileIDs`. Ask for fewer files at once.

More: [Downloading, ZIP downloads](../files/downloading.md#zip-downloads)

### What does `details.limitBytes` hold when a ZIP is too large?

The size limit in bytes. A ZIP whose files add up to more than 20 GiB
answers `413 PAYLOAD_TOO_LARGE` with it.

More: [Downloading, ZIP downloads](../files/downloading.md#zip-downloads)

### What do I send to ask for a signed link to a thumbnail?

`{"variant": "thumb"}` in the body of the signed-url request for that
version. The other variants are `original`, `preview` and `playback`.

More: [Downloading, Requests and answers](../files/downloading.md#requests-and-answers)

### What happens when I ask for a signed link with an unknown variant?

It answers `422 VALIDATION_FAILED`. `variant` must be one of `original`,
`thumb`, `preview` and `playback`.

More: [Downloading, Signed links](../files/downloading.md#signed-links)

### What happens when someone outside the workspace asks for a version's content?

They get `404 NOT_FOUND`. Outsiders cannot tell the file exists.

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

### Can a download through the API be cached by a proxy?

No. The answer carries `Cache-Control: private, no-cache`, so shared
caches must not keep it.

More: [Downloading, Downloading through the API](../files/downloading.md#downloading-through-the-api)

### Is a ZIP link kept by caches?

No. A ZIP link is never kept by caches.

More: [Downloading, Between asking for a ZIP and downloading it](../files/downloading.md#between-asking-for-a-zip-and-downloading-it)

### When should a script use a signed link instead of the content operation?

When it hands the download to a browser or to another program that has no
credential. A script that already holds a credential can download through
the API directly.

More: [Downloading, Three ways to get a file's bytes](../files/downloading.md#three-ways-to-get-a-files-bytes)

### Does a `Range` request work on a signed link?

Yes. Ranges apply to the API, to temporary links and to public links.

More: [Downloading, Parts of a file](../files/downloading.md#parts-of-a-file)

## Handing files to other people

### How do I send a folder of brand assets to a freelancer?

Download the folder as a ZIP and send them the file. The ZIP link itself
works for 10 minutes only. For lasting access from outside, an owner or
admin can make the folder public: its files whose status allows public use
are then public too.

More: [Downloading, Downloading a folder or a selection](../files/downloading.md#downloading-a-folder-or-a-selection)

### How do I give a client the original of a product photo?

Choose "Download" on the photo and send them the file. It is the original,
exactly as it was uploaded.

More: [Downloading, Downloading one file](../files/downloading.md#downloading-one-file)

### How do I download a campaign folder with all its subfolders?

Choose "Download" in the folder's menu. The ZIP holds the folder with its
live subfolders and files, arranged as they are in Talewright.

More: [Downloading, What is inside a ZIP](../files/downloading.md#what-is-inside-a-zip)

### How do I get all my files out of Talewright?

Download a folder or a selection as a ZIP, within 10,000 files and 20 GiB
per ZIP. To get a copy of all of an organization's current files, use the
organization export.

More: [Downloading, ZIP downloads](../files/downloading.md#zip-downloads)

## What downloading does not do

### Can I protect a download with a password?

No. A temporary link works for anyone who has it, for 10 minutes. Inside
Talewright, downloading needs the right to open the file.

More: [Downloading, Signed links](../files/downloading.md#signed-links)

### Can I add a watermark to downloaded files?

No. A download is the stored original, byte for byte. Nothing is added or
changed.

More: [Downloading, Three ways to get a file's bytes](../files/downloading.md#three-ways-to-get-a-files-bytes)

### Can I choose a smaller size when I download an image in the app?

No. "Download" always gives the original. Resized and reformatted images
exist for public files only, through their public link.

More: [Downloading, Thumbnails, previews and playback](../files/downloading.md#thumbnails-previews-and-playback)

### Is an email sent when someone downloads my file?

No. Downloads of single files are not even recorded. A ZIP request is
recorded in the audit trail.

More: [Downloading, ZIP downloads](../files/downloading.md#zip-downloads)
