Content Library

File Management in CloudFiles

28min

This is a detailed article on all the file related operations and information provided by CloudFiles. The list covers topics such as metadata of files available in CloudFiles, operations that can be done on various files, how to access these files, how these work with mirror storage etc...

Article Summary

Here is a section by section breakdown of this article -

  1. Accessing Files - This section talk about how to access your files in the CloudFiles content library and what information of the files you can see.
  2. Mirror Storage Support - This section gives an overview of how CloudFiles' file management works in tandem with mirror storage feature.
  3. Seeing File Info - This section talks about the various types of information available about the files from within CloudFiles such as preview, name, metadata etc...
  4. File Related operations - Here we talk about various file related operations that can be performed from the CloudFiles interface such as Upload, download, move, delete, replace, rename etc...
  5. File Type Support - We support all types of files. This section gives a brief on what this means.

Accessing Files

CloudFiles provides two ways to access your files. You can either connect your own storage, or use our CloudFiles library.

  1. Connecting Own Storage - This is called Mirror storage and works with various cloud storage providers such as SharePoint, Google Drive, Dropbox etc... CloudFiles does not store your file in such cases unless explicitly selected.
  2. Using CloudFiles Storage - You can also use the native CloudFiles library to upload your files and maintain a separate digital asset management system. You can even connect your own Amazon AWS S3 which is the storage that CloudFiles Library uses at the backend

Irrespective of what you choose, the CloudFiles interface looks and feels exactly the same way and exposes the same functions all over. In the sub-sections below, we talk a little more about these storage options and basic file operations such as upload, navigation and listing.

Mirror Storage

CloudFiles' mirror drive feature establishes a live sync of your cloud storage with CloudFiles features and interface. As soon as you connect your storage, your files & folders will show up instantly and you can use CloudFiles' automations, security, sharing, analytics etc... features on top of these.

Mirror storage is supported with Microsoft SharePoint, OneDrive, Google Drive, Dropbox, Box, HubSpot File Storage, Amazon AWS S3, Azure Blob Storage, R2 and other options as well.

To connect a mirror drive, simply access the Library tab on the app, locate the cloud storage on the left sidebar and Login into it. The steps are shown in the GIF below with an example of Google Drive.

Document image


CloudFiles Native Storage

If you decide to use the CloudFiles native storage instead of a mirror storage, this implies you are using our own multi-tenant Amazon AWS S3 to store the files. This type of usage might have some limits on the storage and transfer of files. You can also connect your own AWS S3 storage if you have one to do away with these limits.

Document image


Uploading Local Files

You can navigate to your library (native or mirrored) and upload a file into it using the CloudFiles interface. You can either drag and drop your files into the dialog or click on the upload area to select files using the file explorer. Depending on whether you are using CloudFiles Native Storage or Mirror Storage, these files will go into the respective storage.

Once you select a file from your local storage, it will take a few moments to upload it to CloudFiles. When the upload is finished, CloudFiles will automatically open the file screen where you can start creating secure & trackable links.

Document image


Importing files from Cloud

If you are using CloudFiles Native Storage above, you can also import individual files from another cloud storage into the CloudFiles Storage (i.e. AWS S3). Note that doing so implies that you are not using the mirror storage feature above. Thus your shared links or uploaded files will not reflect the changes you make in the other cloud storage. If instead you are looking for a 2-way sync between CloudFiles and your cloud storage, check the mirror storage section above.

In order to import files from another cloud storage, such as Dropbox, SharePoint, Google Drive etc..., you must first go to the CloudFiles library in the Libraries tab > Left sidebar and then click on Upload File button. In the upload modal, select the Cloud Storage option. You will be presented with a list of cloud storages that CloudFiles can import the file from. 

In the GIF below, we show a sample import from Dropbox.

Document image


Seeing File Information

CloudFiles offers a file details screen that can be easily navigated to, using the Content Library. This file details screen shows a a lot of useful information about the file. Here is a quick breakdown of how to access this screen and what all information is available.

File Listing Screen

Whenever you are on a folder details screen or on the root of your storage, you will see the listing of files in this location. The listing of files is shown as list items in the form of tiles. These list items can show various columns such as name, owner, analytics of the files. There are also file related actions that you can perform using the dropdown from the three dots at the end of the file list item as shown below.

Document image


File Details Screen

The File details screen can be accessed by clicking on a file that points to a file. The file details screen shows various information about the file such as it's name, size, owner, API metadata etc... The file information screen also the list of links associated to the file (if any links for this specific file have been created).

The following graphic shows the file details screen -

Document image


API Metadata

On the bottom right of the file details screen, you can see the API metadata. This is usually helpful when setting automations anchored on this particular file. There is a lot of useful information on HubSpot & Salesforce automations that can be setup using the app.

Document image


Previewing Files

Preview the file to ensure that the correct file has been uploaded. Note that sometimes it may take a while for the file to get processed, especially if you replaced the file. Refresh the preview screen if you see a similar message while previewing the file.

CloudFiles offers a special preview mode using which you can view any type of rendered files online and shows the file exactly as it would look to an external customer if shared as a CloudFiles Link. Previewing is not available for non-rendered files.

Document image


File Related Operations

Download a File

The download feature will download the file into your browser's default download location on your local storage. Simply go to the ellipsis button on the right. Here choose “Download”, your file will get downloaded in your browser’s default download location.

Document image


Move a File

Move function in the CloudFiles Content Library allows you to move your file across different existing folders or into the home directory of the content library. To move a file, select the move option in the ellipsis button on the right and select the folder where you want the file to be moved.

You can also move the file across storages. Simply select a location in a different storage in the move dialog.

Document image


Delete a File

Deleting a File in the CloudFiles content library removes the file from the CloudFiles database. Also any links shared will become defunct and show a “file not found error.” To delete a file, select the delete option in the ellipsis button on the right and choose OK.

Document image


Replace Files

You can replace files such as PDFs, images, PPTs & docs while preserving the same link. Many a times, there are last minute changes or new updates to be incorporated into your content, However the content links have already been shared with a number of recipients. In such cases it is recommended to use the CloudFiles Replace File feature to replace your files while retaining the functionality of the shared CloudFiles links. This feature just updates the content on all the existing links of that content.

Locate the file you want to replace. Click on the file name to open the file information screen. Click on Replace File button from the top right dropdown. Then upload a new file that you want to replace this file with. 

Note that replacing files does not change the existing files name. For that, do a file rename.

Document image


Renaming Files

You can also rename the files after uploading them as shown in the image below. Simply click on the 3 dots icon and choose rename. A dialog box opens up where you can type the new name of the file.

Document image


Organizing Files

You can easily organize all your uploaded files & folders online, using the CloudFiles' content library. CloudFiles allows deep folder hierarchy. This combined with the ability to easily move files across the library makes it easy to organize large number of digital files. You can read more about folder management in CloudFiles in the adjoining article.

Individual vs Bulk Operations

CloudFiles content library exposes these actions both as individual and as bulk actions. While some actions may not be available for bulk operations right now, we are always striving to improve this and add more stuff.

You can check whether the operation is available in bulk or not by checking the 2 screens below. The file information screen dropdown on top right are for individual actions. The file listing screen dropdown on the file list items are for bulk actions.

File Type Support

CloudFiles allows its users to upload any type of file. This means literally any format in the digital world can be uploaded into the content library and viewed online through a secure and trackable CloudFiles links. You will receive valuable insights on engagement of your content which can help you in pivoting your digital strategy. This even includes converting URLs to CloudFiles Links by uploading them through our dialog.

We categorize the files in two types, rendered and non-rendered, which makes it easy to see what type of functionality may be available where.

Rendered Files

These are files that can be rendered and viewed in the browser. E.g. consider a word document. If you upload a. ".doc" file into the content library, CloudFiles will generate a link to that file. On opening that link, you will be able to view the word file online, inside the browser itself and can scroll and read through.

Renderable files are supported for images, videos, readable files (docs, PDFs, PPTx), etc...  Viewing File Links in Browser can be used to view these files. 

If you find a file format that should be rendered in the browser but is not supported by CloudFiles, reach out to us on [email protected] and we will add support soon.

Document image


Non-rendered Files

These are non human readable files for which "viewing online in a browser" does not make much sense. This can include an exe or a zip file. CloudFiles directly downloads this file onto the viewer's system and tracks the file download. Thus, you can still upload these types of files into the content library and track analytics.

A sample non-rendered ZIP file is shown below -

Document image


Video Support in CloudFiles

CloudFiles is primarily meant for sharing business files externally with security protections. It also provides support for videos since many marketing and sales teams rely on those. There are two possible ways of viewing videos on the CloudFiles viewer:

  1. Uploading a video from your local storage or importing from google drive, one drive, dropbox, sharepoint or box. Steps for these are covered in File Access section above. Supported formats include MP4, MKV, MOV, AVI, FLV, MPEG-2 TS, MPEG-2 PS, MXF, LXF, GXF, 3GP, WebM, MPG, QuickTime.
  2. Using a url from Youtube, Vimeo and Dailymotion urls. The steps for creating a CloudFiles video link from a url is same as covered in the web URL sub-section below. The steps can be found here. Videos from other website domains are not supported right now.

Import a web url

CloudFiles allows you to track URLs & link clicks on your blogs / articles along with your shared documents, so now you can track your entire digital real estate from one place.

Select the Upload file option in the New Button, click on the URL tab. Here, you have to enter the url of the your webpage and give any custom name to it. Next click on Upload button. Thus, you can create one or multiple CloudFiles URLs for your webpage. You can track clicks and website visits on each of these links, thus making all your digital assets trackable.

Document image


File Size Support

CloudFiles does not put any restrictions on the file size. However, the backend storage you use might put a restriction on the maximum file size that you can upload / download / work with. Here are the choices that are offered by other storages -

  • CloudFiles - CloudFiles uses the Amazon AWS S3 storage by default. Thus, any restrictions on AWS S3 apply to CloudFiles storage as well. Amazon says their object size limit is 5 TBs.
  • SharePoint - SharePoint allows upwards of 10 GB+ per file. You can read about it here.
  • OneDrive - OneDrive can allow upto 250 GB file sizes. Here is more information.
  • Google Drive - Google also offers a whopping 5 TB limit but has other limits on daily uploads. Here is more information.
  • Dropbox - They can allow upto 100 GB or even more. More information can be found here.
  • Box - This can be 250 MBs to several GBs. Here is more info.