From 25aa34ae7d072336f1b523d7dee42660b2d05667 Mon Sep 17 00:00:00 2001 From: "promptless[bot]" Date: Mon, 30 Mar 2026 08:19:14 +0000 Subject: [PATCH 1/4] Document Unsubscribe-to-Open Ratio stat for Email reports Add new 'Email report columns' section to document the Unsubscribe-to-Open Ratio (UTOR) stat introduced in mautic/mautic PR #15066. This section also documents related Email engagement columns (Read count, Unsubscribed, Bounced). --- docs/reports/reports.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/reports/reports.rst b/docs/reports/reports.rst index fc065d69..980de191 100644 --- a/docs/reports/reports.rst +++ b/docs/reports/reports.rst @@ -84,6 +84,19 @@ As demonstrated, Mautic displays the data sources in the format: `` Date: Fri, 24 Apr 2026 13:50:00 +0000 Subject: [PATCH 2/4] Fix definition list style: use colon instead of dash Change Email report columns formatting from "**Term** - description" to "**Term:** description" per style feedback. --- docs/reports/reports.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/reports/reports.rst b/docs/reports/reports.rst index 980de191..e8be0346 100644 --- a/docs/reports/reports.rst +++ b/docs/reports/reports.rst @@ -89,10 +89,10 @@ Email report columns When using 'Emails' as the data source, you can add the following columns to measure Email engagement: -* **Read count** - the number of Contacts who opened the Email. -* **Unsubscribed** - the number of Contacts who unsubscribed after receiving the Email. -* **Bounced** - the number of Emails that bounced. -* **Unsubscribe-to-Open Ratio** - the percentage of unsubscribed Contacts relative to those who opened the Email. This helps you understand how Email content affects unsubscribe rates among engaged recipients. +* **Read count:** the number of Contacts who opened the Email. +* **Unsubscribed:** the number of Contacts who unsubscribed after receiving the Email. +* **Bounced:** the number of Emails that bounced. +* **Unsubscribe-to-Open Ratio:** the percentage of unsubscribed Contacts relative to those who opened the Email. This helps you understand how Email content affects unsubscribe rates among engaged recipients. .. tip:: Use the Unsubscribe-to-Open Ratio to compare the unsubscribe impact of different Emails. A high ratio may indicate that the Email content didn't meet recipient expectations, while a low ratio suggests it resonated with those who read it. From 4a093104ce494c6de02cdc215046918f9c40d37d Mon Sep 17 00:00:00 2001 From: "promptless[bot]" Date: Fri, 24 Apr 2026 13:53:51 +0000 Subject: [PATCH 3/4] Fix admonition formatting in tip block Add blank line between directive and content per RST admonition conventions. --- docs/reports/reports.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/reports/reports.rst b/docs/reports/reports.rst index e8be0346..0906f251 100644 --- a/docs/reports/reports.rst +++ b/docs/reports/reports.rst @@ -95,6 +95,7 @@ When using 'Emails' as the data source, you can add the following columns to mea * **Unsubscribe-to-Open Ratio:** the percentage of unsubscribed Contacts relative to those who opened the Email. This helps you understand how Email content affects unsubscribe rates among engaged recipients. .. tip:: + Use the Unsubscribe-to-Open Ratio to compare the unsubscribe impact of different Emails. A high ratio may indicate that the Email content didn't meet recipient expectations, while a low ratio suggests it resonated with those who read it. * **Description - optional** - Add detailed information about the Report, helping you and other Users better understand what the Report is for. You may want to include more information about filters, people, or departments. From a4cfc280e18521b875dfa6e2cb221d7448278a58 Mon Sep 17 00:00:00 2001 From: "promptless[bot]" Date: Fri, 24 Apr 2026 14:01:03 +0000 Subject: [PATCH 4/4] Move Email report columns section after Dynamic filters settings Repositions the Email report columns documentation to appear after the Dynamic filters settings bullet point, improving the logical flow of the Details tab options. --- docs/reports/reports.rst | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/reports/reports.rst b/docs/reports/reports.rst index 0906f251..0c8cb03e 100644 --- a/docs/reports/reports.rst +++ b/docs/reports/reports.rst @@ -84,6 +84,19 @@ As demonstrated, Mautic displays the data sources in the format: ``