Plans supporting analytics on link status
Free | Professional | Business | Enterprise |
---|---|---|---|
Links status is a sub-feature under the Analytics section of Document360. This feature is a broken link checker that helps validate and monitor all internal, external, and media file links on the knowledge base. It allows you to fix bad/broken links to improve Search Engine Optimization (SEO) and enhance the reader experience.
With the following validations, you can run the link validation at a workspace and language level.
Scheduled validation
Manual validation
Article level validation
NOTE
For manual and scheduled validation, all the links at the project level are analyzed to check for broken/unknown/working links.
Accessing Links status
On the Knowledge base portal, click on the Analytics () icon on the left navigation sidebar.
Click Links status on the left navigation pane.
The Links status overview page will appear.
You will find a list of all the links used in the selected workspace and language.
Links status overview page
This page contains all the necessary data regarding the links used in your Knowledge base (selected workspace and language). You have two sections on the page: Links status tiles and Links list.
1. Links status tiles
Links classification
Total links – The total number of URLs and files (both internal and external) linked in the different articles on your Knowledge base.
Internal – The total number of Internal URLs (article links and media file links within your Document360 project).
External – The total number of External URLs (article links and media file links outside your Document360 project).
Ignored - The links you want to ignore in the current validation or upcoming validation.
Current state
Redirected - When the link has been temporarily or permanently routed to a different URL.
Working – The link works fine and points to an intended webpage or file (Internal and External).
Broken – A broken or dead link is a hyperlink in the article that no longer works because it's encountering one or more issues like URL changes, incorrect URL, page or item removed, or restricted/private knowledge base article URL. Broken status applies to URLs and media files.
Unknown – The link that does not return a status.
Broken link/image
Link – When the reader clicks on a broken link, a 404-page error or similar message showing that the webpage is unavailable is displayed.
Media files – In the case of an image or video file, a broken image thumbnail icon would be displayed in place of it in the article.
2. Links list
The list of all links used in the entire workspace is displayed below the Links status section. You can find the following information about the links used.
Field | Description |
---|---|
Article name | The article name in the Knowledge base that contains the link. |
Link type | Links: Internal link, External link, Secured link, Unsecured link |
URL | The actual web link (destination URL) |
Redirect URL | If the existing source path has been redirected to a new destination. |
Status | Indicating the status of the link. Working, Broken, Redirected, or Ignored. |
If you have deleted an article after the validation and the report has been generated, the article is grayed out. A trash icon appears next to the article name.
Filters
The Filter button at the top of the Links list section is useful when you have more number of links. You can filter links based on four parameters: the Source, Visibility, Link type, and Status.
Once you have selected the filter, click Apply.
You can also apply filters directly by clicking on the Link status tile that you prefer to view. For example, when you click on the Broken or External link status tile, the respective links with the link type or status are displayed in the list.
Export CSV
Export the Links list and status into a .csv (Comma-separated values) file to your local storage.
Click on the Export CSV button next to the Filter button.
Wait for a few seconds, and a Download () icon appears next to the Export CSV button.
Click on the icon, and the file will be downloaded to your local computer storage.
Actions and Controls
Above the Links status sections, you can find the controls and data regarding the link analytics.
a. Validation type
The validation types are Scheduled, Manual, and Article level.
b. Report date
The date of the reports generated will be loaded here. The validation reports are named as per the generation date.
When you hover over the info () icon adjacent to the Report data dropdown, you can view the next or upcoming Scheduled link validation date.
NOTE
Link validation runs every 7 days.
c. Manage links
This button opens the Manage links window.
This window contains information about all the links used, and also those which are Ignored or Included in the validations under respective tabs.
d. Validate links
This button initiates the Manual link validation at the project level.
When you click Validate links, a confirmation prompt pops up to alert you with the number of manual validations left for the month.
To proceed, click Confirm.
e. Manual validation usage:
This status bar shows your project's available Manual validation limit as per your project plan. The limit resets every month.
Customers of all price tiers can opt for an increase in the link validation limit anytime based on their requirement for a nominal charge.
For additional information, contact our support team.
f. Link analytics usage
This status bar shows the stats of the link limit used out of the total limit for your project.
Links analytics limit exceeded
When the links count is higher than the total count of links limited for your project, the Links analytics limit exceeded text appears instead of the Link analytics usage.
When the link analytics limit is exceeded, and the links validation (both Scheduled and Manual validation) takes place, only the links under the total given limit are validated.
The extra links that exceed the limit are not validated. Article-level validation is also not possible for those links.
For example, your total link limit is 10000, but the total link count in your project is 10500. Only the first 10000 links are validated when you perform the links validation. The recently added 500 links are not validated.
To validate all the links in your project, contact our support team to increase the limit for your project.
Link validation
You can perform link validation at a workspace and language level in the below ways,
Scheduled validation
Manual validation
Article level validation
NOTE
For manual and scheduled validation, all the links at the project level are analyzed to check for broken/unknown/working links.
1. Scheduled validation
This is an automated link validation that runs on a Schedule, based on your plan tier.
Steps to perform schedule validation
On the Knowledge base portal, click on the Analytics () icon on the left navigation sidebar.
Click Links status on the left navigation pane.
The Links status overview page appears.
From the Validation type drop-down at the top, select the Scheduled validation (which is the default selection for your projects).
You can find the recently generated Scheduled link validation.
If you want to look into any previous reports, from the Report date drop-down select the report date you wish to view.
2. Manual validation
Steps to perform manual validation
On the Knowledge base portal, click on the Analytics () icon on the left navigation sidebar.
Click Links status on the left navigation pane.
The Links status overview page appears.
From the Validation type drop-down at the top, select Manual validation.
The latest Manual validation report list will appear.
Click Validate links at the top right to perform a new manual validation.
NOTE
The analytics report for links is generated every 24 hours (UTC 00:00). If you run consecutive Manual validations within 24 hours, the already run manual validation reports are overwritten with the latest validation data. Once generated, data cannot be retrieved.
Once the validation is complete, you will receive a mail on your registered email, and you can view the analytics report on the overview page.
NOTE
Only team member roles with the Validate link analytics permission can perform link validations.
3. Article level validation
When choosing the Article level validation from the Validation type drop-down, you can view the article/category-page link validations you have already run. This overview page will be empty if you haven't validated links at the article/category page level.
Validate links at the article/category-page level
The article/category-page level link validation can be done from the article editor section.
Navigate to the desired article/category page in the Knowledge base portal.
Click on the More () icon at the top right.
Click Analytics from the listed options.
An Article Analytics modal window appears.
Click Validate now to perform validation.
NOTE
The article/category-page link validation is unlimited.
Manage links
Click Manage links on the Links status overview page.
The Manage links overview page will appear.
This section provides a high-level view of all the top metrics in the broken links.
Search - You can search for a specific URL.
Link type - Refers to whether the link is an External or Internal URL.
Dependency - The number of times the link has been referenced in the Knowledge base articles.
Status - To choose to see if a link is Ignored or Included.
Add links to Ignore/Include list
In the Manage links window, select the checkbox of the desired links you wish to ignore or include.
In the status column, you can set the status to Ignored or Included from the dropdown.
(or)
Select the checkbox of the desired link of which you wish to change the status.
Click on the Ignore option available above the links list.
The links that are set to Included status will be displayed in the Included tab, and the links set to Ignored status will be displayed under the Ignored tab.
Export
You can export the links into .csv format to your local storage.
Click on the Export CSV button above the links list.
Wait for a few seconds, and a Download () icon appears next to the Export CSV button.
Click on the icon, and the exported file will be downloaded to your local computer storage.
FAQ
What happens when a user exceeds the Manual validation limit?
When you exceed the validation limit as per your plan, the Validate links button will be disabled. The manual validation resets on the first day of every month, and the button is enabled again. You can contact our customer support if you need to increase this limit.