Skip to content

Document Prevent action after date Campaign condition #766

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
promptless-for-oss wants to merge 1 commit into
base: 7.2
Choose a base branch
from
Open

Document Prevent action after date Campaign condition #766

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 23 additions & 3 deletions docs/campaigns/campaign_builder.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -246,9 +246,11 @@
- Checks if values submitted for a selected field on a selected Form matches specified criteria.
* - **Has active notification**
- Checks if the Contact has an active web notification.
* - **Has valid Email address**
- Checks if the Contact's Email address has a valid syntax, for example name@example.com without spaces, other invalid characters or formats.

* - **Has valid Email address**
- Checks if the Contact's Email address has a valid syntax, for example name@example.com without spaces, other invalid characters or formats.
* - **Prevent action after date**
- Routes Contacts based on how much time has elapsed since the Campaign started. Use this condition to stop sending Campaign actions after a deadline, such as limiting a promotional offer to the first week after Campaign launch.

Notes on delayed conditions and dates
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Expand All @@ -274,6 +276,24 @@

If a Contact appears again at a later date in that Segment because the value of the date has changed, then the Contact passes through the Campaign only once, and hence isn't included in the Campaign again.

Prevent action after date condition

@promptless-for-oss promptless-for-oss Jun 12, 2026

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

New "Prevent action after date" Campaign condition added in PR #15832. The condition uses CampaignEventLeadAttachedType.php for form fields (timestamp, operator, triggerInterval, triggerIntervalUnit) and CampaignSubscriber.php for the evaluation logic comparing current time against campaign start date plus interval.

Source: mautic/mautic#15832

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The Prevent action after date condition routes Contacts based on whether the current time is before or after a threshold relative to the Campaign start date. Use this condition when Campaign actions should only execute within a specific time window after launch.

To configure this condition:

#. **Time Stamp**: Select the reference point for calculating the threshold. Currently, this is the Campaign Start Date - the date and time when the Campaign was first published.

Check warning on line 286 in docs/campaigns/campaign_builder.rst

View workflow job for this annotation

GitHub Actions / prose 

[vale] reported by reviewdog 🐶
[Mautic.FeatureList] Is this referring to a Mautic feature? If so, use 'Active or Available' instead of 'published'.

Raw Output:
{"message": "[Mautic.FeatureList] Is this referring to a Mautic feature? If so, use 'Active or Available' instead of 'published'.", "location": {"path": "docs/campaigns/campaign_builder.rst", "range": {"start": {"line": 286, "column": 169}}}, "severity": "INFO"}

Check warning on line 286 in docs/campaigns/campaign_builder.rst

View workflow job for this annotation

GitHub Actions / prose 

[vale] reported by reviewdog 🐶
[Google.Colons] ': S' should be in lowercase.

Raw Output:
{"message": "[Google.Colons] ': S' should be in lowercase.", "location": {"path": "docs/campaigns/campaign_builder.rst", "range": {"start": {"line": 286, "column": 18}}}, "severity": "WARNING"}

#. **Operator**: Choose how to compare the current time against the threshold:

Check warning on line 288 in docs/campaigns/campaign_builder.rst

View workflow job for this annotation

GitHub Actions / prose 

[vale] reported by reviewdog 🐶
[Google.Colons] ': C' should be in lowercase.

Raw Output:
{"message": "[Google.Colons] ': C' should be in lowercase.", "location": {"path": "docs/campaigns/campaign_builder.rst", "range": {"start": {"line": 288, "column": 16}}}, "severity": "WARNING"}

* **less than**: The Contact takes the green path if the current time is before the threshold. Use this to execute actions only during the initial period after Campaign launch.

Check warning on line 290 in docs/campaigns/campaign_builder.rst

View workflow job for this annotation

GitHub Actions / prose 

[vale] reported by reviewdog 🐶
[Google.Colons] ': T' should be in lowercase.

Raw Output:
{"message": "[Google.Colons] ': T' should be in lowercase.", "location": {"path": "docs/campaigns/campaign_builder.rst", "range": {"start": {"line": 290, "column": 19}}}, "severity": "WARNING"}
* **greater than**: The Contact takes the green path if the current time is after the threshold. Use this to execute actions only after a waiting period has passed.

Check warning on line 291 in docs/campaigns/campaign_builder.rst

View workflow job for this annotation

GitHub Actions / prose 

[vale] reported by reviewdog 🐶
[Google.Colons] ': T' should be in lowercase.

Raw Output:
{"message": "[Google.Colons] ': T' should be in lowercase.", "location": {"path": "docs/campaigns/campaign_builder.rst", "range": {"start": {"line": 291, "column": 22}}}, "severity": "WARNING"}

#. **Interval**: Specify the time duration using a number and unit. Available units are minutes, hours, days, months, and years.

Check warning on line 293 in docs/campaigns/campaign_builder.rst

View workflow job for this annotation

GitHub Actions / prose 

[vale] reported by reviewdog 🐶
[Google.Colons] ': S' should be in lowercase.

Raw Output:
{"message": "[Google.Colons] ': S' should be in lowercase.", "location": {"path": "docs/campaigns/campaign_builder.rst", "range": {"start": {"line": 293, "column": 16}}}, "severity": "WARNING"}

**Example**: A flash sale Campaign should only send promotional Emails during the first 48 hours after launch. Configure the condition with Campaign Start Date, 'less than', and '2 days'. Contacts entering the Campaign within 48 hours of launch take the green path and receive the promotional Email. Contacts entering after 48 hours take the red path, where you can send a different message or take no action.

Check warning on line 295 in docs/campaigns/campaign_builder.rst

View workflow job for this annotation

GitHub Actions / prose 

[vale] reported by reviewdog 🐶
[Google.Colons] ': A' should be in lowercase.

Raw Output:
{"message": "[Google.Colons] ': A' should be in lowercase.", "location": {"path": "docs/campaigns/campaign_builder.rst", "range": {"start": {"line": 295, "column": 12}}}, "severity": "WARNING"}

Smart event schedule
~~~~~~~~~~~~~~~~~~~~~

Expand Down
Loading