Here's a pattern we see constantly across portals: a visitor starts a chat conversation, the agent asks for a document, and then everything breaks down. The visitor has to stop, open their email, attach the file, and start a completely separate thread. Context is lost. The AI agent has no idea what the human agent already heard. The customer is frustrated before the real help even starts.
This update closes that gap. It's a small change on the surface and a meaningful one underneath.
What This Update Actually Is
HubSpot added a file attachment option to the Customer Agent chat widget. Visitors can now upload a PDF, up to 10MB, and it posts directly into the conversation thread. No redirects. No separate uploads. No email handoff.
The file is immediately visible to both the AI agent and any human agents handling the ticket. That means the full conversation, including the document, lives in one place from the start.
The feature is available now. It works inside the existing Customer Agent widget with no rebuild required.
Why HubSpot Shipped This
Customer Agent is HubSpot's AI-powered chat agent, built to resolve support conversations without human intervention wherever possible. The problem is that some support conversations can't move forward without a document. A warranty claim needs the warranty. A contract dispute needs the contract. A benefits enrollment question often needs the form.
Without attachment support, the AI agent hit a wall the moment a document was needed. The only options were to ask the visitor to describe the document in text (inaccurate and slow) or to push the conversation to email (context loss, channel switch, frustrated humans).
HubSpot shipped this so Customer Agent conversations can stay complete. A fully contained thread is easier to resolve, easier to audit, and easier to hand off if a human needs to step in.
How to Use It Step by Step
There's no toggle to flip. The attachment option appears automatically in your Customer Agent widget if your portal meets the tier requirements. Here's how to make sure it's working and how to get the most out of it:
- Confirm your Customer Agent is active. Navigate to Service Hub and open your Customer Agent configuration. If it's live, the PDF attachment option is already available to visitors.
- Test the widget yourself. Open your site's chat widget, start a conversation, and look for the file attachment icon. Attach a test PDF under 10MB and verify it appears in the conversation thread inside your portal.
- Update your Customer Agent knowledge and instructions. If your AI agent handles warranty claims, contract reviews, or form submissions, add instructions that tell it how to respond when a PDF is attached. For example, instruct it to acknowledge the file, confirm what the visitor needs help with, and route accordingly.
- Set escalation rules for PDF conversations. Not every PDF can be handled by AI. In your routing settings, consider creating a rule that escalates conversations with attachments to a human agent if the topic is complex or legally sensitive.
- Brief your support team. Human agents who pick up escalated conversations will see the PDF inline. Make sure they know where to find it and that they don't need to ask the visitor to resend anything.
- Review ticket records after launch. Check that attached PDFs are appearing correctly inside your Help Desk ticket records, not just in the chat transcript. If you're using automation to tag or route tickets, verify those workflows still fire correctly.
What It Touches in Your HubSpot Strategy
This update looks like a chat feature. It's actually a data and process feature. Here's where the ripple goes.
Ticket records get richer. A PDF attachment inside the conversation means your ticket record now contains the actual document, not a description of it. That's cleaner context for your support team, better records for compliance, and a stronger audit trail if a dispute comes up later.
Key Takeaway
A PDF in the conversation thread becomes part of the ticket record. That's audit-ready context your team didn't have before, without any extra data entry.
AI agent quality improves for document-heavy use cases. Industries that rely on forms, policies, contracts, and certifications have always had a harder time getting value out of AI chat. That barrier just got lower. The AI agent can now receive the document the visitor is asking about, which gives it far better inputs for routing and responding.
Handoffs between AI and human agents get smoother. When a human agent joins a conversation, they walk in with the full picture, including any PDF the visitor shared. We've seen this pattern matter most in financial services, insurance, and legal-adjacent industries where context loss is expensive.
If you've been following the recent Customer Agent expansion, you already know this tool is growing fast. The May 2026 Customer Agent updates added payment links, invoice lookup, and segment-based personalization. PDF attachments fit right into that trajectory: Customer Agent is becoming the channel where entire service interactions happen, start to finish.
If you want the full picture of where HubSpot's AI agent layer is heading, the HubSpot Agentic Platform deep dive is worth reading before your next portal review.
Key Takeaway
Customer Agent is evolving into a full-service channel. Every update, including PDF attachments, is a building block. Your AI agent strategy should be mapped out now, not after the platform catches up with your backlog.
Workflow and automation implications are light for now. There's no native trigger yet for "conversation contains attachment," so you can't build a workflow that fires the moment a PDF lands. Keep an eye on that gap. It's the logical next step and a good item to watch in future releases.
If you've already configured off-hours messaging for Live Chat, it's worth revisiting how that flow handles a visitor who tries to attach a PDF outside business hours. Check how HubSpot's off-hours chat capture works and make sure the visitor experience stays smooth even when no human is available.
Who Should Care Most
This update matters most to the humans running support-heavy operations where documents are part of every service interaction. Specifically:
- Service Hub admins and support managers who configure Customer Agent: you'll want to update your agent's instructions and escalation rules to account for PDF conversations.
- Companies in financial services, insurance, healthcare, legal, and SaaS with contract-heavy onboarding: these are the industries where document friction in support is most expensive. This update removes a real barrier.
- RevOps and operations leaders who own the handoff between AI and human agents: this is a data quality win. Richer ticket records mean better reporting and cleaner escalation paths.
- Marketing Hub and Content Hub teams using Customer Agent for lead qualification or onboarding flows: if your process ever requires a form or signed document, this removes the awkward channel switch.
If you're running Customer Agent purely for FAQ-style deflection and your visitors never need to share a document, this update won't change your day much. But if document exchange is part of how your support conversations resolve, this is a real quality-of-life improvement for your customers and your team.
George's Take
I've sat with enough support teams to know that the moment you ask a customer to "just send it to your email," you've lost something. You've lost the thread, the context, and a piece of the customer's trust. PDF attachments inside Customer Agent fix one of the most friction-filled moments in an AI-assisted support conversation: the document handoff. What I want to see next is a workflow trigger that fires when a PDF lands in a conversation, because that's when this feature goes from useful to genuinely powerful. For now, the right move is to update your Customer Agent instructions today so the AI knows what to do when a document arrives, and brief your human agents so they're not asking the customer to resend something that's already sitting right there in the thread.
“The moment you ask a customer to 'just send it to your email,' you've lost the thread, the context, and a piece of their trust. PDF attachments in Customer Agent fix that.”
If you want help configuring Customer Agent to handle document-heavy conversations or you're ready to map out a full AI agent strategy for your portal, let's talk. Book a strategy call with the Sidekick team and we'll show you exactly where to start.
Frequently Asked Questions
What file types can visitors attach in HubSpot Customer Agent?
Currently, HubSpot Customer Agent supports PDF attachments only. Visitors can upload any PDF file up to 10MB directly inside the chat widget. Other file types are not supported in this release. The file posts into the conversation thread instantly, visible to both the AI agent and any human agents who join.
Does the PDF attachment appear in the HubSpot ticket record?
Yes. When a visitor attaches a PDF in a Customer Agent conversation, the file becomes part of the conversation thread, which is tied to the ticket record in HubSpot. Human agents who open the ticket will see the attachment inline without needing to ask the visitor to resend it.
Which HubSpot plans include PDF attachments in Customer Agent?
PDF attachments in Customer Agent are available on Professional and Enterprise tiers across Content Hub, Marketing Hub, Sales Hub, Service Hub, Data Hub, and Smart CRM. Free and Starter plans are not included in this release.
Can the Customer Agent AI read or analyze the PDF content?
HubSpot's release notes confirm the file is visible to the AI agent in the conversation. However, the depth of AI analysis on PDF content depends on your Customer Agent configuration and the capabilities of the underlying AI model. Update your agent's instructions to guide it on how to respond when a PDF is received.
Do I need to change any settings to enable PDF attachments in Customer Agent?
No. If your portal qualifies by tier, the attachment option appears in the Customer Agent chat widget automatically. There's no toggle to enable. You should update your Customer Agent's instructions and escalation rules to account for conversations that include attachments, but no technical setup is required.
Can I build a HubSpot workflow that triggers when a PDF is attached in Customer Agent?
Not yet. There's no native workflow trigger for 'conversation contains attachment' in the current release. You can still use existing ticket-based workflows. Watch for this capability in future HubSpot updates, as it's the logical next step for making attachment support more automated.
