-
Print
-
DarkLight
-
PDF
With Document360's URL mapping feature in Knowledge base assistant, you can display specific articles and categories depending on the page the end user is visiting with . You can also use URL mapping to hide the Knowledge base assistant on a specific URLs or provide a search bar with a custom placeholder to point end users in the right direction of what to search.
Using URL mapping
A URL mapping is configured for a specific action within the Knowledge base assistant on a particular URL.
Actions
There are four different actions you can trigger within the Knowledge base assistant:
- Hide - The Knowledge base assistant icon will not display on the specified URL
- Single - A single article will display within the Knowledge base assistant on the specified URL
- List - A list of selected articles will display under a "Recommended" section within the Knowledge base assistant on the specified URL
- Search - You can set a specific search term to query your knowledge base and return a list of search results within the Knowledge base assistant on the specified URL
These actions can be found within the Add URL Mapping panel or when you edit an existing mapping.
URL Parameters
There are three types of parameters you can include in a Knowledge base assistant URL configuration:
- Include Path:
/thisis/a/path
- Include Query:
?animal=bear
- Include Hash:
#inbox
You can also include regular expressions in your URL by enabling the Is Regex toggle.
Setting up recommended articles and categories to display in the Knowledge base assistant
-
Go to Settings → Knowledge base assistant → URL mapping
-
Click New URL mapping on the top right
-
Enter the following:
-
Friendly Name - The URL Mapping name will only be shown on the URL mapping record within Document360
-
URL pattern - Select the desired URL parameter type (Include path/Include query/Include hash). You must enable at least one URL parameter
Type in the URL on which you want the article/category to show or action to occurYour domain name is not included in the URL path. For instance,https://document360.com/ebook/rapid-guide-to-launch-your-knowledge-base/
, your URL Path would be/ebook/rapid-guide-to-launch-your-knowledge-base/
-
Action - Select the desired action
-
Project version - Select the desired version (if you have multiple versions)
-
Language version - Select the desired language (if you have multiple languages)
-
Article - In the search bar, select the articles/categories you want to show from your knowledge base documentation
Category typeFolder categories are not available for selection. Only page and index category types are available for selection.
-
-
Click Create
Suppose an end user goes to the URL path you specified and opens the Knowledge base assistant. In that case, they will see the article/category you've added. The article/category will be retained even when you navigate between the Knowledge base assistant tabs within the same version and language.
What happens when URL mapping is not configured for a certain page URL?
When URL mapping is not configured for a specific page URL, the last opened article in the knowledge base assistant is delivered.
For example, there are two URL paths
example.com/page1
example.com/page2
You have configured URL mapping just for
page1
. So when you open the Knowledge base assistant inexample.com/page1
, the configured articles will appear. Now, if you navigate toexample.com/page2
and open the Knowledge base assistant, the configured articles ofpage1
will be delivered. Since URL mapping is not configured forpage2
, the last opened article in the knowledge base assistant appears.
Editing URL mapping
You can edit the already set URL mapping.
-
Go to Settings → Knowledge base assistant → Setup configuration
-
Hover over the desired Knowledge base assistant and click Edit
-
In the URL mapping tab, you can find the list of available URL mapping
-
Hover over the desired URL mapping and click the Edit icon
-
The Update URL mapping blade appears
-
Update the desired information and click the Update button
Deleting URL mapping
- Go to Settings → Knowledge base assistant → Setup configuration
- Hover over the desired Knowledge base assistant and click Edit
- In the URL mapping tab, you can find the list of available URL mapping
- Hover over the desired URL mapping and click the Delete icon
- Click Yes in the Delete confirmation prompt