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 http://brightspot.com/case-studies, 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.

The following illustration is an example of a 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:

• Adding redirect vanity URLs