Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Create a knowledge block

Create or modify a knowledge block to define a reusable piece of content that can be inserted into knowledge articles in a knowledge base. The knowledge block is secured by user criteria, which controls what users, groups, roles, companies, locations, or departments can read or not read the content in an article or search, enabling users to more easily view content that is relevant to them.

Before you begin

Activate knowledge blocks

Role required: user must have contributor access to the knowledge base.

Procedure

  1. Navigate to All > Knowledge > Knowledge Blocks > Create New.

  2. Click New or open a record.

  3. Fill in the fields on the form.

FieldDescription
NumberThis field is automatically set to a knowledge block number.
Knowledge baseName of the knowledge base.The knowledge blocks feature must be enabled for each knowledge base that you plan to create blocks. See Enable knowledge blocks for each knowledge base.
CategoryName of the knowledge category or subcategory.
Ownership GroupOwnership group for the knowledge block. This field appears when the ownership groups feature is enabled.Knowledge blocks can be used with or without the ownership groups feature. To learn more about ownership groups, including how to enable the feature, see Ownership groups.
Can readUser criteria to apply for read access at the knowledge block level.User criteria set at the knowledge base and knowledge block level controls which users can read or not read block content within an article. To learn more about selecting user criteria for a knowledge block, see Select user criteria for a knowledge block.
Cannot readUser criteria to apply for cannot read access at the knowledge block level.User criteria set at the knowledge base and knowledge block level controls which users can read or not read block content within an article. To learn more about selecting user criteria for a knowledge block, see Select user criteria for a knowledge block.
Valid toDate that the knowledge block expires. After the valid to date:- Knowledge article viewer will no longer display expired knowledge block content in the associated knowledge article. - Search will no longer return knowledge articles if the keywords are contained in the expired blocks.
Short DescriptionDescription of the knowledge block.
TextText of the knowledge block.
VersionThis field is automatically set to a version number when the article versioning feature is enabled.Knowledge blocks can be used with or without the article versioning feature. To learn more about article versioning, including how to disable the feature, see Article versioning.
Article typeThis field is automatically set to HTML.Note: Knowledge blocks are only supported with HTML knowledge articles.
WorkflowThis field is automatically set to the publication state of the block, such as Draft, Published, or Retired.
Source taskNot applicable.
  1. Click Save or Update to create or update the block.

  2. Click Publish to publish the block.

    Note: Any additional steps required to publish the knowledge block, such as approvals, depend on the publishing workflow for the knowledge base. See Knowledge workflows for more information.

What to do next

After the knowledge block is published, you can add the block to an article within the knowledge base.

  • Select user criteria for a knowledge block
    Control which users can read or not read knowledge block content within an article in a knowledge base by setting user criteria at the knowledge base and knowledge block level. As a knowledge contributor, you can apply user criteria at the knowledge block level.
  • Retire a knowledge block
    You can retire a published knowledge block so that it's no longer available for users to view or search.

Parent Topic:Using knowledge blocks