⌘ K

Search

Search portal content

AI customer support in one tabAI customer support in one tab
⌘ K

Search

Search portal content

AI customer support in one tabAI customer support in one tab
  • Set up your help center
  • Publish articles
  • Organize collections
  • Set up redirects
  • Import articles
  • Use a custom domain
  • Add AI chat to your site
  • Set up customer accounts
  • Help center analytics
  1. Home
  2. Help center & AI chat

Publish articles

Create an article, write it in the editor, and publish it. Customers find it in your help center, and the AI uses it to answer them.

On this page
  • Publish articles
  • Create an article
  • Write and publish
  • Set the address, collection, and search text
  • Format with the slash menu
  • Alerts
  • Collapsible sections
  • Images
  • Videos
  • Tables
  • Links
  • Paste Markdown
  • Write for customers and for the AI
  • Delete an article
  • If something's not working
  • If you see "That file is larger than 5 MiB."
  • If you see "Pick a PNG, JPEG, GIF, or WebP image."
  • If you see "That address is already taken. Try another."
  • If you see "Give every collapsible section a title."
  • If Save changes is grayed out
  • Related

Publish articles

Create an article, write it in the editor, and publish it. Customers find it in your help center, and the AI uses it to answer them.

An article is one answer to one question. Customers read it in your help center. The initdesk AI uses your published articles to answer customers in the AI chat.

Create an article

  1. Go to AI & Knowledge > Help Center > Collections & Articles.
  2. Select New article. To add it straight into a collection, open the menu on the collection's row and choose New article.
  3. Enter a Title.
  4. Choose a Collection. If you have none, create a collection first. See Organize collections.
  5. Check the URL address. It follows the title until you edit it. Leave it empty to build one from the title.
  6. Select Create article.

The new article opens in the editor as a Draft. Customers can't see it yet.

Write and publish

Click in the body and write the answer a customer is looking for. Then:

  1. Check the Title at the top of the page.
  2. Set State to Published.
  3. Select Save changes.
The article page with the State menu, Save changes button, and the Collection and Search sections
Set the State to Published, then select Save changes.

When the article is published, Preview opens it in your help center in a new tab. Before that, Preview isn't available.

You need some content before you can publish or archive. If you try with an empty body, you'll see "Add content before publishing or archiving this article."

State Customers see it The AI uses it
Draft No No
Published Yes Yes
Archived No No

To take an article down without deleting it, set State back to Draft or Archived and select Save changes.

Set the address, collection, and search text

The right side of the article page has two sections.

Collection moves the article to another collection. That changes the article's address, so add a redirect from the old one. See Set up redirects.

Search holds:

  • URL address: the last part of the article's link. Use lowercase letters, numbers, and single hyphens. Changing it breaks links customers already have.
  • Description: one or two sentences, up to 160 characters. It shows under the title in search results and is what search engines display.
  • Redirects: old addresses that should lead to this article.

Format with the slash menu

Type / on an empty line, or after a space, to open Insert block. Keep typing to filter it, then press Enter. A slash inside a word, like and/or, stays text.

The Insert block menu open in the article editor
Type a slash on an empty line to insert a block.
Block What it does
Text Plain paragraph.
Heading Section title. Also typed as ##.
Subheading Subsection title. Also typed as ###.
Bullet list Unordered list. Also typed as *.
Numbered list Ordered list, for steps. Also typed as 1..
Quote Sets a passage apart. Also typed as >.
Alert A callout for a note or warning.
Code block Fenced code, with a language menu.
Divider A horizontal line.
Collapsible section Hides optional details under a title.
Image Uploads a picture.
Video Embeds a YouTube, Loom, or Vimeo video.
Table Rows and columns, with a header.

The article title is the page's top heading, so headings in the body start one level down. There are two levels: Heading and Subheading.

Select text to open a small menu with Bold, Italic, Strikethrough, Code, and a link button.

Alerts

An Alert has a type: Info, Success, Warning, Error, or AI. Pick the type from the Alert type menu on the alert. Use them sparingly. One warning that matters is read. Five are skipped.

Collapsible sections

Give every collapsible section a title. A section without one won't save. You can't put a collapsible section inside another one.

Images

Choose Image, then pick a file.

  • Allowed types: PNG, JPEG, GIF, or WebP.
  • Size: up to 5 MiB.
  • Add a caption in the Write a caption… field under the picture.
  • Select the picture to align it left, center, or right. Drag its edge to set the width, between 120 and 1,200 pixels.

Add images through Image. The editor has no paste or drag-and-drop upload.

Videos

Choose Video, paste the video's address or the whole embed code from Share, and select Add video. Only YouTube, Loom, and Vimeo videos work, and customers watch them without signing in. Videos show at one fixed width, centered.

Tables

Choose Table. The first row is the header. You can't drag column widths. On a narrow screen, a wide table scrolls inside the article.

Links

Select text and use the link button (or press Cmd+K on Mac, Ctrl+K on Windows). Links can start with https://, http://, or mailto:.

To link to another article, enter its path from your help center's address, for example /billing/update-card. For an article inside a subcollection, include each collection: /billing/cards/update-card.

Paste Markdown

Paste Markdown and the editor converts it: headings, quotes, lists, code fences, tables, and dividers. If what you paste came from a web page or a rich-text editor, the editor keeps that formatting instead.

Write for customers and for the AI

The AI answers from your published articles, the same way a customer reads them. What helps one helps the other.

  • One question per article. If a title needs "and", split it in two.
  • Use the customer's words in the title. "How do I reset my password?" beats "Credential management".
  • Answer in the first lines. Put the steps right after.
  • Write steps with the exact labels a person sees on screen, in bold: select Settings, then Billing.
  • Say what you can't do. "You can't change the invoice email after it's sent" saves a ticket.
  • Keep it under 100,000 characters. Past that, the editor asks you to split the article.

Look at Top searches in Help center analytics to find the questions your articles don't answer yet.

Delete an article

  1. Open the article.
  2. Open More actions and choose Delete.
  3. Confirm with Delete, or select Keep it to cancel.

The article is removed from your help center. Anyone with the old link gets a not-found page. If you only want it hidden for now, set State to Draft instead.

If something's not working

If you see "That file is larger than 5 MiB."

Compress or resize the image, then upload it again.

If you see "Pick a PNG, JPEG, GIF, or WebP image."

The file is a different type. Export it as PNG, JPEG, GIF, or WebP.

If you see "That address is already taken. Try another."

Another article in this help center uses that URL address. Change it.

If you see "Give every collapsible section a title."

Select the empty title on the collapsible section and type one.

If Save changes is grayed out

Nothing has changed since the last save, or an image is still uploading. Wait for the upload to finish.

Related

  • Organize collections
  • Set up redirects
  • Set up your help center
  • Help center analytics
Set up your help center

Name your help center, pick a layout, logo, and brand color, then publish it. Customers can search, browse, ask the AI chat, or open a ticket.

Organize collections

Group articles into collections and subcollections, set an icon and address, reorder them, move articles between them, and delete them safely.

Powered by initdesk