Adding campaign republish behavior docs by escopecz · Pull Request #561 · mautic/user-documentation

escopecz · 2025-11-27T13:11:09Z

adiati98

Thanks for the PR, @escopecz!

As there are a few Vale error warnings, I just want to make sure a couple of things here:

Is there any "unpublish" word across the changes refers to Mautic's term? If so, Vale wants it to be "Unpublish". If there's none, we can ignore this by wrapping the sentence within .. vale off and .. vale on statements.
Should the word "cron" in line 128 capitalized ("Cron)? If not, we can also ignore it.

TIA! ✨

RCheesley

Thanks for the PR @escopecz - some work to do in order to align with the wording used for active/inactive states, and I think it could also benefit from a screenshot.

RCheesley · 2025-12-09T13:40:59Z

docs/campaigns/managing_campaigns.rst

+
+.. vale on
+
+When you Unpublish and then republish a Campaign, Mautic provides control over how scheduled events with relative delays - such as "Send Email 5 days after joining" - should behave. This feature gives you flexibility in managing Campaign timing based on your specific use case.


This functionality is now called 'activate' and 'deactivate' so it's going to need updating throughout this PR.

RCheesley · 2025-12-09T13:42:14Z

docs/campaigns/managing_campaigns.rst

+Publish and Unpublish Campaigns
+======================================
+
+When you publish or Unpublish a Campaign, Mautic displays a confirmation message that shows the current republish behavior setting. This helps you understand what happens to scheduled events before you confirm the action.


Let's add a screenshot here.

Oh man. The wording is not consistent in the UI. Here are the screenshots but I think we'll have to update the wording in the product too, right?

Yes, we will indeed. cc @andersonjeccel for visibility.

What would be the re-wording for republish? Reactivate?

I believe it should now be:

Active / Activate / Reactivate
Inactive / Deactivate

Referencing this PR: mautic/mautic#14239 and this PR: mautic/mautic#13500

So the new setting label should be called "Campaign Reactivate Behaviour"?

RCheesley · 2025-12-09T13:42:55Z

docs/configuration/settings.rst

 * **Use date range for all views** - When viewing a Campaign, the date range of actions, conditions, decisions, and Contacts displayed in the tabs, Mautic uses this date range by default.

-* **Use summary statistics** - Improves performance when viewing a Campaign with thousands of events per day by using summarized data. When you first turn on this setting you need to run a :ref:`cron job<campaign cron jobs>` to summarize existing data.
+* **Use summary statistics** - Improves performance when viewing a Campaign with thousands of events per day by using summarized data. When you first turn on this setting you need to run a :ref:`Cron job<campaign cron jobs>` to summarize existing data.


Let's link to the specific cron job here.

adiati98

Hi @escopecz,

I see that your branch is way behind our current 5.2 branch, by 211 commits. Can you please update your branch (with whichever method you think best!) with the latest state of the docs?

We also have branch '7.0` for Mautic 7. Would it be better to pull the changes from this branch?

TIA!

escopecz · 2025-12-09T14:54:30Z

@adiati98 I created the branch 7.1 from the 7.0 branch and that's the target branch for this PR. As this won't go to Mautic 7.0 but 7.1. Is that alright?

adiati98 · 2025-12-09T15:03:30Z

@adiati98 I created the branch 7.1 from the 7.0 branch and that's the target branch for this PR. As this won't go to Mautic 7.0 but 7.1. Is that alright?

That's totally fine and actually great! What I meant is your PR branch here based on below screenshot.

The build is failing in this PR because of some broken links. I've fixed these exact links a couple of months ago. That's why I tracked your branch and noticed that the base branch that you're using to work on the changes is outdated.

escopecz · 2025-12-09T15:37:31Z

@adiati98 gotcha. I don't push to the base branches in my fork but I keep it up to date on my local. So would it mean that your fixes weren't merged to the 7.0 branch?

adiati98 · 2025-12-09T15:51:45Z

@escopecz I've fixed the links in branch 7.0 as well, and it's merged already: #430

escopecz · 2025-12-09T16:22:38Z

@adiati98 you were right. I based the 7.1 branch on an outdated 7.0 branch. I rebased the 7.1 to the latest 7.0 branch and this PR on top of that 7.1 branch. Although I still can see some failures in files I didn't change.

@RCheesley I pushed the rewording changes. Is it good like this?

adiati98 · 2025-12-09T16:34:58Z

@escopecz thanks so much for updating the branch! ✨
The broken links that are now appeared are new.

@RCheesley New broken links come from https://developer.mautic.org/. Does this have anything to do with the developer docs redirect from the outdated to the new one?

I'll add them to the links ignore list some time this week or fix them so they're pointing to the correct link in the new docs if available. 👍🏼

adiati98

@escopecz sorry for the delay! I left some suggestions here. 🙂

docs/campaigns/creating_campaigns.rst

docs/campaigns/managing_campaigns.rst

Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com>

escopecz mentioned this pull request Nov 27, 2025

Campaign republish behavior mautic/mautic#15634

Merged

adiati98 reviewed Nov 28, 2025

View reviewed changes

escopecz requested a review from adiati98 December 9, 2025 09:01

RCheesley requested changes Dec 9, 2025

View reviewed changes

adiati98 requested changes Dec 9, 2025

View reviewed changes

escopecz added 3 commits December 9, 2025 17:20

Adding campaign republish behavior docs

efbb342

Calud is fixing Vale errors

bf9ed15

Rewording to fit the UI changes

bf4fb31

escopecz force-pushed the campaign-republish branch from 7fb7d7a to bf4fb31 Compare December 9, 2025 16:20

escopecz requested a review from a team as a code owner December 9, 2025 16:20

escopecz requested review from adiati98 and favour-chibueze and removed request for a team December 9, 2025 16:20

Vale fixes

3e0299f

Merge branch '7.1' into campaign-republish

8b68067

adiati98 requested changes Dec 17, 2025

View reviewed changes

escopecz and others added 8 commits December 18, 2025 14:54

Apply suggestion from @adiati98

298b806

Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com>

Apply suggestion from @adiati98

55ca378

Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com>

Apply suggestion from @adiati98

b333583

Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com>

Apply suggestion from @adiati98

0c5d939

Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com>

Apply suggestion from @adiati98

a0dfa28

Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com>

Apply suggestion from @adiati98

5c96bce

Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com>

Apply suggestion from @adiati98

d423c8f

Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com>

Apply suggestion from @adiati98

8c61628

Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com>

Apply suggestions from code review

b368a36

Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com>

escopecz requested a review from adiati98 December 18, 2025 13:56

adiati98 added this to the Mautic 7.1 milestone Dec 18, 2025

adiati98 added 2 commits January 4, 2026 10:35

Merge branch '7.1' into campaign-republish

4388908

Merge branch '7.1' into campaign-republish

109e48c

adiati98 added this to Mautic's No/Low/Code Tasks Jan 25, 2026

adiati98 moved this to 🔎 In review in Mautic's No/Low/Code Tasks Jan 25, 2026


		.. vale on

		When you Unpublish and then republish a Campaign, Mautic provides control over how scheduled events with relative delays - such as "Send Email 5 days after joining" - should behave. This feature gives you flexibility in managing Campaign timing based on your specific use case.

Conversation

escopecz commented Nov 27, 2025

Uh oh!

adiati98 left a comment

Choose a reason for hiding this comment

Uh oh!

RCheesley left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

adiati98 left a comment

Choose a reason for hiding this comment

Uh oh!

escopecz commented Dec 9, 2025

Uh oh!

adiati98 commented Dec 9, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

escopecz commented Dec 9, 2025

Uh oh!

adiati98 commented Dec 9, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

escopecz commented Dec 9, 2025

Uh oh!

adiati98 commented Dec 9, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

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!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

adiati98 commented Dec 9, 2025 •

edited

Loading

adiati98 commented Dec 9, 2025 •

edited

Loading

adiati98 commented Dec 9, 2025 •

edited

Loading