URLs and Redirects

Basic URLs

If you only need to add a URL to a page, you can add as many URLs (both permalinks and redirects) in the URLs section in Brightspot. For example, you might want to have a page at test.byu.edu/conference-registration also be available at a shorter URL like test.byu.edu/conf-reg. You may also be moving your content from one system to another and want to make sure your old URLs still work.

Brightspot Documentation: URL Management
Brightspot Article: How to create permalinks and manage redirects

Site Redirects

If you want to redirect a whole domain or subdomain to a particular address, use a site redirect (example: redirect career.byuh.edu to acs.byuh.edu/career).

1. Find Site Redirects in the hamburger menu > Redirects > Site Redirects. If you don’t see this, ask your admin to access to this area.
2. Make sure that you are on the Brightspot site you’d like to redirect to. For example, if you want to set up a domain to redirect to acs.byuh.edu, make sure that you see “BYUH Alumni & Career Services” in the top bar of the CMS. If you're in the correct site, this site should be the default filter on the left side of the Site Redirect search menu.
3. Click New Site Redirect
4. Choose the site domain(s) that should be redirected to the Brightspot site. If you want to redirect the legacy URL to a specific section page, you can add the Destination in the format of subdomain.byuh/section. If you want to redirect to the homepage, add the homepage url to the destination. (ex. acs.byuh.edu)
5. Turn the toggle for Transfer Matched Segments to the right to allow pages off of this domain to redirect also (if you want career.byuh.edu/node1 to redirect to acs.byuh.edu/node1)
6. Hit Publish when complete

7. Before this redirect is live, the following need to happen:

   1. Inform Perfect Sense so we can add the legacy domain to cloudfront
   2. Once a is complete, your network team should point the legacy domain to Brightspot

Site Redirect Tips & Tricks

When setting up Site Redirects, it’s important to do the following:

1. Set up 4 site redirects, as shown below. Make sure to include the http and https versions of both the www and non-www versions
2. Don’t include a trailing / after each URL
3. Make sure that the destination is a real URL on the destination site. You’ll need to add this URL path to the page to which want the domain to redirect. If this is not done, the redirect will 404.
4. When this is set up, your network team will need to point the domain to Brightspot. Before this can happen, please confirm that Perfect Sense has added the domain to Cloudfront.

Vanity URL Redirects

If you want to redirect a page to a different website or subdomain, use a vanity URL redirect (example: direct biology.byu.edu/cats to cats.byu.edu).

To access Vanity URL redirects, the CMS user should have access to Redirects → Vanity URL Redirects. You can add this by going to the Role > Areas. The user should also have access to the Vanity URL content type.

1. From the hamburger menu, go to Redirects > Vanity URL Redirects. Make sure that you’re on the site for which you wish to create a vanity redirect.
2. Click New Vanity URL Redirect
3. The local URL should be the permalink on a Brightspot page (in the example above, /cats)
4. The destination should be an external domain (in the example above,  cats.byu,edu)
5. If you wish to make this temporary, turn the toggle on

6. Options are provided to Ignore, Preserve, or Modify the query string. Developer notes:

   1. If the Modify option is selected, additional options allow specification of which parameters to keep based on key names.
   2. The options for keeping query parameters by key name allow keeping All, None, All Except, or Only certain key names.
   3. New query parameter key value pairs can also be added in the Add field of the Modify option.