Skip to content

Manage the URL of files uploaded to the files tool

Last updated: May 22, 2024

Available with any of the following subscriptions, except where noted:

All products and plans

All files in your files tool 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 domains connected in HubSpot

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 URL in the file manager. 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 

Depending on your account's subscriptions, you may be able to connect a domain to HubSpot. 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
  • 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. 
  • 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. 

  • Navigate to the files tool:
    • In your HubSpot account, navigate to Library > Files.
    • If you have a Marketing Hub Starter account, navigate to Marketing > Files
    • If you're using HubSpot’s free tools, navigate to Marketing > Email. In the left sidebar menu, click the More tools dropdown menu, then select 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 still remain accessible at the previous URL so there's no need to add an explicit 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:

  • Navigate to the files tool:
    • In your HubSpot account, navigate to Library > Files.
    • If you have a Marketing Hub Starter account, navigate to Marketing > Files
    • If you're using HubSpot’s free tools, navigate to Marketing > Email. In the left sidebar menu, click the More tools dropdown menu, then select 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.
Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.