What This Update Actually Is
HubSpot shipped a full redesign of the guidelines interface inside Customer Agent. The old layout was a single fixed form. The new one is a card-based system where you can create multiple named guidelines inside each category.
There are three categories: Communication Style, Guardrails, and Custom. Each category can now hold as many guidelines as your support strategy needs. You can assign individual guidelines to specific audience segments, search and filter across all of them from one view, and save in draft or published states.
First-time users see a 'Pick a starting point' grid that generates a bundled set of guidelines automatically. That alone removes a significant barrier for teams who've been avoiding setup because they didn't know where to begin.
Existing customers don't need to touch anything. HubSpot migrates current guidelines automatically.
Why HubSpot Shipped This
The old interface forced every guideline into a single form. If you supported multiple audience types, say enterprise accounts versus small business customers versus trial users, you had no clean way to separate the rules for each. Everything lived in one flat list.
That creates a real internal frustration. You know your AI agent should behave differently depending on who it's talking to, but the tool isn't giving you the controls to make that happen. So either you write one generic guideline set that serves nobody well, or you start hacking workarounds.
HubSpot built this redesign to match the complexity real service teams are actually running. As AI agents handle more of the front-line support load, the configuration layer needs to be just as sophisticated as the workflows behind it.
How to Use It Step by Step
- Navigate to the Customer Agent Guidelines page inside your Service Hub settings.
- If you're setting this up for the first time, select 'Pick a starting point' from the grid. HubSpot creates a bundle of guidelines for you. Treat it as a draft, not a final config.
- Choose a category: Communication Style for tone and language, Guardrails for what the agent should never do or say, Custom for anything that doesn't fit the other two.
- Create multiple named guidelines inside each category. Give each one a clear name so your team can find it fast. Names show on the card in the main view.
- Assign each guideline to a specific audience segment. This is where the real power sits. An enterprise segment can get a formal communication style while a trial user segment gets a warmer, more educational tone.
- Use the search bar and segment filter in the main card view to find what you need quickly as your guidelines library grows.
- Save explicitly. HubSpot shows a draft or published indicator on each card. Don't assume auto-save. Publish only when a guideline is tested and ready.
- To delete a guideline, use the card menu. HubSpot prompts a confirmation and removes both draft and published versions in one action.
What It Touches in Your HubSpot Strategy
This update is scoped to Service Hub, but its effects reach further than the guidelines page. How your AI agent behaves is directly tied to what your knowledge base feeds it and how your support tickets flow. Change the guidelines and you're changing the front-line output of the entire service layer.
The segment-targeting feature connects tightly to your CRM data. For segment assignment to work well, your contact and company records need clean, consistent segmentation properties. If your audience definitions are fuzzy in the CRM, the agent's behavior will be fuzzy too.
Key Takeaway
Segment targeting in Customer Agent guidelines is only as strong as your CRM segmentation. Clean contact properties before you build audience-specific guideline sets.
This update also interacts with how HubSpot reports on agent performance. If you're already using the source usage report to see which content your agent leans on, adding segment-specific guidelines gives you a new variable to track. You can start asking whether certain segments are resolving faster because their guidelines are tighter.
If you haven't looked at the Customer Agent source usage report with source type filtering, now is the right time. Pair that reporting layer with the new guideline structure and you'll have a much clearer picture of what's actually driving resolution.
The guardrails category deserves specific attention. This is where you define what the agent absolutely cannot do: topics it must avoid, claims it must never make, escalation triggers it always honors. With the old single-form design, guardrails often got buried. The card layout surfaces them clearly and lets you maintain separate guardrail sets by segment if your compliance needs vary across customer types.
Key Takeaway
Build your Guardrails guidelines first. They protect your brand and your customers before anything else. Get those published, then layer in Communication Style and Custom guidelines.
Teams who recently configured ticket reopening management in Help Desk will recognize the same pattern here: HubSpot is giving service admins more granular control over what happens at each decision point in the support experience. These updates compound each other.
Who Should Care Most
This update matters most to three kinds of humans.
- Service Hub admins managing Customer Agent for multiple customer segments who've been working around the single-form limit. The new UI was built for your use case.
- RevOps leaders who own the handoff between CRM data and service tooling. The segment targeting feature connects your audience definitions directly to AI behavior. That's a RevOps concern, not just a support one.
- Humans who are new to Customer Agent entirely. The starting-point template grid removes the blank-page problem. You don't need to know what a good guideline set looks like on day one. HubSpot gives you a scaffold to start from.
Professional tier customers have access to this. Enterprise customers get it too and will benefit most from the segment complexity the new UI supports. If you're on Starter, this isn't available yet.
George's Take
I've been inside a lot of portals where Customer Agent is technically turned on but the guidelines are essentially empty or generic. Humans set it up once, it sort of works, and nobody goes back to refine it. That's not a laziness problem. That's a tool problem. The old interface made iteration feel like too much friction. This new card-based layout changes the dynamic. It's the kind of UI that invites you to keep building. When you can see all your guidelines at a glance, name them clearly, filter by segment, and toggle draft versus published, suddenly the configuration becomes a living document instead of a one-time setup you're afraid to break.
“A guideline your team won't update is a guideline that's already out of date. The new UI finally makes iteration feel natural instead of risky.”
If your team is still in the early stages of getting Service Hub configured, read our piece on the real HubSpot onboarding timeline. Customer Agent setup is one of those pieces that's worth getting right in the first 90 days, and this new UI makes that easier than it's ever been.
If you want help building a Customer Agent guideline strategy that's tied to your actual audience segments, not just the defaults, that's exactly the kind of work we do at Sidekick Strategies. Book a strategy call and we'll walk through your current setup together.
Frequently Asked Questions
What is the new Customer Agent Guidelines UI in HubSpot?
HubSpot replaced the previous fixed-form guidelines interface with a card-based layout. You can now create multiple named guidelines per category, assign them to specific audience segments, filter and search across all guidelines in one view, and use starter templates to build your initial configuration quickly.
Do I need to redo my existing Customer Agent guidelines after this update?
No. HubSpot automatically migrates existing guidelines to the new layout. You don't need to take any action. Once migrated, your guidelines appear as cards in the new interface and you can edit, reorganize, or expand them at any point.
What are the three Customer Agent guideline categories?
The three categories are Communication Style, Guardrails, and Custom. Communication Style controls tone and language. Guardrails define what the agent must never do or say. Custom handles anything that doesn't fit the other two. Each category supports multiple named guidelines.
Can I target Customer Agent guidelines to specific audience segments?
Yes. The redesigned UI lets you assign individual guidelines to specific audience segments. This means your enterprise customers can get different agent behavior than trial users or small business contacts, as long as your CRM segmentation properties are clean and consistent.
Who has access to the new Customer Agent Guidelines UI?
The updated Customer Agent guidelines interface is available to all HubSpot Professional and Enterprise customers. Starter tier customers don't have access to Customer Agent. There's no additional cost for Professional or Enterprise customers who already have Customer Agent enabled.
What happens when I delete a Customer Agent guideline?
Deleting a guideline triggers a confirmation prompt. Once confirmed, HubSpot removes both the draft and published versions of that guideline in a single action. There's no partial deletion, so review carefully before confirming. Deleted guidelines can't be recovered from the UI.
