Creating and inserting reusable information with content blocks

Note: To access this feature you must be on the Guide Enterprise plan and sign up for the EAP. If you’re not currently on Guide Enterprise but would like to participate, reach out to your account manager for an exception.

After you have enabled your article for content blocks, you can create and insert content blocks.

You can create a content block from a single unit of content, for example, a paragraph, a section heading, a code block, or a bulleted list. You can also create a content block from multiple (consecutive) sections of content in an article, or even from the text of an entire article. You can use one or many content blocks within an article, alongside regular text. In this article regular text refers to any article text that you create that is not in a content block.

Guide admins can create and insert content blocks on any article that is enabled for content blocks. Agents can only create and insert content blocks in articles that they have permission to edit.

This article covers the following topics:

• Creating a content block for reuse
• Inserting a content block into an article

Creating a content block for reuse

After you have enabled your article for content blocks, you can start creating reusable content.

To create a content block

1. In your article, select the content you want to make into a reusable content block.
   Note: If you select a fragment of text, for example, one sentence within a paragraph, the whole paragraph will be included in the new content block. A paragraph or section heading is the smallest fragment of content that you can include in a content block.
2. On the top toolbar, click the content block () icon.
3. Give the content block a meaningful name, so that you can easily identify it when you reuse it in other articles.

   

4. Format the content within the content block as needed, using the toolbar, for example, adding bold or inserting a link.

   Formatting the content in a content block affects all articles that use this content block.

5. Click Create.

   The content is now a content block and is stored independently for reuse by other articles. In the article, the text appears with a gray background. You don't need to save the article to create a content block.

Inserting a content block into an article

After you have enabled your article for content blocks, you can insert reusable content.

To insert content from a content block

1. In your article, click where you want to add reusable content.
2. On the top toolbar, click the content block () icon.

   A list of available content blocks appears.

3. Choose the content block that you want to add.
   Refine your results by:
   • Specifying part of the content block name. Only the content block name is searched, not the content block body.
   • Sorting by edited date or created date.
   • Sorting alphabetically.
   You can also specify the language of the content block, if translated versions are available.
4. Click a content block to preview the content.

   

5. Click Insert.

   The content block is inserted into the article and appears with a gray background.

   In the source code view (), you won't see any HTML code for content blocks, only for your regular text. This is because content blocks live independently in the help center. Additionally, you'll only see the HTML code for the chunk of regular text where your cursor is placed, between content blocks.

   If your cursor is above a content block and you click the source code view, you will only see the HTML code for the text above the content block. To see the HTML code below the content block, place your cursor below the content block, then open the source code view.