Checking for Broken and Private Links

The Links page identifies any links that are not Valid, and any links that are Private.

  • A link that is not Valid is where it links to an article that is "Draft", "Archived" or "Deleted" in the Zendesk Help Center.
    If a reader of the Help Center clicks on the link, it would either break or it would only display if the user was signed into Zendesk.
    Checks are also made for links to pages on external websites and other URLs that are no longer valid.
    Refer below to Links that Help Center Manager Checks.
  • A link that is Private is where it links to an article that is set in Zendesk Help Center as Visible to anything other than "Everyone".
    If a reader of the Help Center clicked on the link, and they are not already signed in with the relevant access, they would be prompted to sign in to Zendesk.
In this Article
Checking Broken Links on the Links Page
Displaying all the Broken Links
Checking for Links to "Private" Articles
Links that Help Center Manager Checks
Links that are not Checked within an Article

Any links to articles that have a Publication Status in your Zendesk Help Center of "Draft" or to any articles that have been "Archived" or "Deleted" show in the Links page as not valid. These display in the Links page with a red x icon in the Valid column.

030 Not Valid Link.gif

Links to Draft Articles

  • Any linked articles that are "Draft" show as not Valid, and show with the Draft icon next to the Link Title.
    084 Link to Draft Article.gif
  • In Zendesk Help Center, if a reader clicks on one of these links, the article does not display and the reader is prompted to sign in.  

Links to Archived or Deleted Articles

  • Any linked articles that have been "Archived" or "Deleted" show as not Valid and show only the URL in the Link Title column.
    085 Link to Archived Article.gif
  • In Zendesk Help Center, if a reader clicks on one of these links it will show the following message.
    005 Broken Link Message in Zendesk.gif

These links need to be fixed. Refer to Fixing Broken Links.

  1. Click the Filters button to display the Filters.
  2. Select the Filter for Valid as "No". Refer to Using the Column Filters in Articles, Links and Media.

086 Links Valid No.gif

You can also use the Links page to check for links to any articles that are set in the Zendesk Help Center as Visible to anything other than "Everyone". These would be set as Visible to "Signed in Users" or "Agents and Admins", and if they are set for any other "User Segment" that you have set up in your Zendesk Help Center.

If a reader who is not signed in, or does not have the correct permission to the help, clicks on one of these links, the link does not break but the reader is prompted to sign in to Zendesk. You can check that any of these articles have the correct settings for Visible to that are intended. If you do want to include links to private articles, these would usually only be added to articles that are themselves private, or you may have a note next to the link that the information is only available for users with special access.

  1. Click the Filters button to display the Filters.
  2. Select the filter for Valid as "All" 
  3. Select the filter for Private as "Yes". Refer to Using the Column Filters in Articles, Links and Media.

090 Links Private Yes.gif

Help Center Manager checks the links in all "Published" and "Draft" articles in your Zendesk Help Center. Checks are made both when a link to an article has been added from the "Insert/edit Link" function in Zendesk using from the "Help Center article" tab or from the "URL" tab. 

The following links are shown as not Valid

  • A link to an "Archived" or "Deleted" article. If a reader clicks these in the Zendesk Help Center, it would break with the "oops" message.
  • Link to a "Draft" article (that is, it has been Unpublished in Zendesk). If a reader clicks these in the Zendesk Help Center, it would prompt a user to sign in.
  • Link to a Section that has been deleted (a link to a Section can be added as a link in Zendesk Help Center by adding the URL of the section).
  • Link to a page on an external website (such as a link to your website or any other web page) and that page no longer exists.
  • Link to a file that has been added as a URL link and the file has then been deleted or moved.

The following links are shown as Valid and show as Private

  • Link to a Published article that is not Visible to "Everyone". For example, where Visible to is set as "Agents and Admin", "Signed-un users" or to a "User segment" that has been set up for your Zendesk Help Center. These show in the Links page when the Private filter is set to "Yes". 

Links that are not Checked within an Article

Help Center Manager does not check any links to headings within an article. These are the links added from the Heading tab of the Insert/edit Link option in Zendesk. For example, if you add a link to a Heading within the article, and then delete that heading, if a reader clicks the link it does not respond or break in any way and the cursor just sits there. In this instance there is nothing that the Help Center Manager can check for.

Still need help? Contact Us Contact Us