Issue
In a Pega Platform™ Constellation application, when a user opens a case from a link in an email notification, the default theme is displayed instead of the channel-specific theme configured for the portal. When the same case is opened directly through the portal, the correct theme is displayed.
Symptoms and Impact
This behavior affects the channel theme, custom branding, navigation panel, and portal header.
Steps to Reproduce
- In App Studio, configure a channel-specific theme for a Constellation portal.
- Trigger an email notification that includes a case link generated by a WorkLink Email Correspondence Fragment.
- Open the case link from the email.
- Result: the default theme is displayed instead of the configured channel theme.
- Expected: the configured channel theme is displayed.
Root Cause
Constellation correspondence templates that use a WorkLink Email Correspondence Fragment generate a URL that opens the case in isolation, without loading the full portal context. As a result, portal-level elements — the configured channel theme, custom branding, navigation panel, and portal header — are not rendered.
This is a known behavioral difference between WorkLink and semantic URLs in Constellation applications. WorkLink was designed for traditional UI applications; it does not support full portal context rendering in Constellation.
Solution
Replace the WorkLink Email Correspondence Fragment in the correspondence rule with a semantic URL.
Semantic URLs are the native URL mechanism for Constellation. They open cases within the full portal context, ensuring that the configured channel theme and all portal-level elements are rendered correctly.
To update the correspondence rule
-
Open the case in a Constellation portal and copy the URL from the browser address bar.
-
Open the correspondence rule in Dev Studio.
-
Switch to Source mode.
-
Replace the WorkLink fragment with a hyperlink that uses the semantic URL pattern:
https://<host>/prweb/app/<app-name>/<case-type-url>/<case-id>
-
Save and test the rule by sending a test email and opening the link.
-
Verify that the case opens with the correct channel theme, branding, navigation panel, and portal header.
References
Configuring a Constellation Portal
Branding and themes in Constellation
Images sourced from binary files are not displayed in Correspondence templates