# Sharing and public links: questions and answers

Short answers about sharing files: general access, "Anyone with the link",
the strict rule for when a file is public, who can share, the public link,
what stops it and what brings it back, public folders and their gallery
page, moves and restores that change access, the location data warning and
what outsiders can see. Each answer links to the section of
[Sharing and public links](../files/sharing.md) that owns the rule.

## General access

### What is general access?

The setting on every file and every folder that says who can open it. It is
either "Restricted" or "Anyone with the link".

More: [Sharing and public links, General access](../files/sharing.md#general-access)

### What does "Restricted" mean on a file?

Only people who can open the file's workspace can open it. For a file in
the organization folder it means every member of the organization.

More: [Sharing and public links, General access](../files/sharing.md#general-access)

### What does "Anyone with the link" mean?

Anyone on the internet who has the link opens the file, without an account
and without signing in. Nobody needs to be invited. Such a file is called
public.

More: [Sharing and public links, General access](../files/sharing.md#general-access)

### Is a new file restricted or public?

Restricted. Every new file and every new folder starts restricted.

More: [Sharing and public links, General access](../files/sharing.md#general-access)

### Does a file keep its general access when it is renamed, moved or replaced?

Yes. The setting belongs to the file or folder. A new version of a file
keeps it, a rename keeps it and a move keeps it.

More: [Sharing and public links, General access](../files/sharing.md#general-access)

### How fast does a change of general access take effect?

At once. A file made public can be opened by its link right away, and a file
made restricted stops answering right away.

More: [Sharing and public links, General access](../files/sharing.md#general-access)

### What is general access called in the API?

`visibility`, with the values `restricted` and `public`. The app calls them
"Restricted" and "Anyone with the link".

More: [Sharing and public links, General access](../files/sharing.md#general-access)

### Can I share a file with specific people outside my organization?

No. There is no sharing with named outside people. A file is open to people
who can open its workspace, or to anyone with the link.

More: [Sharing and public links, General access](../files/sharing.md#general-access)

### Can I protect a public link with a password?

No. A public link has no password. To end access, restrict the file.

More: [Sharing and public links, General access](../files/sharing.md#general-access)

### How do I end access to a public link on a certain date?

Restrict the file yourself on that date. A public link has no expiry date
and does not stop by itself.

More: [Sharing and public links, General access](../files/sharing.md#general-access)

### Is a change of general access recorded?

Yes. Every change of a file's or folder's general access is recorded in the
audit trail as `file.visibility_changed` or `folder.visibility_changed`.

More: [Sharing and public links, General access](../files/sharing.md#general-access)

### Does changing general access change a file's `lockVersion`?

No. It does not change the `lockVersion` and takes no
`expectedLockVersion`.

More: [Sharing and public links, General access](../files/sharing.md#general-access)

### Is general access the only way to show a file to someone outside the organization?

Yes. General access is the only way to open a file to people outside the
organization.

More: [Sharing and public links, General access](../files/sharing.md#general-access)

## When a file is public

### When exactly is a file public?

Only while three things hold at once: the file is live, its status allows
public use, and the file itself or a live folder at or above it is shared
with "Anyone with the link".

More: [Sharing and public links, The strict rule](../files/sharing.md#the-strict-rule)

### What does "live" mean in the rule for public files?

The file is not in the trash, and its workspace and its organization are not
deleted.

More: [Sharing and public links, The strict rule](../files/sharing.md#the-strict-rule)

### Is a file public as soon as its general access is "Anyone with the link"?

Not always. The setting alone is not enough. A file can have the setting and
still not be public, for example while it is in the trash or after its
workspace was deleted.

More: [Sharing and public links, The strict rule](../files/sharing.md#the-strict-rule)

### Is a newly uploaded file ever public right away?

No. A new upload starts with the organization's default status or with none,
and neither allows public use.

More: [Sharing and public links, The strict rule](../files/sharing.md#the-strict-rule)

### Is a file uploaded into a public folder public right away?

No. It starts with the default status or none, so it is not public and not
on the gallery page until an owner or admin gives it a status that allows
public use.

More: [Sharing and public links, Public folders](../files/sharing.md#public-folders)

### What happens when one of the conditions for a public file stops holding?

The link stops at once. It answers "not found", exactly like a link that
never existed.

More: [Sharing and public links, The strict rule](../files/sharing.md#the-strict-rule)

### Can anything other than sharing make a file public?

No. A suggestion cannot change general access or statuses, and no credential
can change general access. A file becomes public only through its own
setting or a public folder above it, with an allowing status.

More: [Sharing and public links, The strict rule](../files/sharing.md#the-strict-rule)

### How do I check through the API whether a file is public right now?

Read the file's `public`: `true` while anyone with the link opens it now.
Do not derive it from `visibility`, which is only the file's own setting.

More: [Sharing and public links, What a file and a folder say about access](../files/sharing.md#what-a-file-and-a-folder-say-about-access)

### I set a status that allows public use. Why is the file not public?

The status only allows it. An owner or admin still chooses "Anyone with the
link" on the file, or the file must be in a public folder.

More: [Sharing and public links, The strict rule](../files/sharing.md#the-strict-rule)

## Who can share

### Who can make a file or folder public or restricted?

Owners and admins, signed in with a browser. For a workspace item the
effective workspace role counts. For an organization folder item the
organization role counts.

More: [Sharing and public links, Who changes general access](../files/sharing.md#who-changes-general-access)

### Why can I see the sharing settings but not change them?

You are a member. Members see who can open an item and can copy its link.
Owners and admins change it.

More: [Sharing and public links, What members see](../files/sharing.md#what-members-see)

### Can the admin of a workspace share that workspace's files?

Yes. A member of the organization who is owner or admin of the workspace
shares its files and folders. The effective workspace role counts.

More: [Sharing and public links, Who changes general access](../files/sharing.md#who-changes-general-access)

### Can a workspace admin share a file in the organization folder?

No, unless they are also an owner or admin of the organization. In the
organization folder the organization role counts, and a workspace role gives
nothing there. The request answers `403 FORBIDDEN`.

More: [Sharing and public links, Edge cases](../files/sharing.md#edge-cases)

### Do I need a verified email to share a file in the browser?

No. A verified email address is not needed in a browser session.

More: [Sharing and public links, Who changes general access](../files/sharing.md#who-changes-general-access)

### Which actions of an agent can start or stop a public link?

An agent cannot change general access. It can stop links by moving, trashing
or, with `files:approve`, setting a blocking status. With `files:approve`
it can start links by setting an allowing status on a file in a public
folder or, with `files:write` too, by moving or restoring one there.

More: [Sharing and public links, For agents](../files/sharing.md#for-agents)

### Who can see whether a file is public?

Everyone who can open the workspace or organization folder, members included. A
credential reads it with `files:read`.

More: [Sharing and public links, Who can do what](../files/sharing.md#who-can-do-what)

### Can general access be changed without a person in a browser?

No. It needs a person signed in with a browser. No API key or connected app
can change general access, whatever its scopes, and there is no MCP tool
for it.

More: [Sharing and public links, Who changes general access](../files/sharing.md#who-changes-general-access)

## Making a file public

### How do I make a file public?

1. Make sure the file's status allows public use.
2. Open the section "Sharing" on the file's page, or "Share" in its row menu.
3. Choose "Anyone with the link" in the picker "General access".

The box "Public link" appears with the link and "Copy public link".

More: [Sharing and public links, The General access control](../files/sharing.md#the-general-access-control)

### How do I share a file straight from the file list?

Open the file's row menu, from the button "File actions for {name}" or a
right-click. Choose "Share" for the dialog "Share {name}", or "Make public"
to switch the setting at once.

More: [Sharing and public links, Where sharing is](../files/sharing.md#where-sharing-is)

### What does "Make public" in a row menu do?

It sets the item's own general access to "Anyone with the link" at once. The
app confirms with "Anyone with the link can open {name}".

More: [Sharing and public links, Make public and Make restricted](../files/sharing.md#make-public-and-make-restricted)

### Why is there no "Make public" in the menu of my file?

One of three reasons. You are a member, and only owners and admins see it.
The file's status does not allow public use. Or the file's own setting is
already "Anyone with the link", and the menu shows "Make restricted".

More: [Sharing and public links, Make public and Make restricted](../files/sharing.md#make-public-and-make-restricted)

### Does the app ask for a confirmation before a file becomes public?

No. Choosing "Anyone with the link" or "Make public" is the decision. The
change is saved at once.

More: [Sharing and public links, Making a file public](../files/sharing.md#making-a-file-public)

### Why can I not make this file public?

One of three reasons. You are not an owner or admin: then the sharing
controls have no "General access" picker. The file has no status, or a
status that does not allow public use: the sharing controls say "Cannot be
public" and why. Or the file is in the trash.

More: [Sharing and public links, Making a file public](../files/sharing.md#making-a-file-public)

### Why is there no "General access" picker on my file?

Its status does not allow public use, or it has no status. Such a file has
no picker. The sharing controls say "Cannot be public" and why, and owners
and admins get "Set status" beside it. A member never has the picker.

More: [Sharing and public links, The General access control](../files/sharing.md#the-general-access-control)

### Can I make a file public while it is in the trash?

No. A file in the trash has no "Sharing" section, and the API answers
`409 CONFLICT`, reason `IN_TRASH`. Restore it first.

More: [Sharing and public links, Making a file public](../files/sharing.md#making-a-file-public)

### What happens when I make public a file that is already public?

The request succeeds and changes nothing. No audit event is recorded.

More: [Sharing and public links, Making a file public](../files/sharing.md#making-a-file-public)

### What does the API answer when a file is made public?

`200` with the file: `visibility` `public`, `public` `true` and its
`publicURL`.

More: [Sharing and public links, Making a file public](../files/sharing.md#making-a-file-public)

### In what order is a request to make a file public checked?

1. Not signed in: `401 UNAUTHENTICATED`.
2. From a credential: `403 FORBIDDEN`, reason `SESSION_REQUIRED`.
3. Workspace or organization unknown or out of reach: `404 NOT_FOUND`.
4. `visibility` missing or not `restricted` or `public`: `422`.
5. Not an owner or admin: `403 FORBIDDEN`.
6. Unknown file: `404 NOT_FOUND`.
7. File in the trash: `409 CONFLICT`, reason `IN_TRASH`.
8. The file already has the setting: `200`, nothing changes.
9. No status, or a status that does not allow public use: `409 CONFLICT`,
   reason `STATUS_BLOCKS_PUBLIC`.

More: [Sharing and public links, Making a file public](../files/sharing.md#making-a-file-public)

### Which messages does `STATUS_BLOCKS_PUBLIC` carry?

"The file has no status; give it one that allows public use first" for a
file without a status, and "The file's status does not allow public use"
for a file with a blocking status.

More: [Sharing and public links, Making a file public](../files/sharing.md#making-a-file-public)

### I chose "Anyone with the link" and the app said the file needs a status. Why?

The file's status changed after the page loaded. The rule is checked at the
moment of the change, so the file stays restricted. Set a status that allows
public use, then share it.

More: [Sharing and public links, The General access control](../files/sharing.md#the-general-access-control)

## Taking a link down

### How do I take a public link down right now?

Choose "Restricted" in "General access", or "Make restricted" in the row
menu. The link stops at once. If a public folder shares the file, restrict
the folder or move the file out as well.

More: [Sharing and public links, Making a file restricted](../files/sharing.md#making-a-file-restricted)

### I shared the wrong file. What do I do?

Restrict it, and if a public folder shares it, move it out of that folder
or restrict the folder. The link answers "not found" at once. Its address is
kept, so the link works again only if the file is made public again.

More: [Sharing and public links, Making a file restricted](../files/sharing.md#making-a-file-restricted)

### What does "Make restricted" do?

It sets the item's own general access to "Restricted". The app confirms with
"{name} is restricted". A file that a folder above shares stays public
through that folder.

More: [Sharing and public links, Make public and Make restricted](../files/sharing.md#make-public-and-make-restricted)

### I restricted a file and it is still public. Why?

A public folder above the file still shares it. The line under the picker
says so: "Anyone on the internet with the link can open it, because {folder}
is shared. Restrict {folder} to stop that."

More: [Sharing and public links, Making a file restricted](../files/sharing.md#making-a-file-restricted)

### Does a file need a status to be made restricted?

No. A status is not needed to restrict a file.

More: [Sharing and public links, Making a file restricted](../files/sharing.md#making-a-file-restricted)

### Is the link gone for good when I restrict a file?

No. The link's address is kept. Making the file public again brings the same
link back.

More: [Sharing and public links, Making a file restricted](../files/sharing.md#making-a-file-restricted)

### How do I stop one file in a public folder from being public?

Restricting the file itself changes nothing, because the folder shares it.
Move the file out of the folder, give it a status that does not allow public
use, or restrict the folder.

More: [Sharing and public links, Public folders](../files/sharing.md#public-folders)

### I restricted a file but my browser still shows it. Why?

A browser may reuse a file it already loaded for up to 60 seconds. After
that it asks again and gets "not found".

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

### What are all the ways a public link can stop?

The file or the folder that shared it is made restricted. The file gets a
blocking status or loses its status. Its status stops allowing public use or
is deleted. The file is moved out of a public folder, moved to the trash or
deleted for good. Its workspace or organization is deleted.

More: [Sharing and public links, What stops a link and what brings it back](../files/sharing.md#what-stops-a-link-and-what-brings-it-back)

### Can I take a link down for one person and keep it for the others?

No. The link is the same for everyone. Restricting the file stops it for
everyone.

More: [Sharing and public links, Copy link](../files/sharing.md#copy-link)

## The public link

### What does a public link look like?

Like this:
`https://files.talewrightusercontent.com/p/3f9c2b7e4a1d4c0e9b8a7f6e5d4c3b2a/logo.png`.
The middle part is 32 random hexadecimal digits that identify the file. The
last part is the file's name.

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

### Which host serves public links?

The files host, `https://files.talewrightusercontent.com`. It is a separate
host from the app. It needs no sign-in and no cookie, and it sets no cookie.

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

### Can someone guess the public link of a file?

No. The part that identifies the file is 32 random hexadecimal digits. It
cannot be guessed from the file's name or ID.

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

### When does a file get its public link?

The first time it becomes public, by any route: shared itself, or through a
public folder.

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

### Does a file's public link ever change?

No. The link never changes afterwards. A file has exactly one public link
for its whole life.

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

### Can I get a new public link for a file so that the old one stops working?

No. The link cannot be replaced by a new one. To retire a link for good,
upload the file again as a new file and share that one, then restrict or
trash the old file.

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

### Does renaming a file break its public link?

No. The file is found by the 32 digits alone. A link with the old name keeps
working, and so does one with the new name.

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

### Does the name at the end of a public link have to be correct?

No. The name is there for people to read. A link with an old name, or with
any other name, opens the same file.

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

### Why is a space written as `%20` in my public link?

In the link the name is percent-encoded: everything except letters, digits,
`-`, `_`, `.` and `~`. A space is written `%20`.

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

### What name does a file saved from a public link get?

The file's current name, whatever name the link carried.

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

### Does a public link serve the newest version of the file?

Yes. The link always serves the file's current version. When the file is
replaced by a new version, the same link serves the new one.

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

### Can I make a public link point to one specific version?

No. A link cannot be pinned to one version. It always serves the current
one.

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

### Can a public link start serving a different type of file?

No. A replacement is always of the same file type, so a link never changes
type.

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

### Is the file behind a public link the original or a compressed copy?

The original as it was uploaded, byte for byte. Resized and converted
variants of images exist beside it, at their own addresses.

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

### Do I get the same public link when I share a file again later?

Yes. Restricting a file and making it public again gives the same link. So
does a trash and a restore, a blocking status followed by an allowing one,
and a deleted and restored workspace or organization.

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

### What is the difference between a public link and the address of a file's page in the app?

A public link is on the files host and opens the file for anyone. The app
address, such as
`https://app.usetalewright.com/w/{workspaceID}/files/{fileID}`, opens the
file's page only for people who can sign in and open the workspace.

More: [Sharing and public links, Copy link](../files/sharing.md#copy-link)

### Can I choose my own address or a short code for a public link?

No. The 32 digits are random and cannot be replaced. Only the name at the
end is free, and it does not decide which file opens.

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

### Can public links use my own domain?

No. Every link to a file leads to the files host,
`https://files.talewrightusercontent.com`.

More: [Image delivery, The files host](../files/image-delivery.md#the-files-host)

### Can a public link be read by another website or embedded in a page?

Yes. Other websites can embed and read a public link, for example as an
image or a font.

More: [Image delivery, Use from other websites](../files/image-delivery.md#use-from-other-websites)

## Links that stop and come back

### How do I bring back a public link that stopped working?

Undo what stopped it. Make the file or the folder public again, set a status
that allows public use, move the file back, or restore it from the trash.
The link comes back at the same address. Only a file deleted for good is
gone for good.

More: [Sharing and public links, What stops a link and what brings it back](../files/sharing.md#what-stops-a-link-and-what-brings-it-back)

### What do people see when a public link no longer works?

"Not found": the link answers `404 NOT_FOUND`, the same as a link that never
existed.

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

### Can someone tell from a dead link whether the file still exists?

No. A restricted file, a trashed file, a file blocked by its status, a file
of a deleted workspace and a link that never existed all answer exactly the
same.

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

### How fast does a link work again after the file is public again?

At once. The "not found" answer is never cached, so the link works again the
moment the file is public.

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

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

It stops for good. Nothing brings it back.

More: [Sharing and public links, What stops a link and what brings it back](../files/sharing.md#what-stops-a-link-and-what-brings-it-back)

### Does moving a public file to another folder break its link?

Only when the file was public through its folder and leaves it for a place
that is not shared. A file that is public itself, or that moves between two
public folders, keeps its link working.

More: [Sharing and public links, What stops a link and what brings it back](../files/sharing.md#what-stops-a-link-and-what-brings-it-back)

### Does a blocking status change a file's own sharing setting?

Yes, on purpose. A blocking status changes the file's own setting to
restricted. A file never becomes public again by itself only because its
status allows public use again.

More: [Sharing and public links, What stops a link and what brings it back](../files/sharing.md#what-stops-a-link-and-what-brings-it-back)

### Does restricting a folder stop the link of a file that is also shared itself?

No. Restricting a folder stops only the links the folder gave. A file that
is public itself stays public.

More: [Sharing and public links, Public folders](../files/sharing.md#public-folders)

### A folder that shared my file was restricted. How do I get the link back?

Make the folder public again, or share the file itself. Either way the file
has the same link as before.

More: [Sharing and public links, What stops a link and what brings it back](../files/sharing.md#what-stops-a-link-and-what-brings-it-back)

### Does a public link keep working when the file gets a new version from a member?

Yes. The link serves the member's version. No approval is asked, because the
status and the sharing belong to the file, and members may replace workspace
files.

More: [Sharing and public links, Edge cases](../files/sharing.md#edge-cases)

## Public folders

### What is a public folder?

A folder shared with "Anyone with the link". Every file in it, and in every
folder below it, is public at its own public link, as long as that file is
live and its status allows public use.

More: [Sharing and public links, Public folders](../files/sharing.md#public-folders)

### How do I share a whole folder?

Choose "Share" or "Make public" in the folder's row menu, or use the card
"Sharing" of the open folder, and choose "Anyone with the link". No status
is involved for the folder itself.

More: [Sharing and public links, Sharing a folder](../files/sharing.md#sharing-a-folder)

### Does making a folder public make everything in it public?

Only the files whose status allows public use. Files without a status, or
with a status that does not allow public use, stay restricted. They get no
link and are not shown on the gallery page.

More: [Sharing and public links, Public folders](../files/sharing.md#public-folders)

### Does a folder need a status to be made public?

No. A folder has no status. Only its files do.

More: [Sharing and public links, Public folders](../files/sharing.md#public-folders)

### Is there a confirmation when I make a folder public?

No. No confirmation is asked when a folder is made public, however many
files become public with it.

More: [Sharing and public links, Public folders](../files/sharing.md#public-folders)

### Are the subfolders of a public folder public too?

Yes. Each has its own gallery page, and its `publicVia` names the folder
above that shares it.

More: [Sharing and public links, Public folders](../files/sharing.md#public-folders)

### Can I keep one subfolder of a public folder private?

Not by restricting it: the folder above shares everything below. Move the
subfolder out, or give its files a status that does not allow public use.

More: [Sharing and public links, Public folders](../files/sharing.md#public-folders)

### What happens when I set a subfolder of a public folder to "Restricted"?

Nothing changes. Its files stay public, because the folder above still
shares everything below it. The app says so: the subfolder's "General
access" picker is then disabled, and the line under it names the folder
above as a link.

More: [Sharing and public links, Public folders](../files/sharing.md#public-folders)

### Why is "General access" greyed out on a folder?

A folder above it is public and shares it, so the folder's own setting would
change nothing. The line under the picker says so, with that folder's name
as a link: "Anyone on the internet with the link can open it, because {folder}
is shared. Restrict {folder} to stop that." Restrict that folder, or move this
one out of it, and the picker works again.

More: [Sharing and public links, The General access control](../files/sharing.md#the-general-access-control)

### Is "General access" also disabled on a file inside a public folder?

No. Only a folder's picker is disabled while a folder above shares it. A
file's picker stays enabled and changes the file's own setting, which counts
once the folder above is restricted or the file is moved out.

More: [Sharing and public links, The General access control](../files/sharing.md#the-general-access-control)

### What happens when I restrict a public folder?

The links it gave stop. A file in it that is public itself, or that another
public folder above still shares, stays public.

More: [Sharing and public links, Public folders](../files/sharing.md#public-folders)

### Does a file that is public through a folder read "Anyone with the link"?

No. It keeps its own setting "Restricted". The sharing controls say that
anyone with the link can open it because {folder} is shared, the listing
shows the badge "Public via folder", and the API names the folder in
`publicVia`.

More: [Sharing and public links, Public folders](../files/sharing.md#public-folders)

### What is `publicVia` on a file or folder?

The nearest public folder at or above the item that shares it, as `id` and
`name`. It is `null` when no folder shares the item.

More: [Sharing and public links, What a file and a folder say about access](../files/sharing.md#what-a-file-and-a-folder-say-about-access)

### Which folder does `publicVia` name when two folders above a file are public?

The nearest one at or above the file.

More: [Sharing and public links, Edge cases](../files/sharing.md#edge-cases)

### Does a folder in the trash still share its files?

No. A folder in the trash shares nothing, and neither does any folder below
it.

More: [Sharing and public links, Public folders](../files/sharing.md#public-folders)

### Can I change the general access of a folder that is in the trash?

No. It answers `409 CONFLICT`, reason `IN_TRASH`. Restore the folder first.

More: [Sharing and public links, Public folders](../files/sharing.md#public-folders)

### How do I add a file to a public folder so that it is public there?

Give the file a status that allows public use and have an owner or admin
move it in. The move asks first. A file uploaded straight into the folder
is public once an owner or admin gives it an allowing status.

More: [Sharing and public links, Public folders](../files/sharing.md#public-folders)

### Does each file in a public folder have its own link?

Yes. Every public file in the folder is public at its own public link. The
folder's gallery page lists them.

More: [Sharing and public links, Public folders](../files/sharing.md#public-folders)

### What does setting a folder to the general access it already has do?

It succeeds and changes nothing.

More: [Sharing and public links, Public folders](../files/sharing.md#public-folders)

### In what order is a request to change a folder's general access checked?

1. Not signed in: `401 UNAUTHENTICATED`.
2. From a credential: `403 FORBIDDEN`, reason `SESSION_REQUIRED`.
3. Workspace or organization unknown or out of reach: `404 NOT_FOUND`.
4. `visibility` missing or not `restricted` or `public`: `422`.
5. Not an owner or admin: `403 FORBIDDEN`.
6. Unknown folder: `404 NOT_FOUND`.
7. Folder in the trash: `409 CONFLICT`, reason `IN_TRASH`.

Otherwise the setting is stored and the answer is `200` with the folder.

More: [Sharing and public links, Public folders](../files/sharing.md#public-folders)

### What does "Set status" in a folder's "Statuses" card do?

It sets one status on every file in the folder and below it. It is offered
to owners and admins.

More: [Sharing and public links, Sharing a folder](../files/sharing.md#sharing-a-folder)

## The gallery page

### What is the gallery page of a public folder?

A public page that lists the folder's subfolders and the public files
directly in it. Anyone with its address opens it in a browser, without
signing in.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

### What does a gallery address look like?

Like this:
`https://files.talewrightusercontent.com/p/f/8a1b6c2d3e4f40718293a4b5c6d7e8f9/Press%20kit`.
The 32 digits find the folder. The name at the end is for people.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

### Where do I find the gallery link of a public folder?

In the box "Public link" of the folder's "Sharing" card or "Share" dialog
while the folder is public. "Copy link" in the folder's row menu copies it
too.

More: [Sharing and public links, Sharing a folder](../files/sharing.md#sharing-a-folder)

### What does the gallery page show for each file?

A thumbnail, the file's name, its size and a "Download" link. The name and
"Download" lead to the file's own public link.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

### Does the gallery show the files of subfolders?

No. It shows the subfolders and the public files directly in the folder.
Files in subfolders are on the subfolders' own gallery pages.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

### In what order does the gallery list folders and files?

Subfolders come first, then files, each sorted by name without regard to
case.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

### Are files beyond the first 1,000 in a public folder still public?

Yes. The gallery lists at most 1,000 subfolders and 1,000 files. Files
beyond that are not listed, but each is still public at its own link.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

### I made a folder public. Why are some of its files missing from the gallery?

They have no status, or a status that does not allow public use. Or they are
in a subfolder, which has its own gallery page.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

### What does "Nothing is shared here yet." mean?

The folder is public, but nothing in it is: it has no subfolder and no file
whose status allows public use.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

### Which files get a thumbnail on the gallery page?

JPEG, PNG, WebP, AVIF, GIF, HEIC and HEIF images. Any other file shows its
file extension instead.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

### Does the gallery show descriptions, tags or statuses?

No. The page never shows files that are not public, and never shows
descriptions, tags, statuses, members or anything else about the workspace.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

### Does the gallery page need a sign-in or set cookies?

No. The page needs no sign-in and no cookie, and it runs no scripts.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

### Can I embed the gallery in my own website?

It is not made for that. The gallery is a page to open in a browser. It is
not meant to be embedded in or read by another website. Embed the files'
own public links instead.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

### Does renaming a folder break its gallery address?

No. Like a file's link, the gallery is found by the 32 digits alone.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

### When does a folder get its gallery address?

At the moment it is created. The address never changes. It works only while
the folder is public.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

### I added a file to a public folder. Why is it not on the gallery yet?

The page is kept by browsers and caches for up to 60 seconds, so a rename or
a new file inside can take a minute to show. A file also appears only once
its status allows public use.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

### What does a visitor see at the gallery of a folder that is no longer public?

`404 NOT_FOUND`, the same answer as an unknown file link. A restricted
folder, a trashed folder, a folder of a deleted workspace and an address
that never existed look alike.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

### Can a visitor go from a subfolder's gallery up to the folder above?

Yes, when the folder above is public too. The page then links up to that
folder's gallery.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

### What does "Download" on the gallery page do?

It leads to the file's own public link, like the file's name beside it.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

### Is a folder's `publicURL` the same as its gallery address?

Yes. The API gives the gallery address as the folder's `publicURL` while the
folder is public, itself or through a folder above. Otherwise `publicURL` is
`null`.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

### Can the gallery page be resized like an image?

No. Only a file's link can be resized. A variant address built on a gallery
address is refused with "Source must be a file delivery path".

More: [Image delivery, Checks, in order](../files/image-delivery.md#checks-in-order)

## Moves that change access

### Why did moving a file make the app ask "Change who can open these files?" first?

The move would make files public, because the destination is in a public
folder, or stop public links, because the files leave one. Nothing of that
moves until you confirm with "Move".

More: [Sharing and public links, Moving in the app](../files/sharing.md#moving-in-the-app)

### What does "3 files will become public via Press kit." mean?

The move puts three files whose status allows public use into the public
folder "Press kit", or below it. After the move anyone with their links can
open them.

More: [Sharing and public links, Moving in the app](../files/sharing.md#moving-in-the-app)

### What does "2 public links will stop working." mean when I move files?

Two of the files are public only through the folder they are leaving. After
the move their links answer "not found".

More: [Sharing and public links, Moving in the app](../files/sharing.md#moving-in-the-app)

### What happens when I choose "Cancel" on the question about a move?

The items that needed the question stay where they were. The items that did
not need it have already moved.

More: [Sharing and public links, Moving in the app](../files/sharing.md#moving-in-the-app)

### Does moving a file into a public folder make it public?

Yes, if its status allows public use. Such a move asks first, and only an
owner or admin can make it. A file without an allowing status moves in
without a question and stays restricted.

More: [Sharing and public links, Moves](../files/sharing.md#moves)

### Can a member move a file into a public folder?

Yes, when the file would not become public: a file without an allowing
status moves without a question. A member's move that would make files
public is refused outright, confirmed or not.

More: [Sharing and public links, Moves](../files/sharing.md#moves)

### What can a member do when a move would make files public?

Ask an owner or admin to move them, or move them somewhere that is not
shared. The file stays where it was.

More: [Sharing and public links, Moving in the app](../files/sharing.md#moving-in-the-app)

### Can a member move a public file out of a public folder?

Yes. Stopping links needs only the confirmation. The move is refused with
`VISIBILITY_CHANGE` first, and once confirmed it moves and the link stops.

More: [Sharing and public links, Moves](../files/sharing.md#moves)

### Why can I not undo moving a file out of a public folder?

You are a member, and moving it back would make it public again. Only an
owner or admin can do that. The app says "That would make 1 file public.
Only an owner or admin can make files public." and the file stays out.

More: [Sharing and public links, Edge cases](../files/sharing.md#edge-cases)

### Does moving a file between two public folders ask anything?

No. The file is public before and after, so it moves without a question and
its link keeps working.

More: [Sharing and public links, Moves](../files/sharing.md#moves)

### Does moving a file that is public itself into a restricted folder stop its link?

No. It moves without a question and stays public. Its own sharing does not
depend on the folder.

More: [Sharing and public links, Moves](../files/sharing.md#moves)

### Does moving a folder count the files inside it?

Yes. Moving a folder counts every file in it and below it. A folder that
holds one file that would become public is treated like moving that file.

More: [Sharing and public links, Moves](../files/sharing.md#moves)

### What does "Undo" do to access after a move?

It moves the items back and with them the access they had, without asking
again. The app offers it for 8 seconds and answers "Moved {name} back".

More: [Sharing and public links, Moving in the app](../files/sharing.md#moving-in-the-app)

### I dragged ten files into a public folder and only some moved. Why?

The app moves at once whatever does not change access. For the files that
would become public it asks once, for the whole move. They move when you
choose "Move".

More: [Sharing and public links, Moving in the app](../files/sharing.md#moving-in-the-app)

### What does a refused move change?

Nothing. The file or folder stays where it was.

More: [Sharing and public links, Moves](../files/sharing.md#moves)

### Does sending `confirmVisibilityChange: true` matter when a move changes nobody's access?

No. A confirmation is never needed when access does not change, and sending
it then makes no difference. The move goes through.

More: [Sharing and public links, Moves](../files/sharing.md#moves)

### Can a file without an allowing status become public by being moved?

No. It never becomes public by a move. It becomes public later only if an
owner or admin gives it an allowing status, and that change asks first.

More: [Sharing and public links, Moves](../files/sharing.md#moves)

### What does each kind of caller get for a move that would make files public?

- Owner or admin in a browser: `409` `VISIBILITY_CHANGE` until confirmed.
- Member in a browser: `403 FORBIDDEN`, reason `MAKES_FILES_PUBLIC`.
- Credential with `files:write` only: `403`, reason `INSUFFICIENT_SCOPE`.
- Credential with `files:write` and `files:approve` of an owner or admin
  with a verified email: `409` `VISIBILITY_CHANGE` until confirmed.

More: [Sharing and public links, Moves](../files/sharing.md#moves)

### What does each kind of caller get for a move that only stops public links?

The same for everyone who may move the item: `409 CONFLICT`, reason
`VISIBILITY_CHANGE`, until the request is repeated with
`confirmVisibilityChange: true`. Then it moves.

More: [Sharing and public links, Moves](../files/sharing.md#moves)

### What does a credential get for a public-making move when its member's email is not verified?

`403 EMAIL_NOT_VERIFIED`. A credential that makes files public by a move or
a restore needs its member's email address to be verified.

More: [Sharing and public links, Moves](../files/sharing.md#moves)

### In what order are the access checks of a move made?

After the usual checks of a move come three for a move that would make files
public: a credential without `files:approve` gets `INSUFFICIENT_SCOPE`, a
caller who is not an owner or admin gets `MAKES_FILES_PUBLIC`, and a
credential whose member's email is not verified gets `EMAIL_NOT_VERIFIED`.
Last comes `VISIBILITY_CHANGE` for a move that is not confirmed.

More: [Sharing and public links, Moves](../files/sharing.md#moves)

### Can a member in the organization folder be refused with `MAKES_FILES_PUBLIC`?

No. In the organization folder only owners and admins move anything, so a
member's move is refused before that question arises.

More: [Sharing and public links, Moves](../files/sharing.md#moves)

### Does an owner have to confirm a move into a public folder in the app?

Yes. The app asks "Change who can open these files?" once for the whole
move, and the files move when the owner chooses "Move".

More: [Sharing and public links, Moving in the app](../files/sharing.md#moving-in-the-app)

## Trash and restores

### Can I move a public file to the trash?

Yes. It is allowed and asks nothing. The link stops at once.

More: [Sharing and public links, Moving to the trash](../files/sharing.md#moving-to-the-trash)

### What does `publicLinkCount` say when a folder is moved to the trash?

How many public files inside had their link stopped by the move.

More: [Sharing and public links, Moving to the trash](../files/sharing.md#moving-to-the-trash)

### Does a restored file come back public?

Yes, if it was public when it went to the trash. It comes back public at the
same link, for whoever may restore it. No confirmation is asked.

More: [Sharing and public links, Restores](../files/sharing.md#restores)

### When can a restore make a file public that was not public before?

When the file's folder was moved under a public folder while the file was in
the trash, or when the folder was shared meanwhile.

More: [Sharing and public links, Restores](../files/sharing.md#restores)

### Why was my restore refused with "Only an owner or admin can make files public"?

You are a member, and the restore would make a file public that was not
public when it was trashed. The file stays in the trash. Ask an owner or
admin to restore it.

More: [Sharing and public links, Trash and restore in the app](../files/sharing.md#trash-and-restore-in-the-app)

### Is an owner asked to confirm a restore that makes a file newly public?

No. An owner or admin restores it without a confirmation, and the file comes
back public.

More: [Sharing and public links, Restores](../files/sharing.md#restores)

### What happens to a folder restore when one file in it would be newly public?

For a member the whole restore is refused and the whole folder stays in the
trash. `details.becomePublic` counts only the files that would be newly
public.

More: [Sharing and public links, Restores](../files/sharing.md#restores)

### A file was public when trashed and its status changed meanwhile. What happens at the restore?

It comes back restricted, without a refusal. Anyone who may restore it can
restore it, because nothing becomes public.

More: [Sharing and public links, Restores](../files/sharing.md#restores)

### Why is my restored file not public although it was public before?

It can no longer be public. Its status stopped allowing public use
meanwhile, the folder that shared it was restricted, or its folder is not
live and it returned to the top level, where no folder shares it.

More: [Sharing and public links, Restores](../files/sharing.md#restores)

### What does a public file read in the API while it is in the trash?

`visibility` is `public`, `public` is `false` and `publicURL` is `null`. The
setting is kept for a restore. The file is not public.

More: [Sharing and public links, Edge cases](../files/sharing.md#edge-cases)

### What does "Undo" do after I trash a public file?

It restores the items and answers "Restored {name}". The file is public
again at the same link, also when a member does it.

More: [Sharing and public links, Trash and restore in the app](../files/sharing.md#trash-and-restore-in-the-app)

### How long can a trashed file be restored together with its public link?

30 days.

More: [Sharing and public links, Limits](../files/sharing.md#limits)

### Does the trash remember that a file was public?

Yes. The trash remembers, for each file, whether it was public at the moment
it was trashed.

More: [Sharing and public links, Moving to the trash](../files/sharing.md#moving-to-the-trash)

### What does a credential without `files:approve` get for a restore that makes a file newly public?

`403 FORBIDDEN`, reason `INSUFFICIENT_SCOPE`. A refused restore restores
nothing.

More: [Sharing and public links, Restores](../files/sharing.md#restores)

## Location data

### Why does Talewright warn me about location data on a photo?

The photo's metadata holds the GPS position where it was taken. A public
link serves the original with that metadata, so anyone with the link can
read the position.

More: [Sharing and public links, Location data](../files/sharing.md#location-data)

### Which file types can show the location data warning?

JPEG, PNG, WebP, AVIF, HEIC and HEIF images. The position is read from their
EXIF metadata.

More: [Sharing and public links, Location data](../files/sharing.md#location-data)

### Does Talewright remove location data from a file I share?

No. The public link serves the original unchanged, and nothing is removed
from it. Resized image variants carry no metadata.

More: [Sharing and public links, Location data](../files/sharing.md#location-data)

### How do I share a photo without revealing where it was taken?

Replace the file with a copy without the position before sharing it. Or hand
out a resized variant of its link, which carries no metadata. The original's
own link still serves the position.

More: [Sharing and public links, Location data](../files/sharing.md#location-data)

### Does the location data warning stop me from sharing the file?

No. It is a warning only. It does not stop anyone from making the file
public.

More: [Sharing and public links, Location data](../files/sharing.md#location-data)

### Who sees the location data warning?

Everyone who sees the sharing controls, members included.

More: [Sharing and public links, Location data](../files/sharing.md#location-data)

### Is the location warning shown before the file is public?

Yes. It is shown whether or not the file is public yet, as long as the
file's status allows public use.

More: [Sharing and public links, Location data](../files/sharing.md#location-data)

### Why is there no location warning on a photo that holds a GPS position?

The file's status does not allow public use, so the file cannot be public
and the warning is not shown. Or the version was uploaded before this was
recorded.

More: [Sharing and public links, Location data](../files/sharing.md#location-data)

### What is `hasLocationData` on a version?

Whether that version's original holds a GPS position. It is `true` only when
both a latitude and a longitude are present.

More: [Sharing and public links, Location data](../files/sharing.md#location-data)

### Does the location warning go away when I replace the photo?

Yes, if the new version holds no position. The warning follows the current
version. Earlier versions keep their own `hasLocationData`.

More: [Sharing and public links, Location data](../files/sharing.md#location-data)

### Does a video or a raw photo with a GPS position get the warning?

No. Positions are read only from the EXIF data of JPEG, PNG, WebP, AVIF,
HEIC and HEIF images. For every other file type `hasLocationData` is
`false`.

More: [Sharing and public links, Location data](../files/sharing.md#location-data)

## Copy link

### What do "Copy public link" and "Copy link for members" copy?

"Copy public link" copies the public link, or a folder's gallery address.
It is there only while the item is public. "Copy link for members" is
always there and copies the address of the item's page in the app, which
works only for people who can sign in and open the workspace.

More: [Sharing and public links, Copy link](../files/sharing.md#copy-link)

### What does "Copy link" in a row's menu copy?

For a file, the app address. For a public folder, the gallery address. For a
restricted folder, the app address.

More: [Sharing and public links, Copy link](../files/sharing.md#copy-link)

### I sent a copied link and the other person cannot open it. Why?

You copied the item's address in the app, with "Copy link for members" or
with "Copy link" in a row's menu. That address works only for people who
can sign in and open the workspace. For anyone else, use "Copy public
link", which is there only while the item is public.

More: [Sharing and public links, Copy link](../files/sharing.md#copy-link)

### Is copying a public link recorded anywhere?

No. Copying it creates nothing and is not recorded.

More: [Sharing and public links, Copy link](../files/sharing.md#copy-link)

### Can a member copy the public link of a file?

Yes. Everyone who can open the item can copy its links, members included.

More: [Sharing and public links, Copy link](../files/sharing.md#copy-link)

### What does "Copied the link" mean?

The link is on your clipboard. If the browser refuses to copy, the app says
"Could not copy. Select the link and copy it." for the public link and
"Could not copy the link." for the link for members.

More: [Sharing and public links, The General access control](../files/sharing.md#the-general-access-control)

### Where is the box "Public link"?

In the section "Sharing" of a file's page, the card "Sharing" of an open
folder and the dialog "Share {name}", while the item is public. It holds the public link, or for a folder the gallery address, with
"Copy public link" beside it.

More: [Sharing and public links, Copy link](../files/sharing.md#copy-link)

## The sharing controls in the app

### Where are the sharing settings of a file?

On the file's page, in the section "Sharing" in "Details", under the
preview. On a narrow screen it is further down the same page, under the
section "Details".

More: [Sharing and public links, Where sharing is](../files/sharing.md#where-sharing-is)

### Where are the sharing settings of a folder?

In the details beside the listing of the open folder, in the card "Sharing".
On a narrow screen the toolbar's "Details" button opens them. The folder's
row menu has "Share" too.

More: [Sharing and public links, Where sharing is](../files/sharing.md#where-sharing-is)

### How do I open the "Share" dialog?

Choose "Share" in the row menu of a file or folder, or run "Share" from the
command palette for the selected or open item. The dialog "Share {name}"
holds the same controls as the "Sharing" section or card.

More: [Sharing and public links, The Share dialog](../files/sharing.md#the-share-dialog)

### Do I have to save the "Share" dialog?

No. Changes are saved the moment you choose them. "Done" only closes the
dialog.

More: [Sharing and public links, The Share dialog](../files/sharing.md#the-share-dialog)

### Does the "Share" dialog show a change someone else just made?

Yes. The dialog always loads the item as it is now, so it shows a change
made in another tab or by someone else.

More: [Sharing and public links, The Share dialog](../files/sharing.md#the-share-dialog)

### What does "Change general access" in the command palette do?

It switches the general access setting of the selected or open item.

More: [Sharing and public links, Where sharing is](../files/sharing.md#where-sharing-is)

### Why does a file in the trash have no "Sharing" section?

A trashed file is not public and its general access cannot be changed.
Restore it to share it.

More: [Sharing and public links, Where sharing is](../files/sharing.md#where-sharing-is)

### What does "Only people with access to this workspace can open it." mean?

The item is not public. Only people who can open its workspace can open it.

More: [Sharing and public links, The General access control](../files/sharing.md#the-general-access-control)

### What does "Only people in the organization can open it." mean?

The item is in the organization folder and is not public. Every member of the
organization can open it, and nobody else.

More: [Sharing and public links, The General access control](../files/sharing.md#the-general-access-control)

### What does "Anyone on the internet with the link can open it." mean?

The file is public now. Anyone who has its public link opens it without
signing in.

More: [Sharing and public links, The General access control](../files/sharing.md#the-general-access-control)

### What does "Anyone on the internet with the link can open it and the files in it whose status allows public use." mean?

The folder is public. Its gallery page is open to anyone with the address,
and so is every file in it whose status allows public use. Its other files
stay restricted.

More: [Sharing and public links, The General access control](../files/sharing.md#the-general-access-control)

### What does "Anyone on the internet with the link can open it, because {folder} is shared. Restrict {folder} to stop that." mean?

The item's own setting may be "Restricted", but a folder above it is public
and shares it. To stop that, restrict that folder or move the item out. The
folder's name in the line is a link that opens it.

More: [Sharing and public links, The General access control](../files/sharing.md#the-general-access-control)

### What does the badge "Public, from {folder}" mean?

It is in the card "Folder details". The folder's own setting is
"Restricted", but a folder above shares it, so anyone with the link can
open it.

More: [Sharing and public links, Badges in the listing](../files/sharing.md#badges-in-the-listing)

### What do the badges "Public" and "Public via folder" mean in the file list?

Anyone with the link can open the item now. "Public" means it is shared
itself. "Public via folder" means a folder above shares it.

More: [Sharing and public links, Badges in the listing](../files/sharing.md#badges-in-the-listing)

### Why does a file set to "Anyone with the link" show no "Public" badge?

It is not public now, for example because its status no longer allows it.
An item that is not public now shows no badge, whatever its own setting.

More: [Sharing and public links, Badges in the listing](../files/sharing.md#badges-in-the-listing)

### How do I see which files are public?

In the listing, public files and folders carry the badge "Public" or "Public
via folder". Through the API, read `public` on each file. The status list
counts the public files per status.

More: [Sharing and public links, Badges in the listing](../files/sharing.md#badges-in-the-listing)

### What does hovering a "Public" badge tell me?

"Anyone with the link" for an item shared itself, or "Anyone with the link,
through {folder}" for one a folder shares.

More: [Sharing and public links, Badges in the listing](../files/sharing.md#badges-in-the-listing)

### What does the card "Folder details" say about who can open a folder?

One of "Restricted", "Every workspace", "Public" or "Public, from {folder}".

More: [Sharing and public links, Badges in the listing](../files/sharing.md#badges-in-the-listing)

### What does a member see under "Sharing"?

The same section or card, read-only: the line that says who can open the item, the
public link with "Copy public link" while the item is public, "Copy link
for members", and the reason a file cannot be public. There is no "General
access" picker and no "Set status".

More: [Sharing and public links, What members see](../files/sharing.md#what-members-see)

### Why does a member have no "General access" picker?

Only owners and admins change general access. A member sees the line that
says who can open the item, and the links to copy.

More: [Sharing and public links, What members see](../files/sharing.md#what-members-see)

### Why does sharing say "Only owners and admins change who can open it."?

Your role does not allow the change, for example because it changed since
the page loaded. Ask an owner or admin.

More: [Sharing and public links, The General access control](../files/sharing.md#the-general-access-control)

### What do I do when sharing says "Could not change access. Try again."?

Try again. The change of general access failed for a reason other than your
role or the file's status, and nothing changed.

More: [Sharing and public links, The General access control](../files/sharing.md#the-general-access-control)

### Does a member see "Make public" or "Set status" in menus?

No. A member's menus have no "Make public", "Make restricted" or "Set
status". They do have "Share", which opens the read-only dialog.

More: [Sharing and public links, What members see](../files/sharing.md#what-members-see)

## What outsiders can and cannot see

### What can someone with a public link see?

The file itself: its current version, exactly as it was uploaded, with its
metadata. Nothing else about the workspace.

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

### Can someone with a public link to one file see the other files in its folder?

No. A link opens one file. Other files are reachable only at their own
public links, or through the gallery page of a public folder.

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

### Can someone with a public link change, replace or delete the file?

No. The files host only serves. It answers `GET` and `HEAD`, and any other
method is refused.

More: [Image delivery, The files host](../files/image-delivery.md#the-files-host)

### Can I see who opened a public link?

No. The files host never asks who a visitor is, and reading records nothing
in the audit trail.

More: [Audit trail, Rules](../reference/audit-trail.md#rules)

### Is there a view count or download count for a public link?

No. Opening a public link records nothing, so there is nothing to count.

More: [Audit trail, Rules](../reference/audit-trail.md#rules)

### Can search engines find my public files?

A link can be found only by someone who has it. It cannot be guessed. If you
publish the link on a web page, anyone who reads that page has it. The
gallery page of a public folder asks search engines not to index it.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

### Does a public link reveal which organization or workspace a file belongs to?

The link holds the files host, 32 random digits and the file's name. It
names no organization and no workspace.

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

### Is the file's name visible to people who have its public link?

Yes. The last part of the link is the file's name, and a saved copy gets the
file's current name.

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

### Can someone outside the organization read a file's sharing settings through the API?

No. They get `404 NOT_FOUND`, as for an unknown workspace. Outsiders cannot
tell that the workspace or file exists.

More: [Sharing and public links, Edge cases](../files/sharing.md#edge-cases)

### Can visitors upload files to a public folder?

No. The gallery page only lists files. It needs no sign-in and takes no
input.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

### Can a visitor download a whole public folder as one ZIP?

No. The gallery gives each file its own "Download" link. It has no download
for the whole folder.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

## Sharing with clients, press and partners

### How do I send a press kit to journalists?

Put the files in a folder. Have an owner or admin give them a status that
allows public use and make the folder public. Send the folder's gallery
address from the box "Public link".

More: [Sharing and public links, Public folders](../files/sharing.md#public-folders)

### How do I give a client or an agency access to a set of files?

Share a folder with "Anyone with the link" and send them its gallery
address, or send the public links of single files. There is no sharing with
named outside people.

More: [Sharing and public links, General access](../files/sharing.md#general-access)

### Can I share different files with different clients?

Yes, with one public folder per client. Each folder has its own gallery
address. Keep in mind that anyone who has an address can open it.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

### Can I make a public link that only downloads and does not open in the browser?

No. There is one kind of public link. Whether it opens in the browser or
downloads depends on the file's type.

More: [Image delivery, Inline or download](../files/image-delivery.md#inline-or-download)

### Can Talewright add a watermark to files I share?

No. A public link serves the original, byte for byte. Image variants only
resize and convert a picture.

More: [Image delivery, Public links](../files/image-delivery.md#public-links)

### Can outside people comment on or approve a file I shared?

No. A public link serves the file and a gallery lists files. Neither takes
anything from a visitor.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

### Are the people I shared a file with told when I replace it?

No. The link simply serves the current version from then on.

More: [Sharing and public links, The public link](../files/sharing.md#the-public-link)

### Can I put a public link in an email or a newsletter?

Yes. A public link works for anyone who has it, without signing in, for as
long as the file is public.

More: [Sharing and public links, General access](../files/sharing.md#general-access)

### How do I share a file with a colleague who has an account?

Send them the address of the file's page in the app with "Copy link for
members". It works for people who can sign in and open the workspace, and
the file does not have to be public.

More: [Sharing and public links, Copy link](../files/sharing.md#copy-link)

## Agents and the API

### Which properties of a file describe its access in the API?

`visibility` (its own setting), `public` (whether anyone with the link opens
it now), `publicURL` (the link, or `null`), `publicVia` (the folder that
shares it), `status.allowsPublic` and `currentVersion.hasLocationData`.

More: [Sharing and public links, What a file and a folder say about access](../files/sharing.md#what-a-file-and-a-folder-say-about-access)

### Do files in a listing carry their `publicURL`?

No. A listing says whether each file is `public`. To get the link, read the
file on its own.

More: [Sharing and public links, What a file and a folder say about access](../files/sharing.md#what-a-file-and-a-folder-say-about-access)

### What does the request to set general access look like?

A `PUT` to the file's or folder's `visibility` with the body
`{"visibility": "public"}` or `{"visibility": "restricted"}`. It answers
`200` with the file or folder. It works only from a browser session.

More: [Sharing and public links, What the session-only operations take and return](../files/sharing.md#what-the-session-only-operations-take-and-return)

### How does an agent get a file made public?

It asks a person. It can prepare the ground: an agent with `files:approve`
sets a status that allows public use, and an owner or admin then shares the
file in the app.

More: [Sharing and public links, What the session-only operations take and return](../files/sharing.md#what-the-session-only-operations-take-and-return)

### Do organization folder files have the same sharing operations as workspace files?

Yes. Every operation has a twin for the organization folder (the API's
library) under `/v1/organizations/{organizationID}/library`, with a
capability ID that starts with `library.` and a tool that starts with
`library_`.

More: [Sharing and public links, For agents](../files/sharing.md#for-agents)

### Why does setting general access answer `422 VALIDATION_FAILED`?

`visibility` is missing or is not `restricted` or `public`.

More: [Sharing and public links, Errors](../files/sharing.md#errors)

### What should an agent do when a move answers `VISIBILITY_CHANGE`?

Nothing has moved. Show `details.becomePublic` and `details.stopPublic` to
the person it acts for, and repeat the request with
`confirmVisibilityChange: true` only when they agree.

More: [Sharing and public links, Moving a file into a public folder](../files/sharing.md#moving-a-file-into-a-public-folder)

### Should an agent retry a move refused with `INSUFFICIENT_SCOPE` or `MAKES_FILES_PUBLIC`?

No. Retrying does not help. A person with the right role moves the file, or
a credential that holds `files:approve` for an owner or admin does.

More: [Sharing and public links, Moving a file into a public folder](../files/sharing.md#moving-a-file-into-a-public-folder)

### What does a confirmed move into a public folder answer?

`200` with the file, now with `public` `true` and `publicVia` naming the
folder.

More: [Sharing and public links, Moving a file into a public folder](../files/sharing.md#moving-a-file-into-a-public-folder)

### How can an agent tell that a file is public only because of its folder?

Its `visibility` is `restricted`, its `public` is `true`, and `publicVia`
names the folder that shares it.

More: [Sharing and public links, Reading a file's access](../files/sharing.md#reading-a-files-access)
