How to enable Table of Content option for Knowledge Articles

Daemyian
Tera Expert

Does anyone know how to enable the Table of Content option for knowledge articles? We have use case for large knowledge articles which requires table of content added to link to different sections within the same article. Came across the following link, but can't figure out how to get the TOC button/icon enable. 

find_real_file.png

https://community.servicenow.com/community?id=community_blog&sys_id=ae29fcab1be6ec1038739979b04bcbb1

Thanks,

Daemyian

5 REPLIES 5

shannont
Giga Guru

Hi Daemyian,

 

Check this out: https://docs.servicenow.com/bundle/quebec-servicenow-platform/page/product/knowledge-management/task/insert-toc-html-editor.html.

When you start a new document, the icon will be greyed out and disabled. This is because it relies on specific HTML tags in your text to build the content list; the HTML headings. If you are familiar with HTML, these are the <h1>, <h2>, ... <h6> tags that you can use to organize your content.

image

You can mark a piece of text as a heading by putting your cursor in the text (no need to have it selected) and using the Paragraph toolbar item to set the heading level. You can choose from 6 levels.  It's common to use the top-level (<H1>) for page titles, which then means you should use the second level (<H2>) as the starting point in your KB article. This affects how search engines read and store your content (SEO).

Take, for example, the following piece of sample text:

Heading levels are showing in parenthesis after each section so you can see what it will look like in the TOC.

To create the TOC you simply have to locate your cursor where you want it in the text (usually at the top) and select the toolbar button. You will see that a new section appears:

image

Note that, in this example, only heading levels 2 and 3 are present in the TOC. This is the default behavior; it will only scan three levels deep and, because I didn't use H1, it will only include the H2 and H3 headings. This is currently not configurable.

The coolest part is that, whenever you update your article and add or remove sections with headings, you can refresh the TOC by clicking inside it and then clicking on the Refresh icon that appears. The internal links will be updated automatically.

Hope this helps!

Hi Shannont,

Thanks for your reply, we are currently on Paris version. Is this option only available in Quebec?

Thanks,

Daemyian 

I am trying to use the TOC feature, but the hyperlinks it is creating don't seem to be accurate.  We are using the proper heading level, and it create a TOC based on those headings, but the href is not right.  Am I doing something wrong?

 

<li><a href="#mcetoc_1fl4pcolu4" rel="nofollow">What to do if you are unable to log into any xxx computer or service</a></li>
<li><a href="#articleTitleReadonly" rel="nofollow">What is the Self Service Password Reset (SSPR) portal?</a></li>
<li><a href="#articleTitleReadonly" rel="nofollow">How to register for the Self Service Password Reset (SSPR) portal</a></li>
<li><a href="#articleTitleReadonly" rel="nofollow">How to unlock your account or reset your password</a></li>
<li><a href="#articleTitleReadonly" rel="nofollow">How to update your Self Service Password Reset (SSPR) authentication methods</a></li>
<li><a href="#articleTitleReadonly" rel="nofollow">How do I make a secure and easy-to-remember password?</a></li>
<li><a href="#articleTitleReadonly" rel="nofollow">What are xxxx's password complexity requirements?</a