***

title: Moveworks-Ready Knowledge Blocks
excerpt: ''
deprecated: false
hidden: false
metadata:
title: ''
description: ''
robots: index
next:
description: ''
---------------

# Knowledge Blocks?

Knowledge blocks are reusable pieces of content secured by their own access controls that you can add to knowledge articles in a knowledge base.

Moveworks has reviewed hundreds of knowledge blocks live in production systems across our customers. We’ve identified the following best practice modes for using knowledge blocks: **Q\&A Pages** and **Step-by-step instructions**.

# Mode 1: Q\&A Pages

**In ServiceNow, your Knowledge Blocks for`Q&A pages` look like this:**

![In the article editor, your blocks show up as “boxes”.](https://files.readme.io/2338b45-Screen_Shot_2022-03-11_at_5.22.46_PM.png)

![In the service portal, the article view renders all the blocks’ HTML content.](https://files.readme.io/0128a5a-Screen_Shot_2022-03-11_at_5.32.29_PM.png)

**How it shows up in Moveworks:**

Moveworks ingests the individual Knowledge Blocks and snippetizes them into concise answers that directly answer the user’s question. They won’t have to scroll through the FAQ page for results.

![](https://files.readme.io/af42d8d-Screen_Shot_2022-03-11_at_5.35.12_PM_1.png)

<Callout intent="success">
  **Pro Tip**: Having each Q\&A pair be its own knowledge block will make results more concise.
</Callout>

# Mode 2: Step-by-step Instructions

**In ServiceNow, your Knowledge Blocks for`Step-by-step instructions` look like this:**

![Editor](https://files.readme.io/7f61ddb-Screen_Shot_2022-03-11_at_5.38.01_PM.png)

![Service Portal](https://files.readme.io/7560e61-Screen_Shot_2022-03-11_at_5.40.18_PM.png)

**How it shows up in Moveworks:**

**Note**: Users will be able to trigger both the parent article’s instructions AND the child article’s instructions independently.

![](https://files.readme.io/4332ce8-Screen_Shot_2022-03-11_at_5.48.31_PM.png)

<Callout intent="success">
  **Pro Tip**: The short description of the knowledge block (`How to log in to HR Services Portal`) is title of the link in chat. If someone clicks on this link, it’ll take them to the **Knowledge Block** in ServiceNow.
</Callout>

# Best Practices

## Cross-Linking Resources

Sometimes, you may want users to have quick access to Knowledge blocks from their knowledge articles. “Cross-linking” these resources is the best way to do this.

**If you had a knowledge article and a knowledge block that originally looked as below\...**

![Knowledge article vs. Knowledge block within the article](https://files.readme.io/8ea8e62-Untitled_-_2023-07-12T165358.272.png)

You can edit the knowledge article to “cross-link” to the knowledge block. Note that the `KBB` number may show up in the article content, but the rest of the article still renders correctly.

![](https://files.readme.io/434d0d2-Untitled_-_2023-07-12T165226.142.png)

## Hierarchical Access Controls

Generally, knowledge blocks are used in ***multiple*** knowledge articles, so they don’t “inherit” any access controls. In fact, knowledge blocks have their own public pages, similar to knowledge articles.

![](https://files.readme.io/a793fad-Untitled_-_2023-07-12T164932.471.png)

If your knowledge block is only used in a single article, and you want it to follow the parents’ access controls, you should ***explicitly*** copy over all user criteria from the knowledge article to the knowledge block.

![](https://files.readme.io/7eb7c3a-Untitled_-_2023-07-12T164900.178.png)

## Knowledge **Design**

### Recommendations for Knowledge Blocks

Make sure to provide a quality `short_description` for each of your Knowledge Blocks.

![](https://files.readme.io/9b704b7-Untitled_-_2023-07-12T164809.039.png)

Short descriptions for your knowledge blocks will appear as the linked title in chat. When users click on it they will navigate to the article in your service portal.

### Recommendations for Articles

You should try to keep the pre-text of any parent articles relatively short.

![Here, the article start with too much “fluff” content, so answers are not immediately visible.](https://files.readme.io/c722a93-Screen_Shot_2022-03-12_at_4.10.58_PM.png)

This way, answers won’t be pushed below our 2000 character limit.