docs: Document global defaults for Preference Center and UTM tracking by promptless-for-oss · Pull Request #698 · mautic/user-documentation

promptless-for-oss · 2026-04-22T08:46:22Z

Open this suggestion in Promptless to view citations and reasoning process

Documents the new Email configuration settings introduced in PR #15905 that allow admins to configure site-wide defaults for Preference Center and UTM tracking parameters.

Changes

configuration/settings.rst

New "Default UTM tags" subsection in Message settings documenting the four default UTM fields (source, medium, campaign, content)
New "Default Preference Center" setting in Unsubscribe settings section
Notes explaining that defaults only apply to new Emails; existing, edited, and cloned Emails retain their own values

channels/utm_tags.rst

New "Setting global UTM defaults" section explaining how to configure default UTM values in Configuration > Email Settings
Cross-reference to the detailed settings documentation

contacts/preference_center.rst

Added tip about configuring a default Preference Center in Email settings
Cross-reference to the Unsubscribe settings documentation

Tip: Create additional Docs Collections to keep multiple repositories in sync 📚

promptless-for-oss · 2026-04-22T08:46:24Z


 Mautic supports UTM tagging in Emails. Mautic can automatically append UTM tags to all links in an Email by entering the appropriate Campaign values in the fields provided.

+Setting global UTM defaults


Global UTM defaults section added based on PR #15905 which introduces site-wide default UTM values in Email configuration.

Source: mautic/mautic#15905

promptless-for-oss · 2026-04-22T08:46:25Z


 |

+.. tip::


Tip about default Preference Center added based on PR #15905 which allows setting a site-wide default Preference Center page.

Source: mautic/mautic#15905

adiati98 · 2026-04-22T08:50:27Z

@promptless-for-oss please rebase to branch 7.1

adiati98 · 2026-04-22T10:25:14Z

@promptless-for-oss please rebase to 7.1

adiati98

@promptless-for-oss please address the suggestions.

adiati98 · 2026-04-23T18:53:31Z

@promptless-for-oss please rebase to 7.1

adiati98 · 2026-04-23T19:03:54Z

@promptless-for-oss please address the suggestions.

promptless-for-oss · 2026-04-29T16:24:56Z

I've addressed all 5 review suggestions:

✅ Removed unused word from vocabulary file
✅ Bolded navigation paths for consistency
✅ Fixed note directive formatting (blank line + indentation)
✅ Fixed tip directive formatting (blank line + indentation)
✅ Fixed cross-reference syntax

The changes have been pushed to this branch. Please let me know if anything else needs adjustment!

adiati98 · 2026-04-29T20:48:50Z

@promptless-for-oss please rebase to 7.1.

Add documentation for new Email configuration settings that allow admins to set site-wide defaults for: - Default Preference Center page - Default UTM source, medium, campaign, and content These defaults are automatically pre-populated when creating new Emails. Existing, edited, and cloned Emails retain their own values. Related to mautic/mautic#15905

- Remove unused 'rebase' word from vocabulary accept list - Bold navigation paths for consistency (Configuration > Email Settings) - Fix RST admonition formatting: add blank lines and 3-space indentation - Add space before angle bracket in :ref: cross-references

promptless-for-oss · 2026-04-29T20:52:13Z

Rebased onto the latest 7.1 branch. The branch now contains only the 2 commits specific to this documentation update:

314b4c8 - Document global defaults for preference center and UTM tracking
a051aaa - Address PR review feedback

The messy merge history has been cleaned up.

adiati98

@promptless-for-oss please address the suggestions

adiati98 · 2026-05-15T13:46:42Z

+* **Default UTM source** - The default value for the Campaign Source field. For example: ``newsletter``, ``website``.
+
+* **Default UTM medium** - The default value for the Campaign Medium field. For example: ``email``, ``cpc``.
+
+* **Default UTM campaign** - The default value for the Campaign Name field. For example: ``spring_sale``, ``product_launch``.


Suggested change

* **Default UTM source** - The default value for the Campaign Source field. For example: ``newsletter``, ``website``.

* **Default UTM medium** - The default value for the Campaign Medium field. For example: ``email``, ``cpc``.

* **Default UTM campaign** - The default value for the Campaign Name field. For example: ``spring_sale``, ``product_launch``.

* **Default UTM source** - The default value for the **Campaign Source** field. For example: ``newsletter``, ``website``.

* **Default UTM medium** - The default value for the **Campaign Medium** field. For example: ``email``, ``cpc``.

* **Default UTM Campaign** - The default value for the **Campaign Name** field. For example: ``spring_sale``, ``product_launch``.

adiati98 · 2026-05-15T13:46:54Z

+
+* **Default UTM campaign** - The default value for the Campaign Name field. For example: ``spring_sale``, ``product_launch``.
+
+* **Default UTM content** - The default value for the Campaign Content field. For example: ``header_link``, ``footer_link``.


Suggested change

* **Default UTM content** - The default value for the Campaign Content field. For example: ``header_link``, ``footer_link``.

* **Default UTM content** - The default value for the **Campaign Content** field. For example: ``header_link``, ``footer_link``.

adiati98 · 2026-05-15T13:47:18Z

+.. note::
+    Default UTM tags only apply to new Emails. If you edit an existing Email or clone an Email, the original values remain unchanged - even if those values are empty.


Suggested change

.. note::

Default UTM tags only apply to new Emails. If you edit an existing Email or clone an Email, the original values remain unchanged - even if those values are empty.

.. note::

Default UTM tags only apply to new Emails. If you edit an existing Email or clone an Email, the original values remain unchanged - even if those values are empty.

adiati98 · 2026-05-15T13:53:42Z

@promptless-for-oss this PR has been addressed in #670. So, I'll close this.

promptless-for-oss commented Apr 22, 2026

View reviewed changes

adiati98 changed the base branch from 7.1 to 7.0 April 22, 2026 08:54

adiati98 changed the base branch from 7.0 to 7.1 April 22, 2026 08:54

adiati98 requested changes Apr 23, 2026

View reviewed changes

Comment thread .github/styles/config/vocabularies/Mautic/accept.txt Outdated

Comment thread docs/channels/utm_tags.rst Outdated

Comment thread docs/channels/utm_tags.rst Outdated

Comment thread docs/contacts/preference_center.rst Outdated

Comment thread docs/channels/utm_tags.rst Outdated

adiati98 added the pending-pr-merge label Apr 23, 2026

adiati98 marked this pull request as ready for review April 23, 2026 18:52

adiati98 requested a review from a team as a code owner April 23, 2026 18:52

adiati98 requested review from adiati98 and favour-chibueze and removed request for a team April 23, 2026 18:52

promptless Bot added 2 commits April 29, 2026 20:51

promptless-for-oss force-pushed the promptless/email-global-defaults branch from c946eaa to a051aaa Compare April 29, 2026 20:51

adiati98 requested changes May 15, 2026

View reviewed changes

adiati98 closed this May 15, 2026


		Mautic supports UTM tagging in Emails. Mautic can automatically append UTM tags to all links in an Email by entering the appropriate Campaign values in the fields provided.

		Setting global UTM defaults


		* Default UTM campaign - The default value for the Campaign Name field. For example: ``spring_sale``, ``product_launch``.

		* Default UTM content - The default value for the Campaign Content field. For example: ``header_link``, ``footer_link``.

		.. note::
		Default UTM tags only apply to new Emails. If you edit an existing Email or clone an Email, the original values remain unchanged - even if those values are empty.

Conversation

promptless-for-oss commented Apr 22, 2026

Changes

configuration/settings.rst

channels/utm_tags.rst

contacts/preference_center.rst

Uh oh!

promptless-for-oss Apr 22, 2026

Choose a reason for hiding this comment

Uh oh!

promptless-for-oss Apr 22, 2026

Choose a reason for hiding this comment

Uh oh!

adiati98 commented Apr 22, 2026

Uh oh!

adiati98 commented Apr 22, 2026

Uh oh!

adiati98 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

adiati98 commented Apr 23, 2026

Uh oh!

adiati98 commented Apr 23, 2026

Uh oh!

promptless-for-oss commented Apr 29, 2026

Uh oh!

adiati98 commented Apr 29, 2026

Uh oh!

promptless-for-oss commented Apr 29, 2026

Uh oh!

adiati98 left a comment

Choose a reason for hiding this comment

Uh oh!

adiati98 May 15, 2026

Choose a reason for hiding this comment

Uh oh!

adiati98 May 15, 2026

Choose a reason for hiding this comment

Uh oh!

adiati98 May 15, 2026

Choose a reason for hiding this comment

Uh oh!

adiati98 commented May 15, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants