# Manage redirects

The Redirects area lets you manage redirects for your website.

The **Redirects** area helps you create redirects to avoid dead links across your website or to avoid displaying old pages to your customers.

For example, if you created the `/sale-2021` page and now you don't want your customers to find this page, you can create a redirect from the `/sale-2021` page to the `/sales` page.

You can only create redirects from page folders that no longer exist. To create a redirect from an existing page folder, you can use a [client side redirect component](/frontend-development/client-side-redirect-component.md).

## Create a redirect

To create a redirect, follow these steps:

1. From the Studio home page or from the left navigation menu, go to **Redirects**.

2. Click **Add redirect**: the **Create new redirect** dialog opens.

   ![The Create new redirect dialog in the Redirects area](https://docs.commercetools.com/frontend-studio/images/redirect-area-create-new-redirect-dialog.png)

3. In the **Redirect from** field, enter the URL of the page or the path of the page folder to redirect from.

   The path of the page folder must start with `/` (for example, `/sale-2021`). 
   Enter the path of a deleted page folder. Do not use the path of an existing page folder.

4. If necessary, in the **Source query** field, enter query parameters for the source path you entered in the **Redirect from** field. Enter the parameters with the `query=foo&otherQuery=bar` pattern.
   For example, if you enter `category=women&brand=thebrand` as query parameters and the source path is `/sale-2021`, the redirect will be set for `/sale-2021?category=women&brand=thebrand`.

5. From the **Status code** drop-down, select the [HTTP status code](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status#redirection_messages) for the redirect.

6. From the **Type** drop-down, select the type of redirect. Depending on the type of redirect, the next field changes.

7. Do one of the following:

   - In the **Link** field, enter the internal link to the [dynamic page](/frontend-studio/using-dynamic-pages.md) or the URL of the external page to redirect to.

     The internal link must start with `/` (for example, `/sales`). 
     The URL must start with the protocol (for example, `https://example.com/page/to-redirect-to`).

   - From the **Target page folder** drop-down, select the page folder in the [Site builder](/frontend-studio/using-the-site-builder.md) to redirect to.

8. Click **Save**: the redirect is displayed in the redirect list.

## Edit a redirect

To edit the settings of a redirect, follow these steps:

1. In the **Redirects** area, [search for the redirect in the list](/frontend-studio/redirects-in-the-studio.md#search-redirects).

2. Hold the pointer over the redirect and click the **Edit** icon.

   ![The Edit and Delete icons displayed by holding the pointer over the redirect](https://docs.commercetools.com/frontend-studio/images/redirect-area-hover-options.png)

3. Apply the changes, then click **Save**. In the redirect list, the redirect is saved with **Reason** set to **Edited**.

## Delete a redirect

To delete a redirect, follow these steps:

1. In the **Redirects** area, [search for the redirect in the list](/frontend-studio/redirects-in-the-studio.md#search-redirects).

2. Do one of the following:

   - Hold the pointer over the redirect and click the **Delete** icon.
     ![The Edit and Delete icons displayed by holding the pointer over the redirect](https://docs.commercetools.com/frontend-studio/images/redirect-area-hover-options.png)
   - Select the redirect's checkbox, then click **Delete**. To delete more than one redirect, you can select multiple checkboxes at a time.
     ![The Delete button displayed by selecting the redirect's checkbox](https://docs.commercetools.com/frontend-studio/images/redirect-area-select-options.png)

3. In the **Delete redirect?** dialog, click **Delete**.

## Search redirects

To search a redirect, use the search box in the **Redirects** area. In the search box, enter your search text starting with a `/`. For example, `/sale-2021`.

## Add bulk redirects

When moving to commercetools Frontend from other tools, it is possible to add bulk redirects to your project by uploading a CSV file.

To upload the CSV file, follow these steps:

1. From the Studio home page or from the left navigation menu, go to **Redirects**.

2. Click **Bulk upload**: the **Bulk upload redirects** dialog opens.

3. Click **Add .CSV file** and select the file to upload.

4. Click **Validate and upload redirects**. If the file meets the [CSV file requirements](/frontend-studio/redirects-in-the-studio.md#csv-file-requirements), the redirects will be added to your commercetools Frontend project with the type **Migration**. 
   Otherwise, an error message will appear prompting you to fix the problem encountered.

### CSV file requirements

The CSV file must include the source path and the target path in the following format:

`/page/to/redirect-from;https://example.com/page/to/redirect-to`

For example, `/perfume?brand=perfume%20brand;https://yourwebsite.com/perfume/perfume-brand`.

URLs must not contain spaces or special characters.

The CSV file must meet the following requirements:

- The file must contain up to 500 lines.
- The file must contain only redirects. For example, do not include a row header.
- The file must use UTF-8 encoding.
- Paths must start with `/`.
- The delimiter character must be `;`.
- If needed, the enclosure character must be `"` and the escape character must be `\`.

Redirects work on paths, not on the domain. It's possible to have different redirects based on language only if they are on different paths. For example, the source `/socken` redirects to `/de/socken` and `/socks` redirects to `/en/socks`.

## Related pages

- [Area overview page with navigation](/frontend-studio.md)
- [Previous page: Use Components](/frontend-studio/using-components-in-the-studio.md)
- [Next page: Configure Project settings](/frontend-studio/managing-project-settings-in-the-studio.md)