Modify email notifications to use notification redirection

  • Release version: Australia
  • Updated March 12, 2026
  • 1 minute to read

    • Update email notifications to use the notification redirection framework so users are automatically directed to the appropriate view based on their workspace access.

    Before you begin

    You must have notification routing rules configured before modifying notifications. For more information, see Configure GRC notification redirection.

    Role required: admin

    About this task

    To enable redirection for a notification, replace the standard URL variables with mail script references that call the redirection framework. The system uses these mail scripts to generate URLs that route users to the appropriate view based on their workspace access.

    Procedure

    1. Navigate to All > System Notification > Email > Notifications.
    2. Open the notification that you want to modify.
    3. Select the What it will contain tab.
    4. In the Message HTML field, replace the URL variable values.
      • To display a link as the link text, replace ${URI}, with ${mail_script:RecordNotificationRedirectionScript}.
      • To display the record name as the link text, replace ${URI_REF} with ${mail_script:RecordREFNotificationRedirectionScript}.
      • For list view links, create a custom mail script that uses the GRCNotificationRedirectionUtils script include to generate the redirection URL.
    5. Select Update.

    Result

    When users select links in the modified notification, the system automatically directs them based on their workspace access. If they have workspace access, they're directed to workspace view. If they don't have workspace access, they're directed to classic view.