Using the redirect importer

This topic explains the steps for importing redirects into Brightspot.

Step 1: Create the import file

  1. In Google Sheets, create a new worksheet.
  2. In the first row, enter column headings Local Path, New URL, Status, and Query String.
  3. Add redirects by doing the following:
    1. In the Local Path column, enter the path after the domain name in the URL from which you are redirecting. For example, if the source URL is, enter /case-studies.
    2. In the New URL column, enter the URL to which you are redirecting. Include a domain name and path.
    3. In the Status column, enter either 301 (permanent redirect) or 302 (temporary redirect). A blank in this column defaults to a permanent redirect.
    4. In the Query String column, enter one of the following:
      • preserve—Append the incoming query string to the URL in the New URL column.
      • ignore—Do not append the incoming query string to the URL in the New URL column. (A blank in this column defaults to ignore.)
      • modify—Prepare the vanity redirect for further modification.
A redirect file can be imported only once. If you need to make corrections to imported redirects, submit them in a new Google Sheets file.

The following illustration is an example of a redirect import file.

Sample redirect import file Sample redirect import file
Sample redirect import file

Step 2: Import the redirects into Brightspot

  1. In the search panel, filter for the content type Google Drive File.
  2. Click the Sheets file containing the redirects.
  3. In the Google Drive File widget, from the Converter list, select Vanity Redirect Google Drive File Converter.
  4. If you want to override existing redirects, toggle on Overwrite Existing Redirects. For example, if there is an existing redirect from A to B, and your import file specifies A to C, this toggle ensures there is one redirect from A to C.
  5. Click Import.
  6. In the Dashboard, review the import results in the Recent Activity widget.
  7. For any imports with query string set to modified, open the vanity redirect and configure the key-value pairs. For details, see Adding redirect vanity URLs.

See also:

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
Landing pages
Everything you need to know when creating, managing, and administering content within Brightspot CMS.

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

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

Google Analytics
Apple News