Build your help center

Launch your help center: create a portal

The help center is a public, branded portal where your customers find answers on their own, 24/7. The same articles can also feed your AI agents. Create a portal 1. Go to Help Center (sidebar) → Create portal. 2. Name: your help center's name. 3. Slug: the identifier in the URL (suggested automatically from the name). 4. Confirm. Your portal is created with the default Madyis brand color (cyan), which you can change later. Good to know - You can create several portals (for example one per brand or per product). - Once the portal is created, structure it: add a language, categories, then articles. - It's reachable at its URL as soon as it's created; you can also put it on your custom domain.

Customize your help center: logo, colors, banner and announcement

Give your help center your identity. Go to Help Center → (your portal) → Settings. The look - Logo / avatar (max 4 MB). - Name and header text shown at the top of the portal. - Page title (for SEO / the browser tab). - Brand color: the portal's main color. - Cover image (hero banner): a large image at the top of the home page (16:6 ratio, max 4 MB). - Chat widget: link a "Website" inbox to show a chat bubble on the portal. The announcement banner Enable an announcement banner (a bar at the top of the portal) with text, a link label, a URL and a color — handy to announce a new feature or maintenance. The layout Choose the Classic or Documentation layout (with a side menu, in beta). In Documentation mode, you can also add your social links (Facebook, Instagram, X, LinkedIn, YouTube, TikTok…). Good to know: logo, cover image and announcement banner can each be removed individually whenever you want.

Organize your content: categories and articles

A help center is organized into categories that contain articles. Create a category 1. In your portal → Categories → New category. 2. Name (with an optional emoji icon). 3. Slug: suggested automatically from the name. ⚠️ It cannot be changed after creation — choose it carefully. 4. Description (optional). The category is created in the portal's active language. Add articles From Articles → New article: give a title, choose the category in the top bar, write, then Publish (see "Write an article"). Good to know: each category belongs to one language. If you offer several languages, create the category in each language.

Write an article: rich text, images and videos

The article editor lets you create clear, visual guides. Rich text The toolbar offers: bold, italic, strikethrough, link, bullet and numbered lists, headings (H1/H2/H3), code, tables, and adding images (upload). Add a video There is no "insert video" button: just paste the video's link on its own line, and it embeds automatically in the article. Supported providers: YouTube, Loom, Vimeo, direct .mp4 file, Wistia, Bunny, Arcade, CodePen, Guidejar, GitHub Gist. Publish At the top of the editor, choose the author and the category, then publish. An article goes through three states: Draft → Published → Archived. The "Preview" button shows the public rendering. Good to know: SEO metadata (title, description, tags) is set in the "More properties" panel, available once the article exists (after the first save).

Languages, custom domain and SEO for your help center

Add a language In your portal → Locales → Add locale. Choose the language and its status: Published (live) or Draft. ⚠️ Use only short codes (fr, en, es, de…), not regional variants (fr_FR, en_US). Mixing the two makes categories invisible. One code per language. Each language has its own categories and articles (you can bulk-translate from the Articles page). Put your help center on your domain In Settings → Add custom domain, enter your domain and follow the DNS instructions. Once DNS is configured, your help center is reachable at your own address. SEO - Fill in the portal's page title and each article's metadata (title, description, tags). - A public help center is indexed by Google: that's extra organic traffic. Good to know: those same published articles can be imported into your AI agents' knowledge base (see the AI Agents section).