Understanding review notifications

IMPORTANT
The new features described in this article are enabled by default with 2508 release of Experience Manager Guides as a Cloud Services. Reviews that were created before the migration are not impacted and will continue to use the earlier workflow. If you prefer to continue using the existing features without these updates, contact your Customer Success team to have the new features disabled.

Experience Manager Guides streamlines collaboration between Authors and Reviewers through a structured review workflow. As part of this workflow, notifications play a key role in keeping all participants of a review task informed and responsive to changes.

Whenever a review-related action is performed, such as task assignment, completion, or feedback updates, a notification is automatically sent to the involved users of the review task to draw their immediate attention. These notifications are delivered in two formats:

  • AEM notifications: Displayed within the AEM interface.
  • Email notifications: Sent directly to the user’s inbox.

The below table provides an overview of the different types of review notifications, what actions trigger them, and how they appear across different formats:

Review notification formats with sample values

Review action
Notification title (AEM)
Notification text (AEM)
Email subject
Email notification text
Recipient
Review task created
Review task assigned: Homepage Review
Assigned by Author
Review task assigned: Homepage Review
Author has created a review task Homepage Review in project WebDocs Revamp with due date 15 Aug 2025. You have been assigned as a reviewer.
Reviewer
Feedback submitted
Review feedback received for Homepage Review
Feedback from Reviewer
Review feedback received for Homepage Review
Reviewer has submitted feedback for task Homepage Review in project WebDocs Revamp. Please review and make necessary updates well in advance of due date 15 Aug 2025.
Author or Initiator of task
Re-review requested
Re-review requested for Homepage Review
Requested by Author
Re-review requested for Homepage Review by Author
Author has updated the document for task Homepage Review based on your feedback and is requesting a re-review. Please review well in advance of due date 15 Aug 2025.
Reviewer
Review closed
Review task closed: Homepage Review
Closed by Author
Review task closed: Homepage Review
The review task Homepage Review under project WebDocs Revamp has been closed by Author.
Author or Initiator of task , Reviewer
Reviewer unassigned
Unassigned from review task Homepage Review
Unassigned by Author
Unassigned from review task Homepage Review
You have been unassigned from the review task Homepage Review under project WebDocs Revamp by Author.
Reviewer
Tag mention
Mentioned in review task comment for Homepage Review
Mentioned by Author
Mentioned in review task comment for Homepage Review
You’ve been mentioned in a comment on task Homepage Review under WebDocs Revamp by Author. Comment excerpt: “Please update the heading structure to follow accessibility guidelines.”
Mentioned user
Content updated during review
Topic updated in review task Homepage Review
Updated by Author
Topic updated in review task Homepage Review
Author has updated the topic versions for review task Homepage Review. Please review well in advance of due date 15 Aug 2025.
Reviewer

In the above table, the text in bold represents sample values and is being driven by predefined variables that can be used in notifications.

For example:

  • Homepage Review is a sample task name.
  • Priya (Author) and John (Reviewer) are sample user names.
  • WebDocs Revamp is a sample project name.
  • 15 Aug 2025 is a sample due date.

Additionally, if a task contains comments, a comment excerpt ( a part of the the full comment) is included in the email notification. The excerpt is displayed in the following cases:

  • When you are tagged in a comment, an excerpt of the tagged comment appears in the email notification.
  • When a task-level comment is added to a review task you are part of, an excerpt of that comment appears in the email notification.

For a complete list of predefined variables and review notification customization, view Configure and customize workflows.

Parent topic:Introduction to review

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178