Skip to content

docs(email): document global defaults for preference center and UTM tracking#670

Open
msoukhomlinov wants to merge 5 commits intomautic:7.0from
msoukhomlinov:docs/email-global-defaults
Open

docs(email): document global defaults for preference center and UTM tracking#670
msoukhomlinov wants to merge 5 commits intomautic:7.0from
msoukhomlinov:docs/email-global-defaults

Conversation

@msoukhomlinov
Copy link
Copy Markdown

Summary

Documents the five new Configuration → Email settings introduced in mautic/mautic#15905:

  • Default UTM source, medium, Campaign, content — added to the Message settings section
  • Default Preference Center Landing Page — added to the Unsubscribe settings section

When a new Email is created, these site-wide defaults pre-populate the relevant fields. Existing Emails, edited Emails, and cloned Emails always retain their own explicit values.

Changes

  • docs/configuration/settings.rst — two additions matching the UI layout from the code change

Review feedback addressed (from #665)

  • Capitalized "Campaign" as a Mautic feature name
  • Replaced em dashes with commas per style guide
  • Used "Landing Page" instead of "page" for Preference Center setting
  • Replaced "here" link text with descriptive reference for accessibility
  • Used contraction "doesn't" per reviewer suggestion
  • Resubmitted from a dedicated feature branch instead of 7.0

Supersedes #665.

msoukhomlinov and others added 2 commits March 17, 2026 21:05
…racking

Adds descriptions for the five new Configuration → Email settings
introduced in mautic/mautic#15905:
- Default UTM source, medium, campaign, content (Message settings section)
- Default Preference Center page (Unsubscribe settings section)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ommas

- Capitalize "Campaign" as a Mautic feature name in UTM settings
- Replace em dashes with commas per style guide
- Use "Landing Page" instead of "page" for Preference Center setting
- Replace "here" link text with descriptive reference for accessibility
- Use contraction "doesn't" per reviewer suggestion

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@msoukhomlinov msoukhomlinov requested a review from a team as a code owner March 17, 2026 10:06
@msoukhomlinov msoukhomlinov requested review from adiati98 and favour-chibueze and removed request for a team March 17, 2026 10:06
@adiati98
Copy link
Copy Markdown
Contributor

@mautic/core-team can you please re-check the content accuracy? TIA! ✨

Copy link
Copy Markdown
Member

@escopecz escopecz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems good to me 👍

@adiati98
Copy link
Copy Markdown
Contributor

@escopecz just to make sure, this targets branch 7.0 and 7.1, correct?

@escopecz
Copy link
Copy Markdown
Member

This targets 7.1. 7.0 is closed for new PRs now.

@escopecz
Copy link
Copy Markdown
Member

Wait, this will go to 7.2 at earliest as 7.1 is already tagged and it is a new enhancement so it cannot go to a patch version.

@adiati98
Copy link
Copy Markdown
Contributor

adiati98 commented Apr 22, 2026

This targets 7.1. 7.0 is closed for new PRs now.

Would this confirm that there won't be updates for docs in 7.0, and all new updates will target 7.1 and above?
If so, we might change the default branch in docs to 7.1 once it's stable.

@escopecz
Copy link
Copy Markdown
Member

That is correct.

@adiati98 adiati98 added this to the Mautic 7.2 milestone Apr 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants