Valid for versions 82 through the latest version
Last modified: November 18, 2020
The Redirects interface allows you to send all of the visitors of a domain or particular page to a different URL. For example, if you create a page with a long URL, use the Redirects interface to add a redirect from a short URL to the long URL. Visitors can enter the short URL to access the content of the long URL.
You cannot edit a redirect. To modify a redirect, you must delete it, and then recreate it.
Add a redirect
To add a redirect, perform the following actions:
Select a redirect type from the Type menu.
- Permanent (301) — This setting notifies the visitor’s browser to update its records.
- Temporary (302) — This setting does not update the visitor’s bookmarks.
Select a domain name from the menu, or select **All Public Domains** to redirect all of the domains that your cPanel account controls.
In the next text box, enter the rest of the URL from which you wish for the server to redirect visitors. For example, if you wish to redirect
http://example.com/directory.file.htmlto another URL, enter
directory/file.htmlin this text box.
In the Redirects to text box, enter the URL to which you wish to redirect users.Important:
You must specify a protocol in this text box. For example,
Select one of the following settings:
- Only redirect with www. — This setting only redirects visitors who enter the www. prefix before the domain name part of the URL.
- Redirect with or without www. — This setting redirects all users, regardless of whether the visitor enters the www. prefix before the domain name part of the URL.
- Do Not Redirect www. — This setting does not redirect users who enter the www. prefix before the the domain name part of the URL.
The interface disables the www. redirection setting if you select **All Public Domains.**.
Select the Wild Card Redirect setting if you wish to redirect all files within a directory to the same filename in the new directory. For example, if you enable the Wild Card Redirect setting and
example.com, then a visitor who tries to access the
http://example1.com/pic.jpgURL redirects to the
To test the redirect, click the link under Directory in the Current Redirects table. If you properly configured the redirect, the system directs you to the original domain.
To add a redirect where the original domain appears in the browser’s address bar, create an addon domain and redirect it to your chosen domain. You can do this in cPanel’s Addon Domains interface (cPanel >> Home >> Domains >> Addon Domains).
Redirects via third-party applications
When you add a redirect with cPanel interface, the system places redirect rules at the bottom of the
.htaccess file. Some third-party applications will ignore your rule because those applications only read rules and configurations that their section of the
.htaccess file contains.
If you use a third-party application or content management system to add a redirect, such as WordPress®, the redirect may not function properly.
The following example displays the configuration that you must add to the top of the
.htaccess file to add a redirect for the Drupal content management system. In this example:
drupal.user.example.comrepresents the URL to redirect.
http://cpanel.net/represents the URL to which to redirect.
The Current Redirects table
The Current Redirects table lists the redirections that currently exist on your account. To search for a redirection, enter the search criteria in the Search text box and click Go.
The table lists the following information about redirects:
|Domain||The domain to redirect. ALL represents all of the account’s publicly-available domains.|
|Directory||The directory to redirect. Click the link to test the redirection.|
|Regular Expression||The system will redirect any URL that matches the regular expression in this column.|
|Redirect URL||The URL to which you wish to redirect users.|
|HTTP Status Code||The numerical HTTP Status Code of the redirect.|
|Match www.||Only redirect visitors who enter the
|Wildcard||Redirect all files within a directory to the same filename in the new directory. For example, if you enable the Wild Card Redirect setting and
|Actions||Available actions for the redirection:
Most web browsers add redirections to a cache. Visitors may need to clear their web browser cache to remove the redirection from their web browsers