Skip to content

Update the notifications config article #7557 #2026

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
alhambrav wants to merge 8 commits into
base: master
Choose a base branch
from
Draft

Update the notifications config article #7557 #2026

Changes from 1 commit
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
f683bed
Update the notifications config article #7557
alhambrav Jun 2, 2025
6f24f11
Update updated version
alhambrav Jun 9, 2025
e49fbfd
Add new property for workflow notifications #7557
alhambrav Jun 10, 2025
930f2a9
Merge with master
Sep 25, 2025
28ffe79
Fix path of notification-config.xml file
Oct 24, 2025
c9bb0d3
Update example email template for notification config
Oct 24, 2025
3f51c12
Merge with master
alhambrav Apr 29, 2026
3d3cb74
Update based on coderabbit review
alhambrav Apr 29, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
168 changes: 109 additions & 59 deletions source/reference/modules/studio.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2874,7 +2874,7 @@ All configuration for the notification system is done by a site admin (on a per
Where
'''''
.. code-block:: xml
:caption: *CRAFTER_HOME/data/repos/sites/SITENAME/sandbox/config/studio/notifications.xml*
:caption: *CRAFTER_HOME/data/repos/sites/SITENAME/sandbox/config/studio/notification-config.xml*

Comment thread
alhambrav marked this conversation as resolved.
Outdated
<notificationConfig>
...
Expand Down Expand Up @@ -2952,7 +2952,7 @@ Configure Who Gets Notifications
Configure who gets notifications by entering the email addresses of the people you want to send notifications to, in between the tags ``<deploymentFailureNotification>`` and/or ``<approverEmails>``

.. code-block:: xml
:caption: *CRAFTER_HOME/data/repos/sites/SITENAME/sandbox/config/studio/notifications.xml*
:caption: *CRAFTER_HOME/data/repos/sites/SITENAME/sandbox/config/studio/notification-config.xml*
:linenos:

<notificationConfig>
Expand All @@ -2975,7 +2975,7 @@ Configure Studio Workflow Dialog Messages
Below is a sample of Studio workflow dialog messages defined in our notifications configuration file.

.. code-block:: xml
:caption: *CRAFTER_HOME/data/repos/sites/SITENAME/sandbox/config/studio/notifications.xml*
:caption: *CRAFTER_HOME/data/repos/sites/SITENAME/sandbox/config/studio/notification-config.xml*
:linenos:

<notificationConfig>
Expand Down Expand Up @@ -3014,10 +3014,16 @@ Below is a sample of Studio workflow dialog messages defined in our notification
~~~~~~~~~~~~~~~~~~~
Configure Templates
~~~~~~~~~~~~~~~~~~~
Below is an example of a configured email messages for each point in the workflow, found in between the tag <emailTemplates> in the notifications configuration file.
Below is an example of a configured email messages for each point in the workflow, found in between the tag
``<emailTemplates>`` in the notifications configuration file.
Comment thread
alhambrav marked this conversation as resolved.
Outdated

.. raw:: html

<details>
<summary><a>Configured email messages in the notifications configuration file</a></summary>

.. code-block:: xml
:caption: *CRAFTER_HOME/data/repos/sites/SITENAME/sandbox/config/studio/notifications.xml*
:caption: *CRAFTER_HOME/data/repos/sites/SITENAME/sandbox/config/studio/notification-config.xml*
:linenos:

Comment thread
coderabbitai[bot] marked this conversation as resolved.
Outdated
<notificationConfig>
Expand All @@ -3036,23 +3042,23 @@ Below is an example of a configured email messages for each point in the workflo
The following content was unable to deploy:
<ul>
<#list files as file>
<li>${file.internalName!file.name}</li>
<li>${file.action}: ${file.path} from package ${file.packageId}.
<#if file.liveError != 0>Live error: ${file.liveError?c}</#if><#if file.stagingError != 0>Stage error: ${file.stagingError?c}</#if></li>
</#list>
</ul>
Error:<br/>
${deploymentError.toString()}
<#if deploymentError?has_content>
Error:<br/>
<pre>${deploymentError}</pre>
Comment thread
alhambrav marked this conversation as resolved.
</#if>
Comment thread
alhambrav marked this conversation as resolved.
<br/><br/>
<a href="${liveUrl}" >
<img style="max-width: 350px; max-height: 350px;" src="${liveUrl}/static-assets/images/workflow-email-footer.png" alt="" />
</a>
</p>
</body>
</html>
]]></body>
</emailTemplate>

<emailTemplate key="contentApproval">
<subject><![CDATA[<#if scheduleDate??>Content Scheduled <#else>Content Approved</#if>]]></subject>
<subject><![CDATA[<#if publishPackage.schedule??>Content Scheduled <#else>Content Approved</#if>]]></subject>
<!-- Timezone can/is being overwritten in the following template -->
<body><![CDATA[
<#setting time_zone='EST'>
Expand All @@ -3062,29 +3068,37 @@ Below is an example of a configured email messages for each point in the workflo
</head>
<body style=" font-size: 12pt;">
<p>
<#if scheduleDate??>
The following content has been scheduled for publishing on ${scheduleDate?string["MMM dd, yyyy 'at' hh:mm a"]} Eastern Time.
<#if publishPackage.packageType == 'INITIAL_PUBLISH'>
${reviewer.first_name!submitter.username} ${reviewer.last_name} has approved your initial publish request.
<#elseif publishPackage.packageType == 'PUBLISH_ALL'>
${reviewer.first_name!submitter.username} ${reviewer.last_name} has approved your publish all request.
<#else>
The following content has been reviewed and approved by ${approver.firstName!approver.username} ${approver.lastName!""}:
</#if>
<ul>
<#list files as file>
<#if file.page>
<a href="${liveUrl}/${file.browserUri!""}">
</#if>
<li>${file.internalName!file.name}</li>
<li>
<#if file.page>
<a href="${liveUrl}/${file.browserUri!""}">
</#if>
${file.internalName!file.name}
<#if file.page>
</a>
</#if>
</li>
</#list>
</ul><br/>
Site: ${siteName}
<br />
<#if scheduleDate??>
<a href="${liveUrl}">Click Here to View Your Published Content</a>
<br/>
Scheduled date: ${publishPackage.schedule?datetime.iso?string["MMM dd, yyyy 'at' hh:mm a"]} Eastern Time.
<br />
</#if>
<a href="${authoringUrl}/site-dashboard" >
<img style="max-width: 350px; max-height: 350px;" src="${liveUrl}/static-assets/images/workflow-email-footer.png" alt="" />
</a>
Target: ${publishPackage.target}
<br/>
Reviewer comment:<br/>
${publishPackage.reviewerComment!""}
<br/>
</p>
</body>
</html>
Expand All @@ -3101,28 +3115,44 @@ Below is an example of a configured email messages for each point in the workflo
</head>
<body style=" font-size: 12pt">
<p>
${submitter.firstName!submitter.username} ${submitter.lastName} has submitted items for your review:
<ul>
<#list files as file>
<#if file.page>
<a href="${authoringUrl}/preview/#/?page=${file.browserUri!""}&site=${siteName}">
</#if>
<li>${file.internalName!file.name}</li>
<#if file.page>
</a>
</#if>
</#list>
</ul>
<#if submissionComments?has_content>
<#if publishPackage.packageType == 'PUBLISH_ALL'>
${submitter.first_name!submitter.username} ${submitter.last_name} has submitted a 'publish all' request for your review.
<#elseif publishPackage.packageType == 'INITIAL_PUBLISH'>
${submitter.first_name!submitter.username} ${submitter.last_name} has submitted an 'initial publish' request for your review.
<#else>
${submitter.first_name!submitter.username} ${submitter.last_name} has submitted items for your review:
</#if>
<#if files?? &amp;&amp; files?size gt 0>
Comment thread
alhambrav marked this conversation as resolved.
Outdated
<ul>
<#list files as file>
<li>
<#if file.page>
<a href="${authoringUrl}/studio/preview/#/?page=${file.browserUri!""}&site=${siteName}">
</#if>
${file.internalName!file.name}
<#if file.page>
</a>
</#if>
</li>
</#list>
</ul>
</#if>
<br />
Site: ${siteName}
<br />
<#if publishPackage.submitterComment?has_content>
Comments:<br/>
${submissionComments!""}
${publishPackage.submitterComment!""}
<br/>
</#if>
<#if publishPackage.schedule??>
Scheduled date: ${publishPackage.schedule?datetime.iso?string["MMM dd, yyyy 'at' hh:mm a"]} Eastern Time.
<br/>
</#if><br/>
<a href="${previewUrl}/site-dashboard">Click Here to View Content Waiting for Approval</a>
</#if>
Target: ${publishPackage.target}
<br/>
<a href="${authoringUrl}/studio/site-dashboard">Click Here to View Content Waiting for Approval</a>
<br/><br/>
<a href="${liveUrl}" >
<img style="max-width: 350px; max-height: 350px;" src="${liveUrl}/static-assets/images/workflow-email-footer.png" alt="" />
</a>
</p>
</body>
</html>
Expand All @@ -3139,24 +3169,40 @@ Below is an example of a configured email messages for each point in the workflo
</head>
<body style=" font-size: 12pt;">
<p>
The following content has been reviewed and requires some revision before it can be approved:
<ul>
<#list files as file>
<#if file.page>
<a href="${authoringUrl}/preview/#/?page=${file.browserUri!""}&site=${siteName}">
</#if>
<li>${file.internalName!file.name}</li>
<#if file.page>
</a>
</#if>
</#list>
</ul>
<#if publishPackage.packageType == 'INITIAL_PUBLISH'>
${reviewer.first_name!submitter.username} ${reviewer.last_name} has reviewed your initial publish request and it requires some revision before it can be approved:
<#elseif publishPackage.packageType == 'PUBLISH_ALL'>
${reviewer.first_name!submitter.username} ${reviewer.last_name} has reviewed your publish all request and it requires some revision before it can be approved:
<#else>
${reviewer.first_name!submitter.username} ${reviewer.last_name} has reviewed the following content that requires some revision before it can be approved:
</#if>
<#if files?? &amp;&amp; files?size gt 0>
Comment thread
alhambrav marked this conversation as resolved.
Outdated
<ul>
<#list files as file>
<li>
<#if file.page>
<a href="${authoringUrl}/studio/preview/#/?page=${file.browserUri!""}&site=${siteName}">
</#if>
${file.internalName!file.name}
<#if file.page>
</a>
</#if>
</li>
</#list>
</ul>
</#if>
<br />
Site: ${siteName}
<br />
<#if publishPackage.schedule??>
Scheduled date: ${publishPackage.schedule?datetime.iso?string["MMM dd, yyyy 'at' hh:mm a"]} Eastern Time.
<br/>
</#if>
Target: ${publishPackage.target}
<br/>
Reason:<br/>
${rejectionReason!""}
<br/><br/>
<a href="${authoringUrl}/site-dashboard" >
<img style="max-width: 350px; max-height: 350px;" src="${liveUrl}/static-assets/images/workflow-email-footer.png" alt="" />
</a>
${publishPackage.reviewerComment!""}
<br/>
</p>
</body>
</html>
Expand All @@ -3166,6 +3212,10 @@ Below is an example of a configured email messages for each point in the workflo
</lang>
</notificationConfig>

.. raw:: html

</details>

|hr|

.. _studio-validations-regex:
Expand Down