---
title: "Article redirect rule"
slug: "article-redirect-rules"
description: "Set up article redirect rules to prevent dead links and manage URL changes effectively in your Knowledge base. Learn how to create, edit, and import rules."
updated: 2026-06-01T09:45:36Z
published: 2026-06-01T09:45:36Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.document360.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Article redirect rule

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

Redirect rules prevent users from clicking on **dead** or **broken links**.

---

## Adding an article redirect rule

You can change an article's URL or slug before or after publishing the article or category page. The URL of an index-type category can also be modified. You can make these changes directly in the article editor.

To add the article redirect rule, follow the steps below:

1. Navigate to **Settings** (**) > **Knowledge base site** in the left navigation bar****in the Knowledge base portal.
2. In the left navigation pane, navigate to **Article redirect rules**.

The **Article redirect rules** page will appear with a list of existing rules (if any).
3. Click **New redirect** to create a new redirection rule.

The **New redirect rule** panel will appear.
4. Select the desired **Redirect type**: a. **Ends with**: To set the redirection rule for an article with the unique slug at the end of your URL. b. **Replace with**: To set the redirection rule for the URL text between the domain name and the article slug.

> [!NOTE]
> ** NOTE
> 
> In the **Redirection rule** field, the following special characters are supported: `# % ^ & _ - + = | . ? /`

![Overview of article redirect rules in a knowledge base management system interface.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Article%20redirect%20rules.png)

#### Ends with

1. In the **Source path**field, type the unique slug at the end of your URL for the redirect.

> [!NOTE]
> ** NOTE
> 
> The URL slug in the source path must start with a **forward slash**(`/`).

1. In the **Destination URL**field, type the full destination URL or type the new slug for redirection. Adding a forward slash (**/**) at the beginning of the destination URL is optional.

> **Example**: To redirect the article URL from `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 URL as mentioned below: **Source path**: `/getting-started-with-document360` **Destination URL:** `getting-started-video-library`

1. Click **Create**.

![](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/image-1768739804745.png)

#### Replace with

1. In the **Source path** field, type the text between the domain and the article slug that you want to redirect.

> **Example**: The source path in the URL `https://project.technicaldocumentation.com/v1/docs/fr/getting-started` is `/v1/docs/fr/`.

> [!NOTE]
> ** NOTE
> 
> The source path must start and end with a **forward slash**(`/`).

1. In the **Replace text** field, type the new URL text you want to use for redirection.

> **Example:** Replace `/v1/docs/fr/` with `/v2/docs/en/` in the URL `https://project.technicaldocumentation.com/v1/docs/fr/getting-started`.

> [!NOTE]
> ** NOTE
> 
> The replace text must start and end with a **forward slash**(`/`).

1. Click **Create**.

![](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/image-1768739839069.png)

---

### Best practices

If you manage a multilingual Knowledge base with multiple project workspaces, set redirect rules based on language or workspace. For instance, if you set a rule with the source path `/customer-support` and the destination `/sales-and-support`, this applies only to the default language of the main workspace.

- To apply this rule to another language (e.g., German: `/de/`), create a new rule with the source path `/de/customer-support` and the destination `/de/sales-and-support`.
- To apply the rule in another workspace (e.g., version 1: `/v1/`), set the source path `/v1/docs/customer-support` and the destination `/v1/docs/sales-and-support`.

---

### Site-level redirect rule

In the **Article redirect rules** page, you can set a subfolder redirect rule at the site level using the **Replace with** option. This is useful for migrating from another platform or redirecting removed or hidden workspaces/languages.

> Example: Set a redirect rule for the subfolder `/azure/serverless` to `/data/cloud360` in the URLs like `https://apidocs.serverless360.com/azure/serverless/article_slug`.

---

## Editing a redirect rule

To edit the article redirect rule, follow the below steps:

1. Navigate to **Settings** (**) > **Knowledge base site** in the left navigation bar****in the Knowledge base portal.
2. In the left navigation pane, navigate to **Article redirect rules**.

The **Article redirect rules** page will appear with a list of existing rules (if any).
3. Use the **Filter**to find the desired redirection rule.
4. Hover over the desired rule and click the **Edit** (**) icon.

The **Edit redirect rule** panel will appear.
5. Update the necessary field(s).
6. Click **Update**.

![](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/image-1768739873123.png)

---

## Deleting a redirect rule

To delete an article redirect rule, follow the below steps:

1. Navigate to **Settings** (**) > **Knowledge base site** in the left navigation bar****in the Knowledge base portal.
2. In the left navigation pane, navigate to **Article redirect rules**.

The **Article redirect rules** page will appear with a list of existing rules (if any).
3. Use **Filter**to find the desired redirection rule.
4. Hover over the desired rule and click the **Delete**(**) icon.
5. To delete multiple rules, select the checkboxes next to the rules and click **Delete**.
6. Click **Yes** in the **Delete**confirmation panel.

> [!NOTE]
> ** NOTE
> 
> Deleted redirection rules cannot be retrieved.

![](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/image-1768739900762.png)

---

## Filter a redirect rule

To filter the desired redirect rule, follow the steps below:

1. **Search**: Enter a keyword from the source path or destination URL in the search bar, and the result is populated.
2. **Type**: Filter by the type of redirect: **Ends with**, **Replace with**, or **Both**.
3. **Modified date**: Filter rules by the last modified date, with options such as 1 year, 3 months, 30 days, or 7 days. Click **Custom date** to choose any custom date range and select the desired date range.

![](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/image-1768740465900.png)

---

## Importing redirect rules

To import bulk redirect rules at once, upload a CSV that matches the following template:

| **Source** | **Destination** | **RedirectionType** |
| --- | --- | --- |
| `/myoldarticle` | `newarticle` | endswith |
| `/en/customers/` | `/v1/docs/` | replacewith |

> [!NOTE]
> ** NOTE
> 
> The file size should be less than or equal to 1MB.

#### Import redirect rule file template

You can also download the template here:

[import-redirect-rule.csv](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/import-redirect-rule.csv)

To import redirect rules in bulk:

1. Prepare a CSV file that matches the provided template (file size ≤ 1MB).
2. Navigate to **Settings** (**) > **Knowledge base site** in the left navigation bar****in the Knowledge base portal.
3. In the left navigation pane, navigate to **Article redirect rules**.
4. Click **Import redirect rule**.

The **Import redirect rules** panel will appear.

![Instructions for importing redirect rules from a CSV file with upload options.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Import%20redirect%20rules.png)
5. Drag and drop the CSV file or select **Click to Upload**.
6. Review the list of valid and invalid rules.

> [!NOTE]
> ** NOTE
> 
> Click the **Download**(**) icon near to the invalid rules count to download the list of invalid rules.
7. Click **Import** to apply the valid rules.

![Importing redirect rules from a CSV file with validation summary details displayed.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Importing%20rules.png)

---

## Exporting redirect rules

To export redirect rules as a CSV file, follow the steps below:

1. Navigate to **Settings** (**) > **Knowledge base site** in the left navigation bar****in the Knowledge base portal.
2. In the left navigation pane, navigate to **Article redirect rules**.
3. Click **Export** to download the rules as a CSV file.

![](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/image-1768740494127.png)

---

### FAQ

#### What are Dead links?

Dead links, or broken links, are hyperlinks that no longer work due to issues like URL changes, incorrect URLs, or restricted/private articles. They typically result in a 404 error page.

#### What is an article slug?

A slug is the part of a URL that uniquely identifies a specific article/page. It comes after the `/` in your project's root URL.

> **Example**: **Article URL**: `https://docs.document360.com/docs/why-did-we-build-document360`
> 
> **Slug**: `/why-did-we-build-document360`

#### How many redirect rules can I set up in a project?

You can set up a maximum of 10,000 redirect rules per project. If you exceed the limit, please contact our [support team](mailto:support@document360.com).

#### Are there limits for the import redirect rules feature?

You can import up to 1,000 redirect rules per day and use the import feature up to five times per day. If you exceed the limit, please contact our [support team](mailto:support@document360.com).

#### Why do I see the error "The KB site is redirected too many times when accessed?"

This error occurs due to a redirect loop, often caused by setting the Document360 Knowledge base site URL as the Sign-in URL for JWT authentication. Ensure the Sign-in URL for JWT authentication is not the same as the Document360 KB site URL. Use a dedicated authentication page as the Sign-in URL to avoid redirect loops and resolve the error.

#### How can we address the issue of 404 errors when we discontinue functionalities that lead to incoming links from sources we cannot control?

For discontinued features, to manage 404 errors effectively, create a standard article informing users about the discontinuation of a functionality, which can be used to redirect relevant articles.

For multiple discontinued functionalities, consider establishing a centralized page that consolidates all related information, ensuring users can easily access updates and reducing the occurrence of dead links.

#### How do I redirect an article from one page to another using Custom JavaScript?

To redirect an article from one page to another using Custom JavaScript, follow the steps below:

1. Navigate to **Settings** (**) > **Knowledge base site** in the left navigation bar****in the Knowledge base portal.
2. In the left navigation pane, navigate to **Customize site**.
3. Click **Custom CSS & JavaScript**.
4. Paste the following code in the **JavaScript** tab:

```javascript
$(document).ready(function() {
  if(panel.location.href=="source URL") {
    panel.location.replace("destination URL");
  }
});
```
5. Replace the **source URL** and **destination URL** in the code.
6. Click **Save**.

#### How do I write a redirection rule to replace the workspace name in the URL?

You can use redirection rules when migrating from a different platform to Document360.

- Old URL structure: `https://docs.document360.com/{oldworkspace}/section/page`
- New URL structure: `https://docs.document360.com/{newworkspace}/section/page`

The same domain must be mapped to both platforms for the redirection to work. For example, If the old workspace is v1 and the new workspace is v2:

| Source | Destination | Rule |
| --- | --- | --- |
| `/v1` | `/` | endswith |
| `/v1/` | `/v2` | replacewith |

This rule ensures that all requests pointing to the old workspace v1 are redirected to the new workspace v2.

#### How can I redirect a specific article/category URL to the homepage of my documentation?

To redirect a specific URL to the homepage of my documentation, change the destination URL as ‘**/**’. For example, if you wish to redirect the URL `https://docs.radixdlt.com/docs/welcome` to `https://docs.radixdlt.com` , set the source URL as /docs/welcome and destination URL as ‘**/**’ in the replace with redirection rule.

#### How can I redirect to the Documentation’s home page from API reference page when user clicks on ‘Home’ icon?

To redirect the users to the Documentation’s home page from the API reference page when they click on the home icon, create a new redirect rule with the ‘Replace with’ option. Set the source path as ‘/apidocs’ and the destination path as ‘/’, then update the rule.