URL Redirects

Adding a URL redirect will ensure that if visitors go to an old link (e.g., a page on an old website that you are rebuilding on the Open Berkeley platform), they will be automatically redirected to the new page. You can add redirects for sub-paths (page paths) from an old website on the URL redirects administration page.

When (and Why) to Add URL Redirects

The following are common use cases for adding URL redirects:

  • You are rebuilding an old site on the Open Berkeley platform
  • You are deleting (removing) a page

Old site URLs, and URLs for deleted pages, may still be findable by your site visitors. For example, either an old site URL (from a site you have rebuilt on Open Berkeley) or a deleted page URL may have been

  • linked on other websites
  • linked in PDFs
  • sent via previous emails
  • bookmarked by site visitors

If URL redirects are not added for the above use cases, and someone selects an old URL, they will be at a broken link ("Page Not Found") on your site. 

Examples

When you are rebuilding an old website on the Open Berkeley platform, your page URL "sub-paths" (page paths) may not match up. For example:

On your old site, you may have a page called "About Us", and the URL may be:

mysite.berkeley.edu/about.html

(In the above example, 'about.html' is the sub-path.)

When you are rebuilding your site, you may still have a page called "About Us", but the sub-path may be different. For example:

my-test-website.pantheon.berkeley.edu/about-us

(In the above example, 'about-us' is the sub-path.)

Notice that the two page paths are different in the two examples. 

When a new site goes live, the Open Berkeley team (web-platform@berkeley.edu(link sends e-mail)) will coordinate everything to redirect the top-level URL (e.g., mysite.berkeley.edu). However, if the individual sub-paths are different (as outlined above), those sub-paths will not automatically redirect. Therefore, it is strongly recommended that Site Builders add their individual URL redirects before their new site goes live. Similarly, Site Builders should add URL redirects if they delete a page on their Open Berkeley site. 

More instructions about how to add URL redirects can be found below. 

Important Notes

  • Do NOT redirect the home page of your website to another page on your site or to an external website (i.e., do not put <front> or "home" in the "from" field when adding a redirect).
    • You and other Builders/Editors/Contributors will not be able to log in to your website (so you won't be able to undo the redirect), and site visitors will not be able to get to your website and/or home page.
  • URLs with spaces (indicated by a "%20", which will automatically be added in the URL address bar to fill the empty space) and other non-alphanumeric characters cannot be redirected. 
  • If you would like to redirect another top-level domain (e.g., new-url.berkeley.edu; a domain that's not your primary URL) to your site, please contact web-platform@berkeley.edu(link sends e-mail), as this process will require additional coordination/configuration.