How to Manage File Permissions

There are two options for the visibility permissions of files in a Space:

  • Public, meaning anyone on the internet can view the contents.
  • Private, meaning only owners can view the contents.

File permissions can be set when the files are staged for upload, updated in bulk within a directory using the Actions menu, or changed on a per-file basis. Owners can also create Quick Share links, which provide time-bound permission to view a private file.

By default, file permissions are set to Private. Some third-party tools provide support for changing the default permissions, but there is currently no way to do so in the control panel.

Change File Permissions

In your Spaces page, you can change an individual file’s permission by opening its More menu and selecting Manage Permissions. You can also manage metadata for multiple files at once by selecting them, opening the Actions menu, and choosing Manage Permissions.

Screenshot of the More menu

From there, choose Public or Private and click Update.

Screenshot of Private/Public radio buttons with Public selected

You should verify the changes after you change the permissions of a file.

Check File Permissions

Mouse over the file in your Space. The tooltip that opens shows the Permission, which is either Public or Private.

Screenshot of file information

If you copy the URL to view it in a web browser, a public file will be visible, but a private file will display an AccessDenied message for anonymous visitors:

<Error>
  <Code>AccessDenied</Code>
  <BucketName>space-one</BucketName>
  <RequestId>tx00000000000000385e4da-0059bad671-1067e-nyc3a</RequestId>
  <HostId>1067e-nyc3a-nyc</HostId>
</Error>

Create Quick Share Links

Owners can give time-bound permission to view a private file by creating a pre-signed URL, also known as a Quick Share link, for an individual item. The sharing duration can last 1 hour, 6 hours, 1 day, 3 days, or 7 days, and anyone with the link will be able to view a private file during the specified time interval.

To create a Quick Share link, from the file’s More menu, select Quick Share.

Screenshot of the More menu

In the modal that opens, choose the sharing duration.

Screenshot of Quick Share dialog

The link will appear in the File URL field, and includes a Unix timestamp in the Expires parameter.

This feature is intended to provide time-bound access to a private resource. The Quick Share link for a Public file is the same as the file’s public URL and has no expiration date. If you make the file private, the link would not grant access.