Valid for versions 82 through the latest version
Last modified: November 29, 2022
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.
- If you wish to redirect a domain’s visitors from the insecure version of the website to the secure version, use the Force HTTPS Redirect option on cPanel’s Domains interface (cPanel » Home » Domains » Domains).
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.
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
- Click Add.
- 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 a subdomain and redirect it to your chosen domain. You can create a subdomain in cPanel’s Domains interface (cPanel » Home » Domains » 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
The following is a permanent redirect of an entire site from its original location to example.com:
Redirect 301 / http://example.com/
The following is a permanent redirect of a page on example.com to a different page on example.com:
Redirect 301 /original.html http://www.example.com/new.html
The following is a permanent redirect of an entire directory on example.com to a different directory on example.com:
Redirect 301 /old-directory http://www.example.com/new-directory
The following is a temporary redirect of an entire site from its original location to example.com:
Redirect 302 / http://example.com/
The following is a temporary redirect of a page on example.com to a different page on example.com:
Redirect 302 /original.html http://www.example.com/new.html
The following is a temporary redirect of an entire directory on example.com to a different directory on example.com:
Redirect 302 /old-directory http://www.example.com/new-directory