The Freshdesk Knowledge Base

The Freshdesk knowledge base calls them solution articles. Customers call them the reason they didn't have to contact you.

How the Freshdesk knowledge base is structured

Freshdesk organises content as categories, folders and solution articles. Folders control visibility, which is the useful part: an article can be public, restricted to logged-in users, restricted to specific companies, or internal to agents.

That means your agent runbooks and your public documentation live in the same system without leaking into each other, and agents can insert a solution article into a reply without leaving the ticket.

What to write first

Not a content plan. Your own ticket data.

Export a month of tickets, group by subject, and write the ten most repeated answers. Then check the search terms in your portal that returned nothing, because that list is written by your customers and is more useful than anything you'd brainstorm.

Write each article so the answer is in the first two sentences. People scan to check they're in the right place before they read anything.

Making it deflect

Publishing is half the job. The other half is placement.

Surface suggestions in the customer portal as they type their ticket subject.
Link the article from the product screen where the question arises.
Put article links in canned responses so agents reinforce them daily.
Track ticket volume for the topic you documented. If it doesn't fall, the article is wrong or unfindable.

What documentation can't fix

Someone who emailed an hour ago and has now filled in the portal form is not missing information, they're missing a reply. No article prevents that second contact, and it arrives as a duplicate rather than a new question.

FAQ

Frequently asked questions

Where does the knowledge base sit in the Freshdesk customer portal?

Freshdesk solutions are the article library and they render inside the Freshdesk help center, which is the same thing as the Freshdesk customer portal. The best Freshdesk knowledge base examples put the top five articles on the portal home page rather than behind a search box.

Can I restrict Freshdesk articles to certain customers?

Yes. Folder visibility can be public, logged-in users, specific companies, or agents only.

How do I know if the Freshdesk knowledge base is working?

Watch ticket volume for the documented topic and the failed-search report. Article views tell you almost nothing.

The contacts no article prevents

Impatience creates duplicates, not knowledge gaps. Ticket Merger removes them before an agent replies twice.

Start free trial

14-day free trial. No credit card required.