mailerpress/format-campaign-html runs MailerPress’s own HtmlParser::replaceVariables() over the HTML you give it.
It is a lint step: merge-tag validation and a tracking-pixel injection preview.
At a glance
| Ability | mailerpress/format-campaign-html |
| Toolset | MailerPress — toolset/mailerpress |
| Group | MailerPress › Campaigns & Sending |
| Requires | AcrossAI Pro, plus MailerPress active on the site |
| Capability | manage_options |
| Safety | Read-only — changes nothing |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Pro 0.9.16 and later |
How it works
Merge tags are the part worth checking. A mistyped tag does not error — it renders as literal text, so an email goes out saying “Hello [firts_name]” to everybody on the list.
Running the parser before sending catches that, because the parser is what would have replaced it.
The tracking-pixel preview shows where MailerPress injects its open-tracking pixel, which matters for templates that do unusual things at the end of the body — a pixel injected inside a hidden element does not fire.
This operates on HTML you pass rather than on a stored campaign, which makes it usable during authoring, before anything is saved.
It changes nothing and sends nothing.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
html | string | Yes | The HTML to parse. |
id | integer | No | Campaign context for the variables. |
What comes back
| Name | Type | What it is |
|---|---|---|
html | string | The parsed result. |
warnings | array | Merge-tag problems found. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
Check the merge tags in this email before I send it.
It resolves to one call:
{
"ability": "mailerpress/format-campaign-html",
"parameters": {
"html": "<p>Hello [first_name]</p>"
}
}Worth knowing
- A mistyped merge tag renders as literal text to the whole list.
- The pixel preview catches templates where tracking would not fire.
- Operates on HTML you pass, not on a stored campaign.
- Changes nothing.
Related abilities
- MailerPress Preview Campaign For Contact — render against a real contact
- MailerPress Save Campaign Content — save it once it lints
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category