Use documents

Last updated: March 20, 2019

With the documents tool, you can build a library of up-to-date content for your entire team. Get instant alerts when contacts interact with your content and see aggregate metrics on your content performance. In this article, you'll learn how to:

Please note: free users can access the first five documents uploaded in an account. This means that if a free user is added to an account where five or more documents have already been uploaded, that free user will be able to view and use only the first five documents that were uploaded in that account. If no documents have been added to the account, the free user can upload up to five documents

Add a document

  • In your HubSpot account, navigate to Sales > Documents.
  • Click Upload new document, then select the import source for your file. Make sure your file adheres to the file type and size restrictions

Once the document has been uploaded, it will appear in your documents dashboard. 

Please note: as documents are publicly shared, the documents tool should not be used to send sensitive or confidential information.

Manage your document

Once you have uploaded your document to HubSpot:

  • Click the document name to access it for editing.
  • To edit the document title, click the pencil icon edit iniin the upper-left. Click Save when you're done.

  • To replace the existing document, click Re-upload at the upper-right, then select the source of the file from the dropdown menu.

  • To delete the document, click Actions > Delete in the upper-right. In the dialog box that appears, click Yes, delete document to confirm.

Set up your branding (Sales Hub StarterProfessional, or EnterpriseService Hub Starter, Professional or Enterprise only)

You can customize the branding on your documents.

  • In your HubSpot account, click the settings icon settings in the main navigation bar.
  • In left sidebar menu, select Account defaults.  
  • Click the Branding tab. 
  • Click Upload to add a logo, or click Browse images to use a image already uploaded to your file manager. 
  • Select a color or enter a custom hex color value to customize the color that will appear in the document viewer when you share your document. edit-branding-with-color-pickers
  • Click Save
  • In the dialog box, click Yes, change team branding

Please note: changes you make to your sales branding settings will apply to all users in all of your sales tools, except for the conversations tool 


Share your document

HubSpot will automatically apply tracking when you share a document, which will allow you to see if/when your prospect views the document. You can also require recipients to input their email address prior to viewing the content. There are four different ways to share documents:

  • From the documents tool
  • Your email inbox
  • In an email template
  • In a sequence

A note on GDPR-compliant documents

Complying with the General Data Protection Regulation (GDPR) involves some slight changes to your documents prior to sharing, as outlined below:

Please note: while these features live in HubSpot, your legal team is the best resource to give you compliance advice for your specific situation.

  • If the global GDPR functionality setting is enabled in your HubSpot account, all documents uploaded going forward will default to having privacy and consent enabled. You can enable it for previously uploaded documents prior to sharing by clicking the name of the document, then clicking to toggle the Enable privacy and consent (GDPR) switch on. With this enabled, your contacts will need to give consent to communication and data processing. The language will be pulled from your privacy and consent settings and will include a prompt for consent to your one-to-one communication subscription type automatically.
  • If the global GDPR functionality setting is disabled in your HubSpot account, no actions are taken on existing documents. Any new documents you create will default to having privacy and consent disabled. You can enable it for individual documents prior to sharing by clicking the name of the document, then clicking to toggle the Enable privacy and consent (GDPR) switch on. With this enabled, your contacts will need to give consent to communication and data processing. The language will be pulled from your privacy and consent settings and will include a prompt for consent to your one-to-one communication subscription type automatically.
  • The default subscription in documents is "one-on-one" communication. This an internal subscription type in your HubSpot account. This default subscription ID can be updated in your contacts and companies settings and will apply to newly created documents.

Share from the documents tool

  • In your HubSpot account, navigate to Sales > Documents.
  • Click the name of the document.
  • In the dialog box that appears, enter the recipient's email address under Who are you sending this to?
  • To track the individuals who view this document, click to the toggle Require email address to view document switch ON. 
  • Click Get link.

  • Click Copy to copy the document link or Email from CRM to navigate to the recipient's contact record.

Share from your email inbox

Insert document links in emails from your inbox using the HubSpot Sales Chrome extension or one of the add-ins: 

Share from an email template

  • In your HubSpot account, navigate to Conversations > Templates.
  • In the templates dashboard, click New template or click a template name to edit an existing template.
  • Click Document at the bottom of the template editor.
  • In the pop-up window that appears, select the Document and enter the link display text.
  • Select the Require email to view document checkbox to track individuals who view this document. 
  • Select the Include link preview checkbox to show a preview of your document in the email body.
  • Click Insert when you are done. 


Share from a sequence

When enrolling a contact in a sequence, click the documents icon documents in the bottom right corner of a template in the sequence editor dialog box. Select the document from the dropdown menu, edit the link text to display, and select whether you would like to require an email address and display a link preview. Then click Insert.
HubSpot Help article screenshot

Report on your document

You can review data about your documents in three ways. First, you'll receive instant, real-time notifications when your document is viewed. These views will appear on your activity stream, as well as on the contact record of the recipient.

Second, you can view document performance data in two reports on your reporting dashboard. 

  • Navigate to your HubSpot dashboards by clicking the sprocket icon sprocket in the top left corner of your account.
  • Click Add Report.

  • In the left sidebar menu, navigate to Sales Documents.
  • Here, you'll see a Documents Summary report, which gives you a high-level overview of how your documents are performing, and a Top Documents report, which shows your most popular documents.
  • Click Add to add a report to your dashboard. 

If you are a Sales Hub Professional or Enterprise user, you can view document performance data in the sales content analytics tool. 

  • In your HubSpot account, navigate to Reports > Analytics Tools.
  • Select Sales Content Analytics
  • Click the Documents tab. 
  • By default, you'll see data for all of your users. Click the Users dropdown menu to view data for a specific user. 
  • Click the Date range dropdown menu to view data over a specific time frame. If you select a date range consisting of a weekthe default starting day is Sunday.
  • Select the checkbox to the right of the document name to choose which documents you see data for. Click the name of the document to open the document summary page. 
Please note: if the Add button is grayed out on the reports, this indicates you've hit the reports limit (10) for that dashboard. In order to add more reports, you can create a new dashboard or remove reports from the current dashboard.
Free Inbound Marketing Training Learn inbound marketing techniques that range from creating content, using  social promotion, converting and nurturing leads, and all the way to marketing  to your customers. Start the course