What This Update Actually Is
HubSpot added a Source type dropdown to the Customer Agent source usage report. It sits right next to the existing Date range filter inside Customer Agent > Reports > Source Usage.
When you select a content type from that dropdown, two things update immediately. The Analyze table shows only sources of that type. The summary tiles, Unique Used Sources and Avg Conversations Per Source, recalculate to reflect only that slice.
The five content types you can filter on are hand-authored Q&A pairs, knowledge base articles, uploaded files, website pages, and imported URLs. The default view stays set to All types, so nothing breaks if you don't touch it.
Why HubSpot Shipped This
Customer Agent pulls from a wide mix of knowledge sources. That's its strength. But it was also quietly creating a reporting blind spot.
Before this filter, every source type landed in one flat list. If your agent was resolving conversations at a low rate, you had no clean way to tell whether the problem was your uploaded files, your imported URLs, or your knowledge base articles. You'd have to manually sort, cross-reference, and guess.
We've seen this pattern in portals across industries: the admins who built the agent did a great job setting it up, but over time the knowledge base drifted. Articles went stale. Uploaded files sat there doing nothing. Nobody could prove which type was underperforming, so nothing got fixed.
HubSpot shipped this filter so the humans managing Customer Agent can finally treat each content type as its own investment. You can evaluate it, improve it, and make deliberate decisions about where to put your content-building effort.
How to Use It Step by Step
- Navigate to Customer Agent in your HubSpot portal.
- Click Reports in the left sidebar, then select Source Usage.
- Locate the Source type dropdown. It sits directly next to the Date range filter at the top of the report.
- Choose a content type: Q&A, Knowledge Base Articles, Files, Website Pages, or Imported URLs.
- Read the updated Analyze table and the two summary tiles. Note which sources have high average conversations per source and which have low unique usage.
- Repeat for each content type. Build a simple comparison: which type drives the most resolved conversations per source? That's where your content effort is paying off.
- Identify the lowest-performing type. Decide whether to improve the existing content in that category or reduce its weight in favor of a type that's working.
What It Touches in Your HubSpot Strategy
This filter looks small. It isn't. It's a diagnostic tool that ripples into several areas of your portal strategy.
On the content and knowledge management side, this filter gives your content team a feedback loop they've never had before. If knowledge base articles are being used far more than imported URLs, that's a signal to invest in more structured, article-format content rather than raw URL imports. If Q&A pairs are driving the highest average conversations per source, that tells you hand-crafted answers outperform scraped pages for your specific audience.
Key Takeaway
Track Avg Conversations Per Source by type, not just in aggregate. A content type with fewer total sources but a high average is punching above its weight. Double down on it.
On the AI agent governance side, this connects directly to how you audit and maintain your agent over time. An agent that draws from five source types without any visibility into which ones perform is essentially a black box. This filter opens the box. It belongs in any regular Customer Agent review cadence, alongside conversation resolution rates and handoff triggers.
On the reporting and operations side, this is exactly the kind of granular data your operations team needs to justify where knowledge management time goes. If you're already working to centralize your data visibility, this filter slots cleanly into that effort.
If you're consolidating how you monitor connected data sources across your portal, check out our breakdown of HubSpot Data Studio and what it means for data management. The pattern is the same: more visibility, less guessing.
On the service strategy side, Customer Agent is your first-line responder for customer questions. If it's underperforming because certain source types are dragging the average down, you're not just wasting content effort. You're creating friction for real humans who needed a fast, accurate answer and didn't get one.
Key Takeaway
Run this filter monthly. Set a simple benchmark: every source type should contribute at least one resolved conversation per source on average. Any type that misses that benchmark for two consecutive months deserves an audit.
If you're still learning how HubSpot's AI layer actually works in practice, our article on what Breeze can actually do inside your portal gives you the strategic foundation to make sense of updates like this one.
Who Should Care Most
This filter is most immediately valuable to three groups of humans.
- Service Hub admins who own Customer Agent configuration and need to justify content investments to leadership. This gives you clean, type-by-type performance data you can put in a slide.
- Knowledge base managers and content strategists who are deciding whether to write more articles, build more Q&A pairs, or pull in more website pages. This filter tells you which format is working before you commit hours to more of it.
- RevOps leads at companies where Customer Agent handles a meaningful volume of inbound support conversations. If your agent is resolving even 20 to 30 percent of incoming chats, a performance gap by source type is a real cost center.
This update is available across every major HubSpot hub at Professional and Enterprise tiers, including Content Hub, Service Hub, Marketing Hub, Sales Hub, Data Hub, and Smart CRM. It also applies if you're running on HubSpot Credits. In other words, almost every professional HubSpot portal can use this today.
If you're on Starter or Free, Customer Agent isn't available to you yet. That tier gap is worth knowing before you plan a roadmap around it.
George's Take
What I love about this update is that it forces a discipline most teams skip. When we audit Customer Agent setups, we almost always find at least one source type that's sitting in the mix but contributing almost nothing. The admins who built it had good intentions, but without data to call out the dead weight, nobody ever cleans it up. This filter removes the excuse. You can now see, in two clicks, whether your imported URLs are pulling their weight or just adding noise. That's the kind of operational clarity that makes AI agents trustworthy instead of just trendy.
“An AI agent is only as good as the knowledge it draws from. This filter finally lets you grade that knowledge by format, not just by gut feel.”
If you're watching HubSpot's AI reporting tools expand, this update pairs well with the recent changes to HubSpot's MCP server and its new reporting and intent signal capabilities. The direction is clear: HubSpot wants every AI-driven action in your portal to be measurable and improvable.
If your Customer Agent isn't performing the way you expected, or if you've never done a structured audit of your knowledge sources, we can help. Book a strategy call with the Sidekick team and we'll walk through your source usage data with you, identify the gaps, and build a plan that makes your agent worth the investment.
Frequently Asked Questions
What is the source type filter in HubSpot Customer Agent?
It's a dropdown in the Customer Agent source usage report that lets admins filter performance data by content type: Q&A pairs, knowledge base articles, uploaded files, website pages, or imported URLs. When selected, the Analyze table and summary tiles update to show only sources of that type, making it easy to compare which format drives the most resolved conversations.
Where do I find the source type filter in HubSpot?
Go to Customer Agent in your HubSpot portal, click Reports in the sidebar, then select Source Usage. The Source type dropdown appears next to the Date range filter at the top of the report. Select any content type to filter the full report instantly. No additional setup is required.
Which HubSpot plans include Customer Agent and this filter?
Customer Agent is available on Professional and Enterprise tiers across Content Hub, Service Hub, Marketing Hub, Sales Hub, Data Hub, and HubSpot Smart CRM. It's also available to HubSpot Credits customers. Free and Starter tier portals don't have access to Customer Agent at this time.
Why does it matter which source type my Customer Agent uses most?
Different content types perform differently for different audiences. If your knowledge base articles resolve far more conversations than your imported URLs, that's a signal to invest in article-format content rather than URL imports. Without filtering by type, you can't make that call. You're just maintaining all sources equally whether they earn it or not.
What are the two key metrics in the Customer Agent source usage report?
The two summary tiles are Unique Used Sources, which shows how many distinct sources of a given type were referenced by the agent, and Avg Conversations Per Source, which shows the average number of conversations each source contributed to. Together they tell you both reach and efficiency for each content type.
How often should I check the Customer Agent source usage report?
A monthly review is a solid starting cadence. Filter by each content type and note which types are below your average for conversations per source. Any type that underperforms for two or more consecutive months is a candidate for an audit, whether that means improving the content, removing low-value sources, or shifting your knowledge-building effort to a higher-performing format.
