Rich text block

The Rich text block lets you add a heading and a paragraph directly to your knowledge base home page. Unlike the other body blocks that require specific content types like images, columns, or code - the Rich text block gives you a flexible space for any text-based content. It supports Markdown formatting in the paragraph, so you can add structured content like announcements, feature descriptions, or section introductions quickly, without needing custom HTML.

When to use the Rich text block

• Product or feature descriptions - Add a short description of what your knowledge base covers or highlight a key feature on your home page.
• Announcements - Post a release note, maintenance notice, or welcome message that readers see immediately on landing.
• Section introductions - Use a Rich text block between other body blocks to provide context or transition between sections of your home page.
• Simple formatted content - When you need bold, italic, lists, or hyperlinks in home page content but don't need an image alongside it. For content that combines text with visuals, use the Image with text block instead.

How to add a Rich text block

1. Navigate to Settings () in the left navigation bar of the Knowledge base portal.
2. In the left navigation pane, navigate to Knowledge base site > Site customization.
3. Click the Customize site button.

4. From the left dropdown, select Home page. The list of body blocks appears in the Body section.
5. Click Add section and select Rich text. The Rich text block is added to the list.
6. Click the Rich text block and select the desired background color.
7. Use the Reorder () icon to rearrange the block within the body section.
8. Click the Hide () icon to toggle the block's visibility without deleting it.
9. Expand the Rich text dropdown to access the Heading and Paragraph options.

How to configure the Rich text block

Heading

1. Click Heading to open the Heading panel.
2. Enter the desired text in the Heading text field.
3. Use the Text color palette to set the heading color.
4. In the Alignment section, choose Left, Center, or Right.
5. Click Delete to remove the Heading element from this block.

Paragraph

1. Click Paragraph to open the Paragraph panel.
2. Enter your content in the Paragraph text field.
3. Format the text using the following options:

4. Use the Text color palette to set the paragraph text color.
5. In the Alignment section, choose Left, Center, or Right.
6. Click Delete to remove the Paragraph element from this block.

How to save and publish

• Use the Preview toggle on the right to review your changes.
• Click Save to save your changes.
• Click Publish to make changes live.

Knowledge base site view

Here is an example of a Rich text block as it appears on the knowledge base site.

Best practices

• Keep the heading short and scannable - the heading is the first thing readers see in this block. One line is ideal.
• Use Markdown in the paragraph for quick formatting - instead of using the toolbar for every edit, you can write **bold**, *italic*, and - list items directly in the paragraph field.
• Match background color to your home page palette - if you're using multiple body blocks, keep background colors consistent or deliberately contrasted to create visual sections.
• Use the Rich text block for text-only content - if you need an image alongside the text, use the Image with text block instead.

FAQ