Skip to content
PostCraft
Email campaigns from the MODX manager with a send window, tracking and unsubscribe pages
  • MODX 2
  • MODX 3
  • PHP 7.2
  1. Extras
  2. PostCraft
  3. Manager page
  4. Campaign

Campaign ​

The tab builds a new campaign from three blocks: letter, recipients, time.

Letter ​

FieldMeaning
Email templatea PostCraft.* chunk. Its text is copied into the campaign when it is queued
Subjectrequired
Preview textthe line next to the subject in the inbox. Hidden in the letter itself. 40–100 characters work best
Unsubscribe page languagelanguage of the page behind . The list depends on the site of the From mailbox
Fromsender mailbox
Reply-Toaddress for replies. Empty means replies go to the From address

Recipients ​

  • Addresses: one per line or comma separated.
  • Saved list and Insert: addresses from the Lists tab.
  • Add unique emails from saved forms (FormIt): addresses from FormIt submissions. Refresh FormIt count shows how many there are.

PostCraft removes duplicates and skips blacklisted addresses. One run queues up to 10,000 addresses.

The Do not resend to addresses that already got this letter checkbox skips addresses that got this template in another campaign or wait for it in the queue. PostCraft checks this when queueing and again before each letter goes out. Test letters do not count.

Time ​

Letters go out on the chosen day between From and To in the site time zone. Inside the window PostCraft picks the hour for each address from its opens and clicks over the last 90 days. A new address gets the hour when all recipients open letters most often, or 10:00 without any history. If that hour falls outside the window, the letter gets a random time inside it.

Send to everyone now turns off the date and hours: letters go out with the next cron run.

Buttons ​

  • Test to me sends one letter to the email of your MODX profile. It stays out of the stats.
  • Schedule queues the letters and shows the campaign number.

Campaign status ​

StatusWhat happens
Scheduledwaits for its window
Sendingcron sends letters
Pausedno letters until Resume
Cancelledunsent letters will not go out
Donethe queue is empty

Pause, Resume, Cancel mailing and Edit live in the Stats tab table. After a pause, letters whose time has passed move to the nearest window.

Editing a campaign ​

You can edit a scheduled or paused campaign. If sending is in progress, click Pause first.

The edit window changes the subject, preheader, date, hours and the address list in the queue. Delete a line and that address gets no letter. New addresses join the campaign. The Reload letter body from template checkbox takes fresh HTML if the template changed after queueing.

Edits apply to unsent letters only.