Macha

Freshdesk Knowledge Base Explained (2026): Setup, Tips & AI

Abbas, Customer Support & AI, Macha

Written by

Ankeet Guha, Co-founder & CTO, Macha

Reviewed by

Published July 2, 2026

Updated July 2, 2026

A Freshdesk knowledge base is the self-service library of help articles your customers (and agents) can search instead of opening a ticket. Inside Freshdesk, it's organized into a simple three-level structure — categories hold folders, folders hold articles — and it powers a branded, customer-facing Help Center where people find answers on their own, 24/7. It's also the quiet engine behind every "deflection" number a support team brags about: every question answered by an article is a ticket that never reached a human.

Freshdesk Knowledge Base Explained (2026): Setup, Tips & AI

This guide explains how the Freshdesk knowledge base actually works in 2026 — the structure, the Help Center, the drafting-to-publishing workflow, the plan-gated extras like multilingual and multi-product KBs, article SEO, feedback and analytics, how agents pull articles into replies, and how a clean KB makes AI deflection work. Verified against Freshworks' own documentation as of June 2026. (New to the product itself? Start with what is Freshdesk.)

"Solutions" = Freshdesk's knowledge base

First, a terminology heads-up that trips up almost everyone: inside the Freshdesk agent interface, the knowledge base lives under a tab called Solutions. "Knowledge base," "Solutions," and "Help Center articles" all refer to the same thing — Freshworks uses Solutions for the agent-side authoring area and Help Center (or portal) for the customer-facing site that displays those articles. Don't let the naming throw you; they're two views of one content store.

The Freshdesk product website — Freshworks' cloud help desk and knowledge base software.
The Freshdesk product website — Freshworks' cloud help desk and knowledge base software.

The structure: categories → folders → articles

Freshdesk organizes knowledge in a clean three-tier hierarchy:

  • Categories — the top level, a broad topic area. An e-commerce store might have categories like Orders, Returns & Refunds, and Billing.
  • Folders — sub-sections inside a category that group related articles. Inside Orders you might have Placing an order, Tracking & delivery, and Cancellations.
  • Articles — the actual help content: a single how-to, FAQ, or troubleshooting guide.

So a customer journey reads top-down: Category → Folder → Article. Freshdesk also supports a flexible hierarchy — you can nest sub-folders up to five levels deep when a topic genuinely needs it (Freshdesk docs). Resist the urge to use all five; deep nesting is where help centers go to die. Most teams are best served by shallow, obvious structure.

Folders also carry a visibility setting, which is one of the most useful and most overlooked features. A folder can be visible to:

  • Everyone — public, indexable, shown in the Help Center.
  • Logged-in users only — gated behind a customer login.
  • Agents only — an internal knowledge base your customers never see (great for SOPs, escalation playbooks, and internal-only fixes).

That last option means one Freshdesk account can hold both your public help center and your private internal docs, separated by folder visibility.

The customer-facing Help Center (portal)

The Help Center is the public website your knowledge base renders into — a branded portal where customers search articles, browse categories, read community forums (on plans that include them), and submit a ticket only if self-service didn't solve it. You can customize its look with your logo, colors, and theme, and on higher plans the customization goes much deeper (full CSS/template control on Enterprise).

Crucially, a self-service portal with a knowledge base is available on every Freshdesk plan, including the Free program (Freshdesk pricing). What scales with plan tier is the sophistication — portal customization depth, multilingual support, and multi-product portals — not the existence of a KB itself. We'll map those gates below; for the full plan-by-plan picture see our Freshdesk features breakdown.

Drafting and publishing workflow

Articles move through a lifecycle rather than going live the instant you hit save:

  1. Draft — work-in-progress, invisible to customers. Write, paste images, embed video, format with the rich-text editor.
  2. In Review — submitted for a teammate to check (part of the approval workflow).
  3. Approved — signed off by a reviewer.
  4. Published — live on the Help Center for customers to read.

Worth being precise here: the In Review and Approved statuses only appear when the formal approval workflow is switched on, which is an Enterprise-only feature. On lower plans the lifecycle is simply Draft → Published — there's no software-enforced review step in between.

The agent-side Solutions area gives you list views to manage this at scale — filtering by status, bulk-moving or reordering articles, and changing visibility for many articles at once. A few of those management conveniences are themselves plan-gated: manual reordering works from the Free program, automatic reordering from Growth, and filters and bulk actions from the Pro plan (Freshdesk docs).

The formal approval workflow — where an article must be reviewed and approved by a designated person before it can publish — is available only on the Enterprise plan. On lower tiers, any agent with the right permission can publish directly, so your "review" step has to be a process you enforce manually rather than a gate the software enforces for you.

Plan-gated extras: multilingual and multi-product KBs

Two of the most-asked-about capabilities are both Pro-and-up features, so it's worth being precise:

  • Multilingual knowledge base — serve the same article in multiple languages from one portal, with the Help Center auto-detecting a visitor's preferred language (by login or browser setting). This is available from the Pro plan onward (Freshdesk docs). You manage translations per article, and an article's translated versions can have their own statuses, so a German version can stay in draft while the English one is live.
  • Multi-product knowledge base — if you run several products or brands, each can get its own space with its own categories, folders, and articles inside a single Freshdesk account (Freshdesk docs). Multi-product portal management also kicks in from the Pro tier.

These tiers and prices shift over time, so confirm current packaging on Freshworks' pricing page before you buy — and for the money side, see our dedicated pricing coverage linked from what is Freshdesk.

Article SEO

Because the Help Center is a public website, its articles can rank in Google — and Freshdesk gives you the levers to help. Each article has dedicated SEO fields: a meta/SEO title, a meta description, and keywords/tags (Freshdesk docs). Freshworks' own guidance suggests keeping the title around 50–60 characters and the description around 150–160, both keyword-relevant and human-readable.

Practical wins here: write article titles the way customers actually phrase the problem ("Why is my order stuck on processing?" beats "Order status definitions"), fill in the meta description on every public article, and keep URLs and headings clean. A well-optimized help center quietly becomes a top-of-funnel traffic source, not just a deflection tool.

Feedback and analytics

Freshdesk closes the loop with built-in measurement so you're not guessing which articles work:

  • Article feedback — readers can mark an article helpful or not, and Freshdesk surfaces "not helpful" feedback (it can even raise it as a ticket via the Article Feedback view) so you can fix weak content.
  • KB analytics — reporting on article views, feedback, and ratings shows your most-read articles, your worst-performing ones, and the gaps where customers searched and found nothing.

The pattern that compounds: watch what people search for and don't find, write articles to fill those gaps, then watch deflection climb. A knowledge base is a living asset, not a one-time setup.

How agents use the KB inside tickets

The knowledge base isn't only for customers — it's a speed tool for agents handling tickets. From the reply editor, an agent can:

  • Insert a solution article by typing /s, then pick the right article from a search pop-up — inserting either the full article text or a link to it (Freshdesk docs).
  • Drop in a canned response by typing /c for reusable reply templates (Freshdesk docs).
  • Get Freddy AI suggestions — Freshworks' AI recommends relevant solution articles and canned responses based on the ticket's content, so agents don't have to hunt.

This is the underrated payoff of a good KB: it makes every human reply faster and more consistent, even on the tickets that do reach a person.

The Freshdesk Omni product page — Freshworks' omnichannel, AI-powered support and self-service suite.
The Freshdesk Omni product page — Freshworks' omnichannel, AI-powered support and self-service suite.

How to set up a Freshdesk knowledge base (quick outline)

A workable first version takes an afternoon, not a quarter:

  1. Map your categories from your real ticket data — pull your top 10–15 ticket reasons and group them into a handful of broad topics.
  2. Create folders under each category for the sub-topics, and set folder visibility (public vs. logged-in vs. agents-only).
  3. Write your most common answers first. Start with the 20 articles that would deflect the most tickets, not an exhaustive manual.
  4. Optimize each article — clear title in the customer's words, filled-in SEO meta description, a screenshot or two, and a short summary up top.
  5. Run a review pass (formal approval workflow on Enterprise; a manual checklist on lower plans) before publishing.
  6. Publish and customize the Help Center with your branding, and add multilingual versions if you're on Pro+.
  7. Measure and iterate — check article feedback and search analytics monthly, fix the "not helpful" articles, and write new ones for unmet searches.

Best practices for a KB that actually deflects

  • Shallow beats deep. Obvious categories and few clicks. Don't bury answers five folders down just because you can.
  • Write for the searcher, not the org chart. Use the words customers type, not your internal product names.
  • One job per article. A focused article ranks better, answers cleaner, and is far easier for AI to use accurately.
  • Keep it fresh. Stale screenshots and outdated steps erode trust fast — schedule reviews of your top articles.
  • Use agents-only folders for internal SOPs so your team's knowledge lives in the same system.
  • Let data drive it. Your "not helpful" feedback and zero-result searches are a free content roadmap.

What users say about Freshdesk's knowledge base and self-service

Vendor docs tell you what the KB can do; review sites tell you how it feels to live in. Across the two largest software-review platforms, Freshdesk as a whole lands solidly above average:

  • G2: 4.4 / 5 from roughly 3,700 reviews (G2).
  • Capterra: 4.5 / 5 from roughly 3,400+ verified reviews (Capterra) — where self-service and the knowledge base portal rank among the most-used features.

Narrowed to the knowledge base, Solutions editor, search, and self-service specifically, the sentiment splits into a clear plus and a clear minus:

Aggregate review sentiment (G2 / Capterra, self-service & knowledge base themes): reviewers consistently praise that the knowledge base is built into the same interface — agents who double as authors don't need a separate docs tool, and turning a good ticket reply into a solution article is quick. Self-service is repeatedly named a top-used capability (Capterra reviews).
Aggregate review sentiment (G2 / Capterra, editor & search themes): the recurring gripes are that the article editor feels dated and clunky next to modern writing tools, that search accuracy degrades once the knowledge base gets large, and that real-time co-authoring is limited — coordinating two people on one article is awkward (G2 pros & cons).

For most small-to-mid teams it's more than good enough; documentation-heavy orgs sometimes pair it with a dedicated docs platform. (On the specifics in this guide: we re-verified every plan-gating boundary — Free/Growth/Pro/Enterprise, multilingual, multi-product, and the Enterprise-only approval workflow — against Freshworks' live pricing and support docs in June 2026. We don't hold a configured Freshdesk login, so the in-product Solutions UI isn't screenshotted here; the gating and feature claims are sourced to Freshworks' own documentation rather than a captured admin panel.)

Where an AI agent layer fits

Here's the honest connection most vendors skip. A self-service KB deflects only the customers who bother to search — and Freshdesk's own Freddy is strong at surfacing articles and assisting agents. But a lot of tickets still pile up in the middle: the customer who emails instead of searching, or whose question needs an answer stitched from a few articles plus their order history.

Freshworks Freddy AI — the AI Agent and Copilot suite that deflects tickets using your Freshdesk knowledge base.
Freshworks Freddy AI — the AI Agent and Copilot suite that deflects tickets using your Freshdesk knowledge base.

That middle is where a dedicated AI agent layer like Macha fits. Macha isn't a help desk and it isn't a knowledge base — it runs on top of the Freshdesk (or Zendesk) you already use, reading the customer's actual question, pulling from your connected knowledge base and conversation history, resolving the issue in the same thread, and handing off to a human with full context when it isn't confident.

Macha connectors — the AI agent layer connecting to Freshdesk and Zendesk on top of your existing help desk.
Macha connectors — the AI agent layer connecting to Freshdesk and Zendesk on top of your existing help desk.

The catch, stated plainly: an AI agent layer is only as good as the knowledge base you connect it to. Garbage KB, garbage answers. Everything above — clean structure, fresh articles, customer-worded titles, gaps filled from search data — is exactly what makes both native deflection and an AI agent layer actually work. Get the Freshdesk KB right first; the AI rides on top of it. If your ticket mix is mostly repetitive questions your help center could answer, you can 7-day free trial, no credit card required and see how far a connected KB takes you. (For the native side, see how to automate Freshdesk with AI.)

Frequently asked questions

What is the Freshdesk knowledge base? It's Freshdesk's self-service article library — called Solutions in the agent interface — that powers a public, branded Help Center where customers search for answers instead of opening tickets. Content is organized as categories → folders → articles.

What's the difference between Solutions, knowledge base, and Help Center in Freshdesk? They're three names for related parts of one system. Solutions is the agent-side area where you author and manage articles; knowledge base is the general term for that content; the Help Center (or portal) is the customer-facing website that displays the published articles.

Is the knowledge base available on the Freshdesk free plan? Yes. A knowledge base and self-service portal are included on every Freshdesk plan, including the Free program. Advanced extras — multilingual KBs, multi-product portals, deep customization, and the formal approval workflow — require higher tiers (Pro or Enterprise).

Does Freshdesk support a multilingual knowledge base? Yes, from the Pro plan onward. You can publish articles in multiple languages on one portal, and the Help Center auto-detects a visitor's preferred language by login or browser setting.

Can I require article approval before publishing? A formal approval workflow (Draft → In Review → Approved → Published, enforced by the software) is available only on the Enterprise plan. On lower plans you can still keep articles in draft, but you enforce review as a manual process.

Can agents add knowledge base articles to ticket replies? Yes. In the reply editor an agent can type /s to insert a solution article (as full text or a link) and /c to insert a canned response, and Freddy AI can suggest relevant articles automatically based on the ticket.

Can a strong Freshdesk KB improve AI deflection? Absolutely — it's the single biggest factor. Both Freshdesk's native Freddy and any AI agent layer you add draw their answers from your knowledge base, so clean structure, fresh content, and customer-worded titles directly raise how much an AI can resolve correctly.

The bottom line

The Freshdesk knowledge base (Solutions) is a capable, built-in self-service engine: a clean categories → folders → articles structure, a branded customer Help Center on every plan, a draft-to-publish workflow, and Pro/Enterprise extras for multilingual content, multi-product portals, and formal approvals. It's not the slickest authoring tool on the market — the editor and large-scale search draw fair criticism — but for most teams already on Freshdesk, it's more than enough to power real self-service. And whether you lean on Freshdesk's native Freddy or add an AI agent layer on top, the same truth holds: the quality of your knowledge base sets the ceiling on how much you can deflect. Build it well, keep it fresh, and let the data tell you what to write next.

Verified against Freshworks' official Freshdesk documentation, June 2026. Freshworks revises packaging and plan gating periodically — confirm current details on freshworks.com before relying on them.

Macha

About Macha

Macha is an AI agent platform that works on top of the help desk you already use — Zendesk, Freshdesk, Gorgias, or Front — and connects to the rest of your stack, even your own internal systems. Its AI agents resolve tickets and automate entire workflows end to end, all set up in plain English, no code. Learn more about Macha →

Zendesk
5.0 on Zendesk Marketplace

Loved by support teams worldwide

See what support teams are saying about Macha AI.

The application seems excellent to me! We are still testing, and we need support for some details and they were extremely efficient too!

Daniela Costa

Daniela Costa

Head of Support, Seabra

Macha has been a great addition to our support toolkit. It generates clear, well-organized responses that fit naturally into our workflow. One feature we particularly appreciate is its ability to automatically reply in the same language as the ticket.

Marius F

Marius F

Support Head, Zentana

We've been using Macha for a little while now and it's been really great addition so far! It's powerful, convenient, and makes getting work done a lot easier for our agents.

Alexander Wedén

Alexander Wedén

Head of Support

Support team is very helpful and responsive. Really enjoy how lightweight this is within Zendesk itself vs other more intrusive tools.

Cathleen Wright

Cathleen Wright

Zendesk Admin, Cortex IO

So far it's pretty good! Our queries are a little nuanced, so we can't always use it, but it's got enough utility for us. It can even incorporate our bilingual country with greetings in a second language.

Jae Oliver

Jae Oliver

Head of Support, Wise

Really enjoying using Macha, it has made a noticeable difference to our support team in a short amount of time. I really like the ticket summary feature, saves us a lot of time.

Harry Jackson

Harry Jackson

Head of Support, Crumb

Macha AI is a great addition to my workspace! It's powerful, convenient, and it really makes productivity so much easier for our agents!

Dave G

Dave G

Head of Support, Cyber Power Systems

Very impressed! AI integration for Zendesk has certainly come a long way and Macha seems to set the standard for now. This will for sure save lot of time in our support team.

Pauli Juel

Pauli Juel

Head of CS, Dokument24

Macha has been working great for us so far! The auto-responses are accurate and our resolution time has dropped significantly.

Lana T

Lana T

Zendesk Admin, Swotzy

Macha AI is a great addition. The knowledge base feature means our agents always have the right answers at their fingertips.

Mischa Wolf

Mischa Wolf

Head of Support, Topi

We're enjoying this integration so far. It's made our support team more efficient and our customers get faster responses.

Paula G

Paula G

Head of Customer Support, Xly Studio

The team enjoys using it. It saves considerable time on common questions and the integration options are excellent.

Kilian Leister

Kilian Leister

Support Head, Didriksons

Ready to supercharge your team with AI?

Get started in minutes. Connect your tools, configure your agents, and let AI handle the rest.

7-day free trial · no credit card required