This page contains aliases for other pages in the Knowledge Base. This is for administrative purposes only. Aliases and redirects prevent broken links to the Knowledge Base from other sources. 

We create an alias every time we rename a page. If we create a new page to replace an out-of-date one, we redirect the old page to the new page. 

Add an Alias

Let's say you've changed a page title from "Create a Page" to "Make a Page." 

1. Open the Confluence page to which you want to add an alias 
   • This is the page with the new title
   • In our example, that would be "Make a Page"
2. Edit the page

   • The Confluence editor will open

3. Click the + icon in the toolbar, then Other macros
   • The + icon represents "Insert more content"

   • A list of macros will open

4. Find the Alias macro
5. Click on the macro thumbnail

   • The macro form will open

6. Enter the alias name you want to use in the "Name" field
   1. • This is the old title of the page you're editing
      • In our example, that would be "Create a Page"
7. Enter Aliased Pages in the "Parent Page" field
   • This makes this page (the one you're currently reading!) the parent of the aliased page
8. Click Insert

   • The macro will appear on the page

Now we'll put the Alias macro inside the Excerpt macro. This is a trick to keep the page from displaying a confusing alert message when redirected from an Alias. 

1. Click the + icon in the toolbar, then Other macros again
2. Choose the Excerpt macro
3. Check off "Hide Excerpted Content" 
4. Insert the macro
5. Click and drag the Alias macro inside the Excerpt macro 
6. Save the page
   • The Alias macro should be invisible

   • The aliased page name will appear as a child under this page

7. Test the alias by going to the old page name URL
   • In our example, that would be "https://wiki.shanti.virginia.edu/display/KB/Create+a+Page"

   • A brief redirection notice will appear, then the page with the new name will open

Redirect a Page

Let's say you have an archived page called "Old Make a Page" that you want to redirect to "New Make a Page." 

1. Open the Confluence page that is out of date 
   • This is the archived page
   • In our example, that would be "Old Make a Page"
2. Edit the page

   • The Confluence editor will open

3. Click the + icon in the toolbar, then Other macros
   • The + icon represents "Insert more content"

   • A list of macros will open

4. Find the Redirect macro
5. Click on the macro thumbnail
   • The macro form will open
6. Enter the new page to which you want to redirect in the "Location" field
   1. • This is the new version the page you're editing
      • In our example, that would be "New Make a Page"
7. Keep the default settings for the other fields
8. Insert the macro
9. Save the page
   • The page will redirect to the new version in a few seconds