<html><head><link rel="canonical" href="https://www.jetbrains.com/help/writerside/redirects.html.md/" data-react-helmet="true"/></head><body># Redirect to other content

When you [remove](delete-a-topic.html) or [rename](topics.html#change-file-name) a topic, your readers might encounter the 404 error page when opening a previously published URL. To avoid this, Writerside suggests adding redirects from the previous [web file name](topics.html#web_file_name) to another topic.

Redirection rules are stored in the `redirection-rules.xml` file and have the following syntax:

```XML
<rule id="36921bf6">
    <description>Created after removal of "Introduction" from Writerside</description>
    <accepts>introduction.html</accepts>
</rule>
```

The `accepts-web-file-names-ref` attribute on a  `[<toc-element>](instances.html#toc-element)`  ensures that all applicable web file names from the corresponding redirection rule will be redirected to this entry in the [table of contents](table-of-contents.html):

```XML
<toc-element topic="getting-started.topic" accepts-web-file-names-ref="36921bf6">
```

In the previous example, all links to `introduction.html` will redirect to the web file generated from `getting-started.topic`.

Procedure: Add redirect manually

1. Open the  [tree file](help-modules.html#tree-file)  and locate the  `[<toc-element>](instances.html#toc-element)`  that should serve as the new target.

2. Add the `accepts-web-file-names` attribute to this  `[<toc-element>](instances.html#toc-element)`  and specify the HTML file name from which to redirect.

```XML
<toc-element topic="new-topic.topic" accepts-web-file-names="old-topic.html">
```

If you want to redirect multiple web file names to this  `[<toc-element>](instances.html#toc-element)` , separate them with commas, or manually create a redirection rule and reference it from the  [tree file](help-modules.html#tree-file)  to avoid cluttering it with a long list of web filenames.

Procedure: Redirect to an external URL

If the relevant content is available outside of your documentation, you can add a redirect to an external URL. For example, if you removed a topic and moved the content to a blog post, a knowledge base article, or a page in your learning center. Or maybe some feature was removed, and it is available in another product, then you can redirect to the relevant documentation page of that product.

* Add the `target-for-accepts-web-file-names` attribute to a  `[<toc-element>](instances.html#toc-element)`  without an associated topic and make it [hidden](table-of-contents.html#hide-topic-in-toc) so that your readers do not see in the [TOC](table-of-contents.html).

```XML
<toc-element toc-title="Redirect to blog post" hidden="true" accepts-web-file-names="cool-feature.html" target-for-accept-web-file-names="https://my.company.com/blog/about-cool-feature">
```

In the previous example, readers with a link to `cool-feature.html` in your documentation will be redirected to the relevant post in your company's blog.

</toc-element></toc-element></toc-element></toc-element></toc-element></toc-element></toc-element></toc-element></body></html>