Modify workflow notification pages

You can customize the IBM® Verify workflow notification pages for your business. Workflow notification pages can be used to send users email, SMS, voice, or push notifications.

To update the workflow notification pages, download the compressed theme file. Edit the pages as needed and then upload the updated theme files back to your Verify tenant. For more information, see Updating a theme.

Text changes can be made to the pages by using XML markup. The XML files also contain macros. Macros are characters between the @ symbol where the data is rendered at run time. Do not change the macro names in the files.

The IBM Verify workflow notification pages are in the templates/workflow/notifications directory within the themes compressed file.

Email template

Workflow email notifications are available to send messages via email. The pages are in the templates/workflow/notifications/email directory.

The following label is available on the email notification page. To update the text on these labels, see Managing themes

$NOTIF_EMAIL_CONTENTS$- The text for this macro has the entire body of the email.

The macros for this page are shown in the following table. You can use them in the email body.

Table 1. Macro definitions
Macro Value that replaces the macro
@NAME@ The user's full name.
@FAMILY_NAME@ The user’s surname.
@GIVEN_NAME@ The user's given name.
@PREFERRED_USERNAME@ The user's preferred name.
SMS template

Workflow SMS notifications are available to send messages through SMS. The pages are in the templates/workflow/notifications/sms directory.

The following label is available on the SMS notification page. To update the text on these labels, see Managing themes

$NOTIF_SMS_CONTENTS$- The text for this macro has the entire body of the SMS notification.

The macros for this page are shown in the following table. You can use them in the SMS notification body.

Table 2. Macro definitions
Macro Value that replaces the macro
@NAME@ The user's full name.
@FAMILY_NAME@ The user’s surname.
@GIVEN_NAME@ The user's given name.
@PREFERRED_USERNAME@ The user's preferred name.
Push template

Workflow push notifications are available to send messages to user devices. The pages are in the templates/workflow/notifications/push directory.

The following label is available on the push notification page. To update the text on these labels, see Managing themes

$NOTIF_PUSH_CONTENTS$- The text for this macro has the entire body of the push notification.

The macros for this page are shown in the following table. You can use them in the push notification body.

Table 3. Macro definitions
Macro Value that replaces the macro
@NAME@ The user's full name.
@FAMILY_NAME@ The user’s surname.
@GIVEN_NAME@ The user's given name.
@PREFERRED_USERNAME@ The user's preferred name.
Voice template

Workflow voice notifications are available to send messages to user devices. The pages are in the templates/workflow/notifications/voice directory.

The following label is available on the voice notification page. To update the text on these labels, see Managing themes

$NOTIF_VOICE_CONTENTS$- The text for this macro has the entire body of the voice notification.

The macros for this page are shown in the following table. You can use them in the voice notification body.

Table 4. Common macro definitions
Macro Value that replaces the macro
@NAME@ The user's full name.
@FAMILY_NAME@ The user’s surname.
@GIVEN_NAME@ The user's given name.
@PREFERRED_USERNAME@ The user's preferred name.

See Personalize themes with user attributes to add more customizations to your workflow notification pages.