Manage the URL of files uploaded to the files tool

All files in the files tool will have a unique file URL. You can use HubSpot Content Delivery Network (CDN) domain for hosting, or customize a file's URL to be hosted on any of your connected domains. 

If you want the URL of your file to be removed from search engine results, or hidden from anyone outside your team, you can customize the visibility settings of your file. By default, all files attached to CRM records are private and hidden from search results.

Before you get started

When using the files tool, please note the following:

• Files uploaded to the files tool are hosted on a public CDN file URL by default. HubSpot does not support the management of sensitive information. For more information, please see our Terms of Service.
• When visitors to your website load files on one of your pages, HubSpot may rewrite the domain of the associated file URLs to match the domain of the current page. Learn more about domain rewriting in HubSpot's developer documentation.
• If you're experiencing loading images on HubSpot pages, please add these domains to your network or office's firewall allowlist and try again:
  • [HubID].fs1.hubspotusercontent-na1.net
  • [HubID].fs2.hubspotusercontent-na1.net
  • [HubID].fs1.hubspotusercontent-eu1.net
  • [HubID].fs2.hubspotusercontent-eu1.net

Change the default URL for your files 

After connecting a domain to HubSpot, you can change the default file URL that appears in the File URL by domain dropdown menu.

To change the URL of your files: 

• In your HubSpot account, click the settings settings icon in the top navigation bar.
• In the left sidebar menu, navigate to Content > Pages. 
• At the top, click the SEO & Crawlers tab. 
• In the Default File Manager Hosting Domain section, click the dropdown menu and select a domain. Any connected domain can be used as the default hosting domain. 
• In the bottom left, click Save to update your settings.
  
  

Share your files with different domains 

If you've connected a domain to HubSpot, you can change the File URL by domain dropdown menu. This will allow you to share your files with different domains. 

• In your HubSpot account, navigate to Library > Files.

• Locate the file and click the file name. 
• In the right pane, click the File URL dropdown menu and select the URL you want to use. The different URL options are based on the domains you have connected to HubSpot:
  • When you upload a file to the files tool with public visibility, HubSpot automatically creates multiple working URLs for the file at each of your connected subdomains, as well as the default [HubID].hubspotusercontent-[Region].net domain.
  • If you change the File URL of one of your files from one subdomain to another, the file will remain accessible at the previous URL. You do not need to add a redirect for the file.
• Click Copy URL to use or share this URL.
   

Customize the visibility of your file URL

By default, files uploaded to the files tool are hosted on a public file URL and indexed by search engines. This means anyone with a direct link to the file URL can view this file on their web browser. It also means the file URLs are indexed by search engines and may appear in search results.

Please note: you cannot customize the visibility of a video URL with advanced features turned on. Learn more about working with video files. 

You can customize the visibility of your file URL in the File details panel:

• In your HubSpot account, navigate to Library > Files.

• Locate the file and click the file name. 
• In the File details panel, check the File URL visibility on the web setting. To customize this setting, click the dropdown menu and select another option:
  • Public: the file URL will be publicly accessible to anyone who has or guesses the file URL. Search engines will be able to index the file URL.
  • Public - noindex: the file URL will be publicly accessible to anyone who has or guesses the file URL. Search engines are instructed not to index the file URL.
  • Private: the file URL will be private and require a URL to access. Search engines will not be able to index the file URL. After setting the file visibility to Private, choose from the following File URL options. 
    • Internal share link: the file URL will only be accessible to other users logged into the same HubSpot account, this will link directly to the file itself. 
    • Link to file preview: the file URL will only be accessible to other users logged into the same HubSpot account, this will link to a preview page for the file. 
    • Temporary 24hr public share link: the temporary file URL will be publicly accessible to anyone who has or guesses the URL, and will expire after 24 hours. If you would like to temporarily share the file again, you can create another share link.