Skip to content
Tutorials Center
My learning

Topics

Lesson 21 of 37 ยท Service Hub

Knowledge Base and Help Desk in HubSpot

Learn how HubSpot's knowledge base articles, help desk workspace, canned snippets and deflection metrics reduce support load, with a runnable article-search and deflection model.

The cheapest ticket is the one never created. A knowledge base lets customers find answers themselves, and the help desk gives your team a single workspace for the questions that remain. Together they form the self-service and assisted halves of Service Hub.

HubSpot is not available on this site. The Python snippets are stand-ins that illustrate how search ranking and deflection arithmetic work; the product's own search is different. Feature availability depends on your plan, so confirm in your account.

The knowledge base

Create articles in Service > Knowledge Base. Each article has a title, body, a category (the folder structure), a state (draft, published, unpublished), a URL slug, and meta description. You can attach a custom domain such as help.example.com and brand the site with a theme.

Practical rules for good articles:

  • One problem per article, with the customer's own words in the title ("Reset my password" beats "Credential recovery procedures").
  • Start with the answer, then add steps and screenshots.
  • Link related articles and end with "Still stuck? Contact us" that opens a form or chat.
  • Review articles quarterly; HubSpot shows views and feedback ("Was this helpful?") per article.

Using articles during support

Inside a conversation or ticket, an agent can search the knowledge base and insert a link. Customers using chat can also see suggested articles before talking to a person. This is deflection: a customer reads an article and does not open a ticket.

The help desk workspace

The help desk (Service > Help Desk) is the agent workspace: a list of tickets and conversations on the left, the conversation in the middle, and the CRM context (contact, company, associated deals and tickets) on the right. Agents can:

  • reply by email or chat from one composer,
  • use snippets (reusable text with personalization tokens),
  • add internal notes and mention colleagues,
  • change ticket status, priority and owner without leaving the thread,
  • use templates and AI-assisted drafting features if your plan includes them.

Two ways to help

Self-service Knowledge base articles
Chat deflection Suggest articles first
Help desk Agents with CRM context
Measure Views, ratings, tickets

Fewer tickets, faster answers

1 / 2

A toy article search

The stand-in below ranks articles for a query by counting matching words in the title (weighted higher) and the body. It is not HubSpot's algorithm; it shows why titles written in customer language help.

Python Rank articles for a customer question

Press Run (or Ctrl + Enter) to see the result here.

Program input ยท what you'd type while the program runs

Type the answers before you press Run, one per line. Each time the program reads a line (with input()), it gets the next line from this box.

Measuring deflection

A rough deflection rate is the share of help seekers who found an answer without contacting you. You cannot see this perfectly, but you can estimate it from article visits and ticket counts.

Python Estimate deflection and cost saved

Press Run (or Ctrl + Enter) to see the result here.

Program input ยท what you'd type while the program runs

Type the answers before you press Run, one per line. Each time the program reads a line (with input()), it gets the next line from this box.

The assumption (5%) is yours to defend; always label estimates as estimates.

Snippets and templates

Snippets are short pieces of text you insert with # in the composer. A good set covers greetings, "please send a screenshot", and end-of-conversation lines. Use personalization tokens like the contact's first name, but keep a human tone. Review them for outdated product names.

Common mistakes

  • Publishing too many thin articles; consolidate duplicates.
  • Letting the knowledge base domain expire or point at the wrong theme.
  • Ignoring searches with no results: they are a to-do list for new articles.
  • Using internal jargon in titles.

Check your understanding

Quick check ยท 3 questions

of 3 answered You scored / 3 ยท perfect!

  1. 1. What is deflection?

    Deflection means self-service prevented the ticket.
  2. 2. Which article title is best for findability?

    Customers search with their own words, so use plain phrases.
  3. 3. What does the help desk right-hand panel show?

    The help desk surfaces CRM context so agents don't switch tabs.

Summary

  • A knowledge base deflects tickets; the help desk speeds the rest.
  • Write one problem per article in customer language.
  • Use snippets and CRM context to answer consistently.
  • Estimate deflection transparently and label assumptions.

Next: Customer Feedback: NPS, CSAT and CES