The KB allows you the option to assign a UrlSlug for each new document based on its title. Using short, memorable URLs makes it easier for visitors to find and share your content. While the document title remains designed for display and human readability, its slug may be optimized for brevity or for consumption by search engines.
A UrlSlug is the part of a URL which identifies the document using human-readable keywords.
UrlSlugs can be generated by the KB author from the document title and also can also be further edited. While the page title remains designed for display and human readability, the UrlSlug may be optimized for brevity or for consumption by search engine page results. Longer document titles may also be truncated to keep the final UrlSlug to a reasonable length.
To find the UrlSlug field in a New Document, go to the KB Admin Tools > Documents tab > NewDoc link. The UrlSlug field is located under the Title field. It is not a required field.
In the image below, we see an arrow pointing to the UrlSlug field in the Creating a New Document screen.
At the touch of a button, your document's url can become a friendlier url.
In the image below, the Make slug link was used to create a UrlSlug in an already existing document. The UrlSlug contains all the words in the Title, however they are all in lowercase and separated by dashes "-".
While your document Title may adhere to a specific naming standard, the Title based UrlSlug may not be all that informative. You may edit the UrlSlug to make it even more meaningful to your users.
After you save your document, you will see the current UrlSLug field in the document information table while viewing your doc in Document Review Mode while in the KB Admin Tools. The image below shows the current UrlSlug in that document.
Any words you add to the UrlSlug that are not found in the Title field will automatically be added to the Keywords field. In the image below, the words that are not found in the Title field that were added to the UrlSlug field, "docs" and "group" has been added to the keywords.
Your keyword updates will be captured in the Revision History. In the image below, the two keywords that were added as a result of the UrlSlug update are circled in red.
When viewing the document in the Live Site(s), you will see that the UrlSlug has been changed to a hotlink called a CleanUrl. It is found the Document Information Table at the bottom of the document.
In the image below, you will see the CleanURL circled in red beneath the Sites filed in the Document Information Table of a Live document..
The CleanURL is friendly and easy to remember. You may copy and paste the link into emails, chat windows and other communiques. The CleanURL helps cut down on typos because there is less confusion about what exactly to write and type.
KB Admins need not worry whether their UrlSlug is unique or not. Uniqueness is not enforced.
In the image below, a search was performed on the Wisconsin Unified site at https://kb.wisc.edu. The UrlSlug, "kb-training-demo-document" was typed in the browser. Three documents with the same UrlSlug appeared. Each document is owned by a different KB Group.
The URL displayed in the browser immediately changes to list the 3 document ID numbers that have identical UrlSlugs. In the image below, you will see the UrlSlug is replaced by 3 document ID numbers circled in blue.
You may enter the single word "internal" in the UrlSlug field. However, since the word "internal" appears in the document URL (e.g. when a document is saved to the internal KB site), the KB System appends the Document ID number to the word "internal". There is no space in between the word "internal" and the Document ID.
The image below shows document 75464 with the single word "internal" in the UrlSlug field. Once the Save Change or Submit button was clicked, the KB System appended the UrlSlug with the Document ID, "75464". Note that there is not a space between "internal" and the Document ID number in the lower half of the image.
You may enter the single word "external" in the UrlSlug field.
The image below shows the single word "external" in the UrlSlug field of document 36805.
When you call the document up on either of your Live KB Sites, the CleanURL will present your KB Group Space name and the word "external" in the Document Information Table located at the bottom of the page..
The image below shows a Live Site side-by-side comparison of both CleanURL fields for document 36805. On the left, the Internal Site document presents a CleanURL of https://kb.wisc.edu/kbGuide/internal/external. The Public Site on the right presents a CleanURL of https://kb.wisc.edu/kbGuide/external.