Using redirects

You can use Redirects to create redirects to avoid any dead links across your website or if you want to make sure that your customers don't see old pages.

Click Redirects on the dashboard to open the redirects area.

cdf2277 Redirects on the studio dashboard

Once open, you'll see a list of all the manually created redirects, as well as any automatically created redirects from when you move page folders within your page folder tree.

You can create a new redirect or delete an existing redirect.

For example, if you had a page with the URL ending .../Sale2017 you don't want customers to find this old page through an old bookmark or search, you can create a redirect from .../Sale2017 to go to a new page with the URL .../Sales.

Creating a new redirect

Once you've opened the Redirects area, follow the steps below:

  1. Click the Add redirect button

d57d294 Click the add redirect button

  1. Input where you want to Redirect from

You can't use the source path of an existing node. The source path can only be from a deleted path that no longer exists. Don't remove the / as a source path must start with it, for example, /Sale2017. The redirect from URL mustn't contain any spaces.

8d6733e Input the page folder where you want to redirect from

  1. Use the dropdown to select either a permanent redirect (301) or a temporary one (302)

38661c2 Select temporary or permanent redirect

  1. Use the dropdown to select either Link (and then input the URL) or Page folder (and then select the page folder) for where you want to Redirect to

8231a1b Select where you want to redirect to

If you select the page folder type, you can search your page folders in the dropdown for easy selection.

  1. Click Save

d75fd62 Click save to save your redirect

Editing a redirect

You can edit an existing redirect if you need to make any changes to the settings.

  1. Find your redirect, hover on it, and click the edit icon

6e84575 Click the edit icon to edit a redirect

  1. Make any changes you need to in the panel on the right then click Save

775879b Make the edits and click save

Your redirect will now have the Creation reason status of Edited.

Deleting a redirect

There are 2 ways to delete a redirect.

You can hover on a redirect and click the trash can icon:

cbd19a5 Hover on a redirect and select the trash can icon

Or you can click the tick box next to the name of the redirect(s) you want to delete and click the Delete button:

5c87ff0 Tick the tick box and then click delete

In both cases, you'll need to confirm your deletion.

Searching for a redirect

You can search all your redirects by their Redirect from name using the search bar.

c56bb6a Searching for redirects

You'll need to start your search with a forward slash (/) as it would appear in your URL after the main site. For example, /sale2017.

Adding bulk redirects

If you're moving to commercetools Frontend, you might have a lot of redirects you want to add to your new project. You can provide our Support team with a CSV file that includes the request path and the target path in the below format:

And the below configuration:

  • delimiter: ;
  • enclosure: "
  • escape: \

For example: perfume?brand=Hugo%20Boss;<>

The redirects will be added with the type of "Link".

Redirects work on paths, not the domain. So you'll only be able to have different redirects per language if they're on different URLs. For example, source socken redirects to /de/socken in DE, and socks redirects to /en/socks for EN.