Redirect old articles to a new permalink

You can use the Old Links feature to 301 redirect retired permalinks and articles to a new location. To configure old links:

  1. Go to the new article and click on Old Links at the top of the editor.
    Old Links feature to 301 redirect
  2. Specify the old permalinks that should redirect to this new article, click Save Redirects, and click Save the article.

Note: You only need to copy the editable portion of the permalinks (e.g. april-10-2018, not So in this example, old-permalink-1, old-permalink-2, and old-permalink-3 are the previous permalinks I want to redirect to april-10-2018.

For old link redirects referencing a separate article (the first use case below), the old link articles you want to redirect need to be in an unpublished status--either Draft or Deleted.

Use Case

Old links let you redirect permalinks for old/outdated links to a current article. There are two primary use cases for old links:

  1. When you've written a new article that "replaces" an existing article
  2. When you've updated an article's permalink due to title or content changes

Let's look at each of these in turn.

Replacing an existing article

Linus, our trusty owl, has written an article called Giving a hoot about knowledge, and the permalink was something like:

After that article was published, his marketing team used that permalink in a public blog post on owls and wisdom.

Now, let's suppose that Linus has since written a new and better version of this content called Docs or it didn't happen:

But Linus isn't sure all the places out in the wide world that referenced that Giving a hoot article. And what if it was so brilliant that other people also referenced it, linked to it, or bookmarked it?

Old links to the rescue! Instead of trying to track down every instance of the original permalink for Giving a hoot about knowledge, Linus can set Giving a hoot about knowledge to a deleted status and enter the giving-a-hoot url as an old link for Docs or it didn't happen. When people try to go to the giving-a-hoot url, we'll auto-redirect them to docs-or-it-didnt-happen instead.

Updated permalink

In other cases, maybe Linus didn't write an entirely new article but, instead, he changed the title on an existing article and wants to change the permalink, too. Let's say Linus has an article whose permalink has always been this:

But that permalink was generated from the article's old title (A Hooting Good Time). When Linus updated this article to a new version,  he renamed it to "Why Knowledge Management Matters." He wants to update the permalink to:

But he also want any links or bookmarks to a-hooting-good-time to still work.

First, Linus can edit the current permalink to why-km-matters.

Then, he adds an Old Link to a-hooting-good-time so that the old URL will automatically redirect to why-km-matters:

Once Linus clicks Save Redirects and re-saves the article, anyone visiting

will be redirected to

In a nutshell, old links are here to make it easier for you to keep older/public article permalinks but have them point to the most recent relevant content.