Redirecting an article URL

You can set up an article redirect rule for any published or draft article URL. The redirect feature would be helpful when you change a specific article's URL and the same article URL has been referenced in different articles in your Knowledge base. You can also perform a bulk import of redirect rules.

Article redirect rules would prevent users from clicking on a dead link or broken link.

Set up an article redirect rule

You can change the article URL or slug after or before publishing the article or category page. The index type category URL can also be altered.

1. From the knowledge base portal, go to Settings → Knowledge base site → Article redirect rules
2. You can find the list of previously added Article URL redirect rules (if any)
3. Click New direct and a Redirect rule blade appears
4. Select the desired redirect type
   a. Ends with: To set the redirection rule for an article
   b. Replace with: To set the redirection rule for the URL text between the domain name and article slug

Ends with

5. Source path: Type in the URL slug you want to redirect from

6. Destination path: Type in the complete destination URL (or) Type in the desired URL slug you want to redirect to

For example, you want to redirect the article URL https://docs.document360.com/docs/getting-started-with-document360 to https://docs.document360.com/docs/getting-started-video-library:

Add the source path and destination path as mentioned below:
Source path: /getting-started-with-document360
Destination path: getting-started-video-library

7. Click Save

Replace with

8. Source path: Type in the URL text between the domain and article slug you want to redirect from

For example, the source path in https://project.technicaldocumentation.com/v1/docs/fr/getting-started is /v1/docs/fr/

9. Replace text: Type in the desired URL text you want to redirect to

For example, you can replace v1/docs/fr with v2/docs/en in the following URL https://project.technicaldocumentation.com/v1/docs/fr/getting-started

10. Click Save

Best practices

When you have a multi-lingual knowledge base with multiple project versions, set redirect rules for each language/version according to the requirement.

For example, when you set a redirect rule with Source path as /customer-support and Destination URL as sales-and-support, this redirect rule applies only to the main version's default language.

1. To make the above redirect rule applicable for any other language (German-de) in the main version, you must set a new redirect rule with Source path as /de/customer-support and Destination URL as de/sales-and-support

2. To make the above redirect rule applicable for the main language in another version (v1), you must set a new redirect rule with Source path as /v1/docs/customer-support and Destination URL as v1/docs/sales-and-support

3. To make this applicable for another language (German-de) in other versions (v1), you must set a new redirect rule with Source path as /v1/docs/de/customer-support and Destination URL as v1/docs/de/sales-and-support

The other language/version refers to the language/version available in the knowledge base, excluding the main language/version.

How to set a site redirect rule?

On the Article redirect rules page, you can set up a subfolder redirect rule at the site level with the Replace with option. This option comes in handy when you migrate from another platform or want to redirect a deprecated version/language of the knowledge base.

For example, you want to set a redirect rule for the subfolder path azure/serverless to data/clould360 in the URLs https://apidocs.serverless360.com/azure/serverless/article_slug

For more information, visit the Migrating documentation article.

Editing redirect rule

You can edit any article redirect rules anytime.

1. From the knowledge base portal, go to Settings → Knowledge base site → Article redirect rules
2. You can find the list of previously added Article URL redirects
3. You can use Filter by to find the desired redirection rule
4. Hover over the desired URL, and you can find an Edit (Pencil) icon on the right
5. Click the Edit icon, and a blade appears on the right
6. Update the desired field(s)
7. Click Update

Deleting a redirect rule

You can delete any article redirect rules anytime.

1. From the knowledge base portal, go to Settings → Knowledge base site → Article redirect rules
2. You can find the list of previously added Article URL redirects
3. You can use Filter by to find the desired redirection rule
4. Hover over the desired URL, and you can find a Delete (trash bin) icon on the right
5. Click the Delete (trash bin) icon, and a Delete confirmation prompt appears

4. Click Yes in the Delete confirmation prompt

Deleting multiple redirect rules

You can delete multiple redirect rules at once.

1. From the knowledge base portal, go to Settings → Knowledge base site → Article redirect rules
2. You can find the list of previously added Article URL redirects
3. You can use Filter by to find the desired redirection rule
4. Hover over the desired redirect rule and select the checkbox adjacent to the desired redirect rule(s)
5. Click the Remove button on the top

How to delete the "Redirect rules" on multiple pages?

The pagination display is 50 redirect rules on a single page.

1. Click the Select all button, and the 50 records available on that page will be selected.
2. If you wish to choose multiple other page records, navigate to the desired page(s) and click the Select all button

The count of the selected redirect rules appears at the bottom-right as Number of rules selected.

3. Click the Remove button at the top

Filter by

a. Search: Type in the keyword of the source path or destination URL in the Search field, and the result is populated

b. Modified date: You can filter the redirect rules with their last modified date.

• Choose from any default date ranges such as 1 year, 3 months, 30 days, and 7 days.
• If you want to choose a custom date range, click Select specific dates and select the desired date range
• Click Clear to clear the date range selection and display all the redirect rules

c. Type: You can filter the redirect rules with the redirect type. Click the Type dropdown and choose the desired redirect type

• Ends with: Displays only Ends with redirect type
• Replace with: Displays only Replace with redirect type
• Both: Displays both Ends with and Replace with redirect types

d. Clear filters: Click the Clear filters icon next to the Type dropdown to clear the applied filters and display all the redirect rules

Sorting redirect rules

• Click the column header to sort the columns available on the redirect rule page
• The upward and downward arrows available next to the column header show the sorting type

Importing redirect rules

You can import bulk redirect rules at once by uploading a CSV that matches the following template.

(or)

Import redirect rule file template

You can also download the template here:

import-redirect-rule.csv

Once the redirect rule data has been added to the downloaded template file, save it in your local storage.

1. From the knowledge base portal, go to Settings → Knowledge base site → Article redirect rules
2. Click the Import redirect rule at the top right
3. An Import redirect rules blade appears on the right
4. Either drag and drop the CSV file from the local storage onto the designated drop box
   (or)
   Choose the Click here to choose a file option and select the CSV file using the device's file explorer.

5. The CSV is uploaded, and the data in the file is validated
6. The following pieces of information are displayed before proceeding with the import
   a. Valid rule(s)
   b. Invalid rule(s)
   You can download the list of invalid rule(s) by clicking the Download icon next to the invalid rule(s) count.

7. Click Import to import the valid link(s)
8. Wait for a few seconds, and the number of redirect rules imported appears

Exporting redirect rules

The redirect rule(s) can be exported as a CSV file.

1. From the knowledge base portal, go to Settings → Knowledge base site → Article redirect rules
2. Click the Export CSV at the top right
3. The CSV file is generated and downloaded to your local storage
4. This file can be viewed on any application for spreadsheets like Microsoft Excel and others