University of Southampton

iSolutions

How to create a new Knowledge Base article

The Knowledge Base contains articles with solutions to questions and issues staff and students may come across at the university.

The guidance below details how to create a new Knowledge Base article - there are two ways to do this. Once the article has been created and submitted, it will need to be approved before it is live and visible to staff/students.

 

Two ways to create a Knowledge Base article

You can save your article and continue making changes before publishing.

Once ready, you can publish your article and send it for approval to a pool of approvers.

It is personal preference for which method to use. If you already have guidance in a Word document you may find it easier to upload this straight to the Knowledge Base. Or simply because you find it easier editing content in Word than within the Knowledge Base.

Import a pre-formatted article in a Word Document format

1. Create the content for your Knowledge Base article in a .docx Word document

2. Log in to ServiceNow

3. In the All tab, use the Filter Navigator search field, enter the text Knowledge Base

4. From the search results displayed below the search field, select Homepage - Import Article

5. Select Import Articles towards the top right of the screen

Import articles button

The Import dialogue box will display.

6. Select + To select word files

7. Locate the Word document containing your content for the article

Windows explorer dialogue box

The name of the document will display in the Article 1 field.

Import file dialogue box

8. From the Knowledge base drop down list, select which knowledge base this article should appear in

9. From the Category drop down list, select or search for the appropriate category

10. Select Import

When the document has finished uploading, at the foot of the screen you will see an Import completed dialogue box.

11. Select the arrow on the right

Import complete dialogue box

12. Select the file name of the article

A preview of the draft article will open:

13. Select Edit at the top right

The editing window will open:

14. Enter/edit the following fields:

  • Short description -  this will display as the article’s title when published
  • Meta - enter keywords that can be used to search for the article when published
  • Knowledge Owner - enter the name of your team
  • Article body - ensure you check the formatting of text and images as these may appear differently to your Word document. If you have added any images you must enter an alternative text (also called ALT text) for each image by selecting the insert/edit image button from the formatting toolbar

15. You can preview your article using View Article within Related Links:

Select the "go back" arrow on the top of your browser to come back to the editing page.

16. Select Save (under the Article body field or at the top right of the screen)

17. Select Publish (under the Article body field or at the top right of the screen)

 

If you wish to continue making changes before publishing the article, you can locate the article later as follows:

  1. Log in to ServiceNow
  2. Enter knowledge base in the search field
  3. Select Unpublished from the search results
  4. Select Author to view unpublished articles in alphabetical order by author

Remember to save and publish when you have finished editing the article.

---

Back to the top

 

Create an article using the formatting tools within the Knowledge Base

1. Log in to ServiceNow 

2. In the Filter Navigator search field on the left hand side, enter the text Knowledge Base

3. From the search results displayed below the search field, select Create New:

This will show the Select Article Template screen, select Standard

The New record editing screen will display.

New articles editing screen

4. Complete the following fields:

  • Knowledge base (IT, for example)
  • Category (telephony, for example)
  • Short description - this will display as the article’s title when published
  • Meta - enter keywords that can be used to search for the article when published
  • Knowledge Owner - enter the name of your team
  • Article body - add text and images, and use the formatting toolbar, to create your article content. If you have added images you must enter an alternative text (also called ALT text) for each image by selecting the insert/edit image button from the formatting toolbar

5. You can preview your article using View Article within Related Links.

Select the "go back" arrow on the top of your browser to come back to the editing page.

6. Select Save (under the Article body field or at the top right of the screen)

7. Select Publish (under the Article body field or at the top right of the screen)

 

Use the templates

Use our pre-formatted template called New Knowledge Base Article to make your article have the same style of the other IT KB articles. It’s not mandatory to use it, but it can be helpful.

To visualize them, click on the more options icon and then on Toggle Template Bar

 

A banner will appear at the bottom of the page. 

 

Select "New Knowledge Base Article”. The article field will be populated with instructions about:

  • How to write the short description
  • How to write the meta field
  • How to start your article
  • An example of a section title
  • How to structure the body copy
  • An example of the "Related links" section 

If you want to know more about how to structure your content, read the University Editorial Style Guide.

Back to the top

 

Make changes before publishing

If you wish to continue making changes before publishing the article, you can locate the article later as follows:

  1. Log in to ServiceNow 
  2. Enter knowledge base in the search field
  3. Select Unpublished from the search results
  4. Select Author to view unpublished articles in alphabetical order by author

Remember to save and publish when you have finished editing the article.

Back to the top

 

What happens next

After you have submitted your article for approval (by selecting Publish), your knowledge base article will be sent for approval to a pool of approvers.

Once your article has been approved by one of the approvers, it will be live in the system and they will send you a message.

To check if your article is live, go to the University Knowledge Bases homepage and search for your article.

---

Back to the top

 

Related content

Editorial Style Guide

Revising Knowledge Base articles

Attached files:

Was this article helpful?

If you have any further comments, please put them below.

Please note that feedback is anonymous - if you require a reply or assistance, please raise a ticket via ServiceLine.


Thank you for your feedback, it is much appreciated.

Back to List

We use cookies to ensure that we give you the best experience on our website. If you continue without changing your settings, we will assume that you are happy to receive cookies on the University of Southampton website.

×