How to Attach Documents to Content in Hubspot

When building website pages, landing pages, or blog posts in Hubspot, you often need to attach documents such as PDFs, spreadsheets, or presentations. This guide explains every supported method so you can add files as downloads, links, and buttons in a clean, trackable way.

The instructions below are based on the official Hubspot knowledge base and walk you through adding documents from rich text modules, CTAs, and anchor text links.

Understanding Document Attachment Options in Hubspot

In Hubspot content editors, documents are not “embedded” as full viewers by default. Instead, they are added as links or downloads that visitors can click. You can attach documents in several places:

• Inside rich text modules on pages or blog posts
• Within buttons and calls-to-action (CTAs)
• As linked text within your copy
• From the file manager when you upload files

All of these options are available in the drag-and-drop editors for website pages, landing pages, and blog posts.

Prerequisites Before Attaching Documents in Hubspot

Before you start, make sure you have the right access and file types:

• Permissions to edit website pages, landing pages, or blog posts
• Files in a supported format (for example PDF, DOCX, XLSX, PPTX, images, or text files)
• Access to the file manager in your Hubspot account

It is usually easier to upload documents directly from the page editor, but you can also upload them into the file manager first and reuse them later across Hubspot content.

How to Attach a Document in a Hubspot Rich Text Module

The most common way to add files is to attach a document as a link inside a rich text module.

Step 1: Open Your Hubspot Content Editor

1. In your Hubspot account, navigate to Marketing > Website or Landing Pages, or open your blog tool.
2. Locate the page or post where you want to attach the document.
3. Click Edit to open the content in the editor.

Step 2: Select the Rich Text Area

1. Click the rich text module where you want the document link to appear.
2. Highlight the text that should become the clickable document link, or place your cursor where you want to insert a new link or button.

Step 3: Attach the Document from the Toolbar

1. In the rich text toolbar, click the Insert or Link icon (depending on your editor layout).
2. Choose the option to add a File or Document.
3. In the file picker that opens, either:

• Select an existing document already stored in your Hubspot file manager, or
• Click Upload files to upload a new document from your computer.

4. After selecting the file, confirm to insert it. The highlighted text now becomes a link pointing to the selected document.

When visitors click this link on your Hubspot page or post, the document will download or open in a new tab depending on the file type and browser settings.

Attaching Documents to Buttons or CTAs in Hubspot

You can also attach a document to a button or call-to-action (CTA) rather than plain text. This is useful for offering downloadable resources.

Step 1: Add or Select a Button in Your Hubspot Page

1. Open the page or landing page editor in Hubspot.
2. Insert a Button module if there is not one already on the page.
3. Click the button to edit its settings.

Step 2: Link the Button to a File

1. In the button settings, look for the Link to or URL option.
2. Select the option to link to a File instead of an external URL or page.
3. Choose a document from your file manager, or upload a new one.
4. Save or apply the changes. The button now downloads or opens the selected file when clicked.

If you use Hubspot’s advanced call-to-action tools, you can follow a similar process in the CTA editor: set the CTA URL to a file instead of a webpage so clicks will lead to the attached document.

Managing Documents in the Hubspot File Manager

All documents attached to content are stored in the file manager, which is shared across your Hubspot account. This lets you reuse the same file on multiple pages.

How to Upload Documents via the File Manager

1. In Hubspot, go to Marketing > Files and Templates > Files.
2. Click Upload files.
3. Select the documents you want to upload from your computer.
4. After upload, you will see a file URL that Hubspot uses whenever you attach that document to content.

Later, when editing content, you can pick these stored documents directly without re-uploading. This is especially helpful for common resources you reference often across Hubspot pages.

Best Practices When Attaching Documents in Hubspot

To provide a better visitor experience and keep your Hubspot content organized, use the practices below.

Use Clear Link Text

• Use descriptive anchor text such as “Download the pricing guide (PDF)” instead of “Click here”.
• This improves both accessibility and SEO on your Hubspot pages.

Keep File Names Clean

• Before uploading, rename your files with clear, readable names (for example, 2024-feature-overview.pdf).
• Avoid long, cryptic names that are hard to understand inside Hubspot or by visitors.

Organize Files into Folders

• Use folders in the file manager to group documents by project, product, or content type.
• This makes it faster to find the correct file when editing Hubspot content later.

Update Files Without Breaking Links

• If you need to update a document, you can replace it in the file manager rather than creating a new file.
• This keeps the URL stable so existing links on Hubspot pages continue to work.

Troubleshooting Document Links in Hubspot

If your document is not showing or downloading as expected, review these points:

• Confirm your page or blog post is published in Hubspot, not just in draft.
• Check that the file is published and not deleted or moved in the file manager.
• Verify you selected File as the link type in the rich text or button settings, not an external URL.
• Preview the page in an incognito browser window to confirm how visitors see the document link.

If you still experience issues, compare your setup with the steps in the official documentation for attaching a document to content in Hubspot, available at this Hubspot help article.

Next Steps for Optimizing Content and Documents in Hubspot

Once you are comfortable attaching documents, you can deepen your optimization efforts:

• Track link clicks to measure which resources are most popular.
• Use CTAs pointing to high-value downloads to capture more leads.
• Align document titles and link text with your broader SEO strategy in Hubspot.

For additional strategic guidance on digital optimization, you can explore resources from Consultevo alongside your Hubspot setup.

By following these structured steps and practices, you can consistently attach and manage documents across your Hubspot website pages, landing pages, and blog posts, giving visitors easy access to downloads while keeping your file library organized and efficient.

Need Help With Hubspot?

If you want expert help building, automating, or scaling your Hubspot , work with ConsultEvo, a team who has a decade of Hubspot experience.

Scale Hubspot

“`