Skip to main content
A help center is a public site, served by libredesk, where customers browse and search your articles. You can run more than one. Each has its own content, languages, appearance and domain. The AI assistant can also use published articles to answer conversations.

Create a help center

1

Add the help center

Go to Admin → Help center → New. Fill in the name, the slug that goes in its URL, and the page title.
2

Pick a template

Docs gives you a documentation layout: a top navigation bar, a sidebar listing collections, and quick search on Ctrl+K. Classic gives you a landing page with a hero banner, a large search bar and collection cards.

URLs

By default the help center is served from your libredesk instance:
https://support.example.com/hc/<slug> redirects to the default language. Pause site in the help center’s menu takes it offline until you click Resume site.

Custom domain

A help center can be served from its own domain or subdomain, for example https://help.example.com, where it sits at the root and the paths above drop the /hc/<slug> prefix. Two help centers cannot share a domain. Set Custom domain (optional) on the General tab to the domain’s root URL, including https://, then:
1

Point DNS at the server

Point the domain at the same server as your libredesk instance: an A record to its IP, or a CNAME to the hostname you already serve libredesk on.
2

Add a server block

libredesk decides which help center to serve from the Host header of the request, so the proxy has to forward the original host. Save this as /etc/nginx/sites-available/libredesk-help:
Then enable it and reload nginx:
proxy_set_header Host $host; is the line that matters. Without it nginx sends the upstream’s host, no help center matches, and visitors land on the agent login page instead of your help center.

Collections and articles

Collections group articles and can be nested up to three levels deep. To change the order readers see, drag a row by its handle in the content tree. Only published articles appear on the public site. Readers can mark an article as helpful or not. The editor shows the counts under Feedback.

Languages

Add every language you plan to write in under Supported languages on the General tab, then pick the Default language that visitors land on. A language picker appears in the navigation bar once there is more than one. A collection or article belongs to a single language, and an article has to sit in a collection of the same language. A language that still has collections or articles in it cannot be removed. Use the Translation section of the article editor to link versions of the same article in other languages.

AI answers

On any article the AI assistant may answer from, turn on Allow AI assistants to use this article. Nothing happens until the article is published. Enable it in one language only, not in every translation. AI has to be configured for this to work, see AI.

Appearance

The Appearance tab covers the logo, favicon, theme, colors, header and hero, announcement bar, footer links, and what the landing and article pages show. For anything the settings do not cover, Custom code takes custom CSS and JS, injected into every page.

Live chat

Pick a Live chat inbox on the General tab to show its chat widget on every help center page.

SEO

Set the page title and meta description for the home page, and the meta fields on each article. libredesk serves /robots.txt and a sitemap index at /sitemap.xml, plus a per-language sitemap at /hc/<slug>/<locale>/sitemap.xml. A custom domain lists only its own help center.

Search insights

Search insights lists the top searches visitors ran and the ones that returned no results.

Permissions

Managing help centers, collections and articles needs the Manage help centers permission, which you add to a role under Admin → Roles.