File Manager

Last updated:

In addition to the developer file system, the HubSpot File Manager can be used to store and serve files. All files uploaded to the File Manager are publicly accessible, may be indexed in search engines, and are served over our global content delivery network (CDN). The File Manager can be found at Marketing > File and Templates > Files in the top navigation menu.

File Manager

When to use the File Manager

The File Manager should be used for files that are intended to be utilized in file pickers throughout the HubSpot software. For example, to be selected an image in an image or rich text module. 

File Picker

Files uploaded to the File Manager can not be edited within the HubSpot app, other than minor image file editing. If you intend to be able to edit text-based files, they should be stored in the Design Manager. Additionally, text-based files uploaded to the File Manager will not be minified or modified in any way. If you wish to take advantage of HubSpot’s JavaScript minification and CSS minification and combination, store these files in the Design Manager. 

Uploading files to the File Manager

Files can be uploaded by navigating to the Manager at Marketing > File and Templates > Files in the top navigation menu, and selecting “Upload files”. Or, you can drag and drop files, or folders of files into the File Manager. 

Files can additionally be uploaded to the File Manager through the CMS CLI by using the hs upload filemanager command.

Using File Manager files

All files uploaded to the File Manager are accessible in the various file pickers throughout the CMS, such as in Rich Text or Image modules on pages. They're also available throughout the HubSpot app, like in Sales emails in the HubSpot CRM. 

File Manager files all have a public URL, which can be found by clicking on a file, and selecting “Copy URL”. File Manager files can be replaced to update files, by clicking on a file, and selecting “Replace.” When replaced, a file’s public URL will not change.

Optimizations

The HubSpot CMS automatically optimizes your File Manager files to ensure they can be delivered to visitors fast. File Manager files are automatically cached, compressed and resized to be served efficiently and accessible across all of your hosted domains to reduce cross-origin requests. Learn more about the HubSpot CMS CDN, Security, and Performance.

Serving HTML and JS files from the file manager

HTML and JavaScript files uploaded to the File Manager and served using a default HubSpot domain to serve files (think f.hubspotusercontentXX.net), use Content Type: text/plain . This means web browsers will not render and evaluate the code. Instead if a user goes directly to an HTML file there it will display the HTML code itself to the user. To avoid this, you must serve these files from one of your connected domains instead of a HubSpot default domain.