<h2>Add knowledge blocks to a knowledge article</h2><br/><div style="overflow-x:auto"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"><head><meta content="text/html; charset=UTF-8" /><meta name="copyright" content="(C) Copyright 2025" /><meta name="DC.rights.owner" content="(C) Copyright 2025" /><meta name="generator" content="DITA-OT" /><meta name="DC.type" content="task" /><meta name="DC.title" content="Add knowledge blocks to a knowledge article" /><meta name="abstract" content="You can insert one or more knowledge blocks into a knowledge article within a knowledge base. Each knowledge block is secured by user criteria, which controls who can read or not read the content in an article." /><meta name="description" content="You can insert one or more knowledge blocks into a knowledge article within a knowledge base. Each knowledge block is secured by user criteria, which controls who can read or not read the content in an article." /><meta name="DC.relation" scheme="URI" content="../../../using-knowlege-blocks.html" /><meta name="DC.relation" scheme="URI" content="../../../administer/general/concept/capabilities-bundle-landingpage.html" /><meta name="DC.relation" scheme="URI" content="../../../administer/general/reference/manage-content.html" /><meta name="DC.relation" scheme="URI" content="../../../product/knowledge-management/concept/knowledge-management.html" /><meta name="DC.relation" scheme="URI" content="../../../using-knowledge-management.html" /><meta name="DC.creator" content="ServiceNow" /><meta name="DC.date.created" content="2023-08-03" /><meta name="DC.date.modified" content="2024-02-01" /><meta name="DC.format" content="XHTML" /><meta name="DC.identifier" content="add-knowledge-block-to-knowledge-article" /><link rel="stylesheet" type="text/css" href="../../../CSS/commonltr.css" /><title>Add knowledge blocks to a knowledge article</title></head><body id="add-knowledge-block-to-knowledge-article"> <div class="breadcrumb"><a class="link" href="https://docs.servicenow.com/bundle/washingtondc-servicenow-platform/page/administer/general/concept/capabilities-bundle-landingpage.html" title="Extend the ServiceNow AI Platform with additional applications and features.">Extend ServiceNow AI Platform capabilities</a> > <a class="link" href="https://docs.servicenow.com/bundle/washingtondc-servicenow-platform/page/administer/general/reference/manage-content.html" title="Handle all the necessary aspects of document and knowledge base management for your enterprise with several ServiceNow products.">Manage content capabilities</a> > <a class="link" href="https://docs.servicenow.com/bundle/washingtondc-servicenow-platform/page/product/knowledge-management/concept/knowledge-management.html" title="The ServiceNow Knowledge Management (KM) application enables the sharing of information in knowledge bases. These knowledge bases contain articles that provide users with information such as self-help, troubleshooting, and task resolution.">Knowledge Management</a> > <a class="link" href="https://docs.servicenow.com/bundle/washingtondc-servicenow-platform/page/using-knowledge-management.html" title="Use Knowledge Management to search and find information on self-help, troubleshooting, and task resolution in knowledge bases.">Using Knowledge Management</a> > </div> <h1 class="title topictitle1" id="ariaid-title1">Add knowledge blocks to a knowledge article</h1> <div class="body taskbody"><p class="shortdesc">You can insert one or more knowledge blocks into a knowledge article within a knowledge base. Each knowledge block is secured by user criteria, which controls who can read or not read the content in an article.</p> <div class="section prereq p" id="add-knowledge-block-to-knowledge-article__prereq_c5w_cp3_2db"> <p class="p"><a class="xref" href="https://docs.servicenow.com/bundle/washingtondc-servicenow-platform/page/product/knowledge-management/task/activate-knowledge-advanced-plugin.html" title="Activate the Knowledge Management Advanced plugin (com.snc.knowledge_advanced) to enable advanced features for Knowledge Management.">Activate the Knowledge Management Advanced plugin</a></p> <p class="p">Role required: user must have contributor access to the knowledge base.</p> </div> <ol class="ol steps" id="add-knowledge-block-to-knowledge-article__steps_nfl_dp3_2db"><li class="li step stepexpand"> <span class="ph cmd">Navigate to <span class="ph menucascade"><span class="ph uicontrol">All</span> > <span class="ph uicontrol">Self-Service</span> > <span class="ph uicontrol">My Knowledge Articles</span></span>.</span> </li><li class="li step stepexpand"> <span class="ph cmd">Click <span class="ph uicontrol">New</span> or open a record.</span> <div class="itemgroup info">On clicking <span class="ph uicontrol">New</span>, you are provided options to select an article template. The article templates appear when you activate them in the <span class="ph menucascade"><span class="ph uicontrol">Knowledge</span> > <span class="ph uicontrol">Article templates</span></span>.</div> </li><li class="li step stepexpand"> <span class="ph cmd">Select an article template.</span> <div class="itemgroup info"> <div class="note"><span class="notetitle">Note:</span> You can add or remove knowledge blocks in more than one HTML field of any article template including custom templates.</div> </div> </li><li class="li step stepexpand"> <span class="ph cmd">Fill in the fields on the form, as appropriate.</span> <div class="itemgroup info">For more details on creating a knowledge article, see <a class="xref" href="https://docs.servicenow.com/bundle/washingtondc-servicenow-platform/page/product/knowledge-management/task/create-knowledge-article.html" title="Knowledge contributors can create and edit knowledge articles within a knowledge base to share information across your organization.">Create a knowledge article from an incident in <span class="ph">ITSM Agent Workspace</span></a>.<div class="note"><span class="notetitle">Note:</span> Knowledge blocks are only supported with HTML knowledge articles. Make sure that the <span class="ph uicontrol">Article type</span> field is set to <span class="ph uicontrol">HTML</span>.</div> </div> </li><li class="li step stepexpand"> <span class="ph cmd">In the article body, click where a block needs to be inserted and then click <span class="ph uicontrol">Add Blocks</span>.</span> <div class="itemgroup info"> <div class="p">If the <span class="ph uicontrol">Add Blocks</span> button is not visible, make sure that the knowledge blocks feature is enabled for the knowledge base that the article is in. See <a class="xref" href="https://docs.servicenow.com/bundle/washingtondc-servicenow-platform/page/product/knowledge-management/task/enable-knowledge-blocks-for-knowledge-base.html" title="Enable the knowledge blocks feature for each knowledge base where you plan to use the blocks. Once enabled, you can create knowledge blocks to add to knowledge articles within a knowledge base.">Enable knowledge blocks for each knowledge base</a> for more information.<div class="note"><span class="notetitle">Note:</span> Blocks can be added to only the text field.</div> </div> <p class="p">In the <span class="ph uicontrol">Add Blocks</span> side panel, you can search for, do an advanced search, view, and insert knowledge blocks into the article. To use condition builder with advanced search, see <a class="xref" href="https://docs.servicenow.com/csh?topicname=c_ConditionBuilder&version=washingtondc&pubname=washingtondc-platform-user-interface" target="_blank" rel="noopener noreferrer">Condition builder</a>. You can also create blocks directly from the side panel.</p> <div class="p"><ul class="ul" id="add-knowledge-block-to-knowledge-article__ul_ubt_14x_tjb"><li class="li">You can configure the number of search results displayed in the <span class="ph uicontrol">Add Blocks</span> side panel using the <span class="keyword parmname">glide.knowman.add_blocks.search_results</span> property. By default, the minimum number of search results displayed is 6 and the maximum number of search results displayed is 25. See <a class="xref" href="https://docs.servicenow.com/bundle/washingtondc-servicenow-platform/page/product/knowledge-management/reference/r_KnowledgeProperties.html" title="As an administrator, you can configure the look and functionality of many knowledge base features with Knowledge Management properties.">Knowledge properties</a> for more information.</li><li class="li">If there are knowledge blocks you cannot find, make sure that the blocks are published, in the same language, and in the same knowledge base as an article.<img class="image" id="add-knowledge-block-to-knowledge-article__image_ym2_cy3_2db" src="../image/knowledge-blocks-insert-blocks-into-article.png" alt="Insert knowledge blocks into article, as well as search for and create blocks." /></li></ul> </div> </div> </li><li class="li step stepexpand"><strong>Optional: </strong> <span class="ph cmd">Rearrange knowledge block in the article body.</span> <table border="1" frame="hsides" rules="rows" cellpadding="4" cellspacing="0" summary="" class="simpletable choicetable choicetableborder" id="add-knowledge-block-to-knowledge-article__choicetable_fph_h4t_rhb"><colgroup><col style="width:50%" /><col style="width:50%" /><table><thead><tr class="sthead chhead"><th class="stentry choptionhd" style="vertical-align:bottom;text-align:left;" id="d914063e210-option">Option</th><th class="stentry chdeschd" style="vertical-align:bottom;text-align:left;" id="d914063e210-desc">Steps</th></tr></thead><tbody><tr class="strow chrow"><th style="vertical-align:top;" headers="d914063e210-option" id="d914063e223" class="stentry choption">If you are using a mouse</th><td style="vertical-align:top;" headers="d914063e210-desc d914063e223" class="stentry chdesc"> <ol class="ol" type="a" id="add-knowledge-block-to-knowledge-article__ol_f4z_44t_rhb"><li class="li">Click the block to select it.</li><li class="li">Drag and drop the block within the article.</li></ol> </td></tr><tr class="strow chrow"><th style="vertical-align:top;" headers="d914063e210-option" id="d914063e241" class="stentry choption">If you are using a keyboard</th><td style="vertical-align:top;" headers="d914063e210-desc d914063e241" class="stentry chdesc"> <ol class="ol" type="a" id="add-knowledge-block-to-knowledge-article__ol_ev2_34t_rhb"><li class="li">Place your cursor to the left of the block.</li><li class="li">Press the right arrow key to select the block.</li><li class="li">Use Ctrl+x and Ctrl+v to cut and paste the block within the article.</li></ol> </td></tr></tbody></table></colgroup></table><div class="itemgroup stepxmp"> <p class="p">The following GIF shows an example of a user moving a knowledge block within an article using a keyboard.</p> <img class="image" id="add-knowledge-block-to-knowledge-article__image_jrv_trt_rhb" src="../image/knowledge-blocks-with-keyboard.gif" alt="Using the keyboard to rearrange knowledge blocks within an article." /> </div> </li><li class="li step stepexpand"> <span class="ph cmd">Click <span class="ph uicontrol">Save</span> or <span class="ph uicontrol">Update</span> to create or update the article.</span> <div class="itemgroup info"> <div class="note"><span class="notetitle">Note:</span> You can preview the article with the blocks by user or, if published, date. See <a class="xref" href="https://docs.servicenow.com/bundle/washingtondc-servicenow-platform/page/product/knowledge-management/task/preview-knowledge-article-with-knowledge-blocks.html" title="Preview a knowledge article with knowledge blocks by user or, if published, by date. For an unpublished article, you can preview the article by user by impersonating different users to see how the article displays or hides block content (based on the user criteria set at the knowledge base and knowledge block level). For published articles, you can preview the article by both user and date to see how the article appears in past versions for different users.">Preview a knowledge article with knowledge blocks</a> for more information.</div> </div> </li><li class="li step stepexpand"> <span class="ph cmd">Click <span class="ph uicontrol">Publish</span> to publish the article.</span> <div class="itemgroup info"> <div class="note"><span class="notetitle">Note:</span> Any additional steps required to publish the knowledge article, such as approvals, depend on the publishing workflow for the knowledge base. See <a class="xref" href="https://docs.servicenow.com/bundle/washingtondc-servicenow-platform/page/product/knowledge-management/reference/r_KnowledgeWorkflows.html" title="The publishing and retirement processes for a knowledge article are controlled by workflows defined for the knowledge base that the article belongs to.">Knowledge workflows</a> for more information.</div> </div> </li></ol> </div> <div class="related-links"> <div class="familylinks"> <div class="parentlink"><strong>Parent Topic:</strong> <a class="link" href="https://docs.servicenow.com/bundle/washingtondc-servicenow-platform/page/using-knowlege-blocks.html" title="Use knowledge blocks to simplify knowledge authoring for writers and knowledge consumption for readers.">Using knowledge blocks</a></div> </div> </div></body></html></div>