Setup
Getting started with the Crisp Knowledge Base
Create, customize, publish, and share a Crisp Knowledge Base so customers can find answers on their own. The Crisp Knowledge Base is a public help center connected to your workspace. You can use it to publish articles, organize them by category, support multiple languages, share answers from the Inbox, and provide helpful content to customers and to Hugo. This guide covers the main setup areas: Check the required plan →PopularHow to add a new language to the Knowledge Base
Add languages to your Crisp Knowledge Base so customers can read your help content in their preferred language. Crisp Knowledge Base supports multiple languages inside the same workspace. You can create the first language when setting up the Knowledge Base, then add more languages later. Your main language is the reference for your content, and other languages can be automatically translated from it. Each language can then be reviewed and edited separately. ${color}[#0080dd](Create thSome readersHow to setup a Custom Domain for the Knowledge Base
Configure a custom domain for your Crisp Knowledge Base so visitors can open it from your own help center URL. By default, Crisp can host your Knowledge Base on a Crisp domain such as acme.crisp.help. You can also use a custom domain such as help.acme.com, which is usually better for branding and customer trust. Some DNS managers only ask for the subdomain part of the record. For example, instead of entering support.yourdomain.com, you may need to enter only support. Compare withSome readersHow to connect your Knowledge Base to AI tools with MCP
Learn how to connect your Crisp Knowledge Base to ChatGPT, Claude, and other MCP-compatible AI tools. The public MCP server makes the content of your public Knowledge Base available to compatible AI assistants. Once connected, they can search your documentation, read articles, summarize information, and retrieve relevant answers directly from your existing help content. If you're new to the Knowledge Base, start with [Getting started with the Crisp Knowledge Base](https://help.crisp.chat/en/Few readersHow to protect the Knowledge behind a password
Protect your Crisp Knowledge Base with a password when you want to restrict access to your help content. Password protection lets you keep your Knowledge Base available only to visitors who know the password. This is useful for private documentation, internal resources, early-stage product docs, or customer-only help centers. Enable password protection Start from app.crisp.chat, then open **Settings → Knowledge Base Settings → CustomizFew readersHow to setup JWT token authentication for your Knowledge Base?
Protect your Crisp Knowledge Base with a JWT token when you want to restrict access to your help content. JWT tokens allow more granular authentication than a password, and are much more flexible. They however require a bit more work to implement. Enable JWT token authentication JWT token authentication can be enabled from your Knowledge Base settings, in the Authentication section. Whenever you enable authentication, we by default choose the "password" option. MakeFew readersHow to route the Knowledge Base behind a reverse proxy
Serve your Crisp Knowledge Base through a reverse proxy when you need advanced hosting control. Most teams should use a regular custom Knowledge Base domain. A reverse proxy is an advanced setup for cases where you need to serve the Knowledge Base from a custom server, a custom route, or a specific subfolder such as mywebsite.com/help. Before using a reverse proxy A reverse proxy can be useful when you need to host the Knowledge Base under a custom domain, customFew readers
Customization
How to customize the Knowledge Base UI (Layout)
Customize the layout of your Crisp Knowledge Base with reusable HTML, CSS, and JavaScript snippets. Crisp lets you include custom code in your Knowledge Base settings so you can adjust visual details, hide optional elements, or change small interface labels. These snippets are meant for layout customization only; keep them simple, test them after saving, and avoid changing core navigation if it could make the Knowledge Base harder to use. Before you add custom codeFew readersHow to change the Knowledge Base favicon
Change the favicon shown in browser tabs for your Crisp Knowledge Base by updating your workspace icon. The Knowledge Base favicon uses the same icon as your Crisp workspace website icon. To change it, update the workspace icon from your workspace settings. Update the workspace icon Start from app.crisp.chat, then open Settings → Workspace Settings → Workspace Information. To change the Knowledge Base favicon: Open **WorkspaFew readersHow to change the header logo size of the Knowledge Base
Improve a Knowledge Base logo that looks too small by choosing a better logo format or adjusting its height with CSS. The Knowledge Base header keeps a fixed visual structure so navigation stays aligned. If your logo appears too small, first check the logo file itself, then use custom CSS only if the image cannot be improved. Choose the right logo file A logo that is too tall, too detailed, or not wide enough can appear small once it is constrained by the KnowledgeFew readersHow to inject custom code on the Knowledge Base
Add custom HTML, CSS, or JavaScript to your Crisp Knowledge Base from the customization settings. Custom code is useful when you want to add tracking scripts, adjust small layout details, or apply snippets that change how the Knowledge Base looks. Use it carefully and keep customizations easy to maintain. Add custom code Start from app.crisp.chat, then open Settings → Knowledge Base Settings → Customize your Knowledge Base. __To iFew readers
Writing & Publishing
How to use Hugo Copilot in Knowledge Base
Learn how to use Hugo Copilot in the Knowledge Base to create, edit, translate, and manage help content with AI. Hugo Copilot is available directly from the Crisp Knowledge Base. It can work with the article you are viewing, create new content, suggest edits, and perform Knowledge Base actions without requiring you to leave the editor. For a broader introduction to Copilot, see [How to use Hugo Copilot as an AI assistant for customer support teams](https:/Few readersHow to format Knowledge Base articles
Use Crisp Markdown to format Knowledge Base articles with clear text, titles, lists, media, links, and helpful information boxes. Knowledge Base articles are written with Markdown, a lightweight syntax that keeps formatting simple and readable. This guide covers the formatting options supported in Crisp articles and shows the syntax you can paste directly into the editor. Format text Use these inline formats to make article content easier to scan: Bold →PopularHow to include a PDF in Knowledge Base articles
Embed a PDF in a Crisp Knowledge Base article by loading it through a frame. A PDF can be displayed inside an article with the Crisp ${frame} syntax. The PDF must be reachable from a public URL so the viewer can load it for your visitors. Prepare the PDF URL Before embedding the PDF, make sure the file is publicly accessible. If the PDF is hosted behind a login or a private link, visitors may not be able to open it inside the article. **Use this Google Docs viewFew readersHow to include Google Docs in Knowledge Base articles
Embed a Google Docs document in a Crisp Knowledge Base article by exporting it as a PDF and loading it through a frame. Crisp can display a Google Docs document in an article when the document is available through a PDF export URL. You can then load that exported PDF with the Crisp ${frame} syntax. Create the Google Docs PDF export URL Start from the edit URL of your Google Docs document. It usually looks like this: https://docs.google.com/document/d/1S8Few readersHow to embed Loom videos in Knowledge Base articles
Embed a Loom video inside a Crisp Knowledge Base article by converting the Loom embed URL into a Crisp frame. Crisp supports frame embeds through the ${frame} syntax. For Loom, you first need to retrieve the Loom embed URL, then paste it into the Crisp frame format. Retrieve the Loom embed link Open the Loom video you want to embed. A share URL usually looks like this: https://www.loom.com/share/221f217704be4b668928c1a4cacb2f0e __To retrieve the embFew readersHow is the Crisp Knowledge Base natively optimized for SEO
Understand how Crisp Knowledge Base helps your articles stay search-engine friendly and shareable. Crisp Knowledge Base follows common SEO practices so your public help content can be discovered, indexed, and shared more easily. Your article quality still matters most: clear titles, helpful content, internal links, and up-to-date answers improve both customer experience and search visibility. SEO features included in Crisp Knowledge Base Crisp Knowledge Base includFew readersHow to embed Wistia videos in Knowledge Base articles
Embed a Wistia video inside a Crisp Knowledge Base article by converting the Wistia iframe URL into a Crisp frame. Crisp supports frame embeds through the ${frame} syntax. For Wistia, retrieve the iframe src URL from the Wistia embed settings, then use that URL in your Crisp article. Retrieve the Wistia embed link To retrieve the embed URL from Wistia: Open your Wistia Dashboard Open the video you want to embed Click Embed & Share Choose **IFew readersHow to Embed a Crisp Knowledge Base Article in an iFrame
This article explains how to embed a Crisp Knowledge Base article inside your website or product using an iFrame. Crisp Knowledge Base articles can be opened in a dedicated reader mode that removes the standard Knowledge Base navigation. This makes it easier to display a specific article inside your product, documentation, onboarding flow, or support page. In this guide, you will learn how to: [Watch the video walkthrough](#1-watch-the-video-walkthroFew readers
Troubleshooting
How to troubleshoot Knowledge Base issues
Troubleshoot common Crisp knowledge base issues, including custom domains, article visibility, cache, SSL, and error pages. Most knowledge base issues come from DNS configuration, category visibility, short cache delays, or SSL provisioning after a custom domain change. Use the sections below to identify which layer needs attention. Custom knowledge base domain is rejected When you configure a custom knowledge base domain, Crisp provides DNS records that must be adFew readersWhich devices & browsers are supported by the Knowledge Base
Know which browsers and device types are supported by Crisp Knowledge Base. Crisp Knowledge Base is built for modern browsers and responsive layouts. It works across desktop, mobile, tablet, and large-screen devices, as long as visitors use a supported browser version. Compatible browsers Crisp Knowledge Base works best on the latest stable versions of modern browsers. Supported browser families include: Chrome → desktop and mobile Firefox → desktoFew readers