Brightspot CMS User Guide

Adding wildcard redirects


Wildcard redirects are useful when paths within your site change. Because Brightspot constructs paths from sections, paths change most often when a section name or a section hierarchy changes. In such cases, the redirect replaces an old path with a new one. For example, visitors who bookmarked the asset at http://brightspot.com/athletics/latest-scores are redirected to http://brightspot.com/sports/latest-scores.

To add wildcard redirects:

  1. Click menu > Redirects > Wildcard Redirects.
  2. Click New Wildcard Redirect on the bottom left.
    Creating a new wildcard redirect Creating a new wildcard redirect
    Creating a new wildcard redirect
  3. In the Name field, enter a description of this redirect. If no name is entered, this field defaults to the local URL and the destination URL, separated by a ->.
  4. In the Local Urls field, enter the path after the domain name in the URL from which you are redirecting. Add /* wildcards to represent an arbitrary path match. For example, if the source URL is http://brightspot.com/solutions/*, enter /solutions/*. Click add to add multiple paths.
  5. In the Destination field, enter the redirect's target URL.
  6. Toggle on Temporary if you want the browser or search engine to treat the redirect as temporary. If set, the server returns an HTTP 302 temporary redirect; otherwise, it sends a 301 permanent redirect. (For an explanation of the difference between permanent and temporary redirects, see Asset URLs.)
  7. In the Query String field, select one of the following:
    • preserve—When redirecting, append an incoming query string to the URL in the Destination field.
    • ignore—When redirecting, do not append an incoming query string to the URL in the Destination field.
    • modify—Modify the incoming query string.
  8. Toggle on Transfer Matched Segments to have any path and query string after the incoming URL to appear after the destination URL.
  9. In the Sites widget, from the Owner list, select the site to which this wildcard redirect applies.
  10. Complete your site's workflow and publish the asset.

Example

A publisher decided to remove the path /solutions from all its URLs, and all assets under /solutions are now available directly under the domain name itself. Visitors may have bookmarked assets at the old path, and search engines may continue to return results from the old path as well. When clicking those bookmarks or search results, visitors receive Error 404. As a result, the publisher introduces a wildcard redirect from the old path to the new one. The following examples illustrate this wildcard redirect.

Creating a wildcard redirect Creating a wildcard redirect
Creating a wildcard redirect
Modifying query strings in a redirect Modifying query strings in a redirect
Modifying query strings in a redirect

Referring to the previous images—

  • The owner of this wildcard redirect is the Brightspot site (associated with domain name brightspot.com).
  • Visitors attempting to view an asset matching the pattern http://brightspot.com/solutions/* (any asset under the path /solutions) are redirected to https://brightspot.com.
  • Because the toggle Transfer Matched Segments is on, the slug after /solutions in the local URL is appended to http://brightspot.com. For example, visitors attempting to view http://brightspot.com/solutions/media-desk are redirected to http://brightspot.com/media-desk.
  • Visitors attempting to view the asset at http://brightspot.com/solutions/media-pricing?product-id=25 are sending a query string with the request. Because this wildcard redirect modifies query strings, those visitors are redirected to https://brightspot.com/media-pricing?new-product-id=125.
Previous Topic
Adding a site redirect
Next Topic
URLs and trailing slashes
Tags
Was this topic helpful?
Thanks for your feedback.
Our robust, flexible Design System provides hundreds of pre-built components you can use to build the presentation layer of your dreams.

Asset types
Module types
Page types
Brightspot is packaged with content types that get you up and running in a matter of days, including assets, modules and landing pages.

Content types
Modules
Landing pages
Everything you need to know when creating, managing, and administering content within Brightspot CMS.

Dashboards
Publishing
Workflows
Admin configurations
A guide for installing, supporting, extending, modifying and administering code on the Brightspot platform.

Field types
Content modeling
Rich-text elements
Images
A guide to configuring Brightspot's library of integrations, including pre-built options and developer-configured extensions.

Google Analytics
Shopify
Apple News