Redirects

Last updated on August 15, 2024.

A Guide to Application Redirects on Insites

Redirects enable visitors to find web pages at their new location if the page's domain location is changed. It causes a user's browser to go from the old location to the new one automatically.

Suppose you have a website with different sections and decide to reorganize one of your pages from 'growthgardens.io/items' to 'growthgardens.io/products'. With a Redirect in place, a visitor using the old URL (growthgardens.io/items) will be automatically directed to the page's new location, 'growthgardens.io/products'.

This article discusses the following topics:

  • 301 vs. 302
  • Viewing Redirects
  • Adding Redirects
  • Importing and Exporting Redirects
  • Editing Redirects
  • Deleting Redirects

301 vs. 302

There are two types of Redirects: 301 and 302. Generally, it is best to use 301 Redirects when permanently relocating a site or page. 302 Redirects are generally used for development and testing. Here are some more examples of when to use 301 or 302 Redirects.

Use 301 Redirects when:

  • Sending links to outdated URLs to your desired page. This action is usually necessary when merging two web pages or changing a domain name.
  • Migrating a web page or site to a new location.

Use 302 Redirects when:

  • Testing and getting user feedback on a new page without impacting site ranking.
  • Updating a web page while providing viewers with a consistent experience.
  • Fixing a broken webpage but maintaining a good user experience.

Viewing Redirects

To view the Redirects in your Instance:

  1. Navigate to Settings from the main menu.
  2. Select Redirects.

The above steps take you to a list of all the Redirects on your Instance.

Adding Redirects

To add Redirects to your Instance:

  1. Navigate to Settings from the main menu.
  2. Select Redirects.
  3. Click on the ADD REDIRECT button and fill out the form. Input requirements and descriptions are displayed in the table after this step-by-step guide.
  4. Select ADD REDIRECT.

These are the input requirements and descriptions for adding a Redirect:

FieldTypeRequiredDescription
Old URL Input FieldYes The URL that you want to apply a redirection to.
New URL Input FieldYes The URL where the old URL will be redirected to.
Redirect Code Radio Button GroupYes

Options:

  • 301 - Moved Permanently
  • 302 - Moved Temporarily

Importing and Exporting Redirects

Insites enables you to import or export Redirects for quick data migrations to and from an Instance. We cover this topic in more detail in the following sections:

  • Importing Redirects
  • Import Template
  • Field Restrictions
  • Error Logs
  • Exporting Redirects

Importing Redirects

To import Redirects:

  1. Navigate to Settings from the main menu.
  2. Select Redirects.
  3. Click ACTIONS then select Import.
  4. Click on the CSV Template link on the 'Import Redirects' drawer to download the CSV Template.
  5. Use the CSV Template as a guide for creating an Import File that matches the input requirements for Redirects in Insites.
  6. When your CSV file is ready, return to the 'Import Redirects' drawer by executing steps #1 - #3.
  7. Use the clickable area on the drawer to upload your CSV file.
  8. Select IMPORT REDIRECTS.

Import Template

The Import Template is a CSV file that you can use to import Redirects into the correct fields within the database. The Redirects Import Template uses CSV headers that match the required headers in the database.

The headers and column orders must remain unchanged from the provided template. This step ensures the data will be mapped to the respective fields and preserve data integrity.

Field Restrictions

The table below lists the field input restrictions when importing Redirects using a CSV file:

FieldTypeRequiredInput Restrictions
UUIDStringYesUnique identifier of the Redirect.
Old URLStringYes Old URL. The value must be unique.
New URLStringYes The new URL where page visitors are directed to.
Redirect CodeStringYes

The redirect code used for the page. Input can only be limited to one of the following values:

  • 301
  • 302
Note

Please take note of the following system behaviors when importing Redirects:


  • If you provide a Redirect with an empty 'UUID', the system creates a new Redirect.
  • If you provide a Redirect with a 'UUID' value that already exists in the database, the system updates the matching Redirect.

Error Logs

The process of importing Redirects to the database fails if the field type rules are not followed. Once the import process is initiated, the logs display all the invalid values in the import CSV file. You can locate the source of the errors via the row and column values displayed in the System Logs.

Exporting Redirects

To export Redirects:

  1. Navigate to Settings from the main menu.
  2. Select Redirects.
  3. Click ACTIONS then select Export.

Editing Redirects

To update a Redirect:

  1. Navigate to Settings from the main menu.
  2. Select Redirects.
  3. Choose the Redirect that you want to update and click on its Edit row action link.
  4. Make your changes and click SAVE.

Deleting Redirects

There are two ways of deleting Redirects: Individual deletion and bulk deletion. We'll discuss how to do both in the following sections.

Individual Deletion

To delete Redirects one by one:

  1. Navigate to Settings from the main menu.
  2. Select Redirects.
  3. Choose a Redirect and click on its Delete row action link.
  4. Select DELETE REDIRECT on the confirmation modal to finalize the deletion.

Bulk Deletion

To delete multiple Redirects at a time:

  1. Navigate to Settings from the main menu.
  2. Select Redirects.
  3. Choose the Redirects you want to delete by ticking their corresponding checkboxes on each row. Ticking the topmost checkbox selects all Redirects.
  4. Click the Bulk Actions button and select Delete.
  5. Select APPLY.
  6. Click DELETE REDIRECTS on the confirmation modal to finalize the deletion.
Have a suggestion for this page?

Didn't quite find what you are looking for or have feedback on how we can make the content better then we would love to hear from you. Please provide us feedback and we will get back to you shortly.