Setting Up 301 Redirects for Zoho Desk Knowledge Base Articles

Setting Up 301 Redirects for Zoho Desk Knowledge Base Articles

Every Zoho Desk Knowledge Base article is identified by a permalink, a URL made up of the category name, any sub-category names, and the article title, which is generated automatically when the article is published. Over time, updates and edits can mean that permalink no longer reflects the article's content well. For example, if an article originally about company privacy and security is expanded to include compliance guidelines, it makes sense for the permalink to include a term like "compliance" too. When you edit a permalink like this, the old URL needs to be redirected to the new one using 301 redirection, so links people already have keep working.

When you might need to edit a permalink

  • Combining content from multiple articles. If you merge two or three articles into one, renaming the result to reflect its new, broader content makes the redirection more straightforward.
  • A permalink with a date appended. If more than one article shares the same permalink or title, Zoho Desk automatically appends the date to whichever one was created or updated most recently.
  • A change in the article title. If you substantially update an article, renaming it to match the new content keeps the title and the permalink in sync, which also helps with search engine optimisation.

Availability and permissions

You'll need the Knowledge Base - Update permission on your profile to access 301 redirection at all. Beyond that, users with Edit permission on an article can edit that article's own permalink, while users with Edit All permission can edit the permalink of any article. You can set up a maximum of three 301 redirections per article.

Important: If you edit a permalink without setting up the matching 301 redirection, three things can go wrong: existing links to that article within your Knowledge Base module may stop working, any external links to it will show a 404 Not Found error, and search engines that still hold the old URL will also hit 404 errors, which can hurt your search rankings.

Avoiding a date being added to the permalink automatically

If you update an article and there happens to be another article with the same title, Zoho Desk appends the update date to the newly updated article's permalink to tell the two apart, for example turning a URL ending in zylker-communication-getting-started into one ending in zylker-communication-getting-started-13-12-2024. When this happens, you'll see an alert flagging that another article shares the same name.

Zoho Desk does this to keep articles distinguishable across every state, including drafts, unpublished, published, expired, deleted, and even items sitting in the Recycle Bin. To remove the date from the permalink, check your full list of articles under that category for another one with the same title, including in the Recycle Bin, and either delete or rename it. Once no duplicate title remains, the date can be removed from the URL.

Updating a permalink and setting up its redirect

  1. Open the article. In the Knowledge Base module, open the article whose permalink you want to change.
  2. Edit the permalink. Modify the permalink field, then click Edit to confirm the change.
Note: A permalink can be edited and saved as many times as you like, but you can only save and add a 301 redirection up to three times per article. Each redirection you add is listed on the article's Update Permalink page, and if you've already used all three, you'll need to remove an existing one before you can set up a fourth.

Adding a new redirect after merging articles

When you merge two or more articles into a single new one, the original articles become outdated and are usually deleted. However, if customers still have links to those deleted articles, they'll hit an error when they try to use them. Setting up a 301 redirection from the old articles' URLs to the new merged article avoids this. To do this, go to the Knowledge Base module, open the article you want to add the redirection to, and click the Edit icon to access the permalink and redirection settings.

Removing a redirect

To remove a 301 redirection, go to the Knowledge Base module and open the article that has the redirection you want to delete, then remove it from that article's redirection settings.

Need help? 1 Cloud Consultants can help you plan permalink changes, set up 301 redirects correctly, and avoid broken links when reorganising your Zoho Desk Knowledge Base. Book a discovery call with 1 Cloud Consultants.