Skip to content

notifications: use "Estuary" in alert email subjects (#3000)#3173

Closed
0xfandom wants to merge 3 commits into
estuary:masterfrom
0xfandom:fix/alert-email-product-name
Closed

notifications: use "Estuary" in alert email subjects (#3000)#3173
0xfandom wants to merge 3 commits into
estuary:masterfrom
0xfandom:fix/alert-email-product-name

Conversation

@0xfandom

Copy link
Copy Markdown

Description:

Alert emails prefixed their subject with Estuary Flow:, while the rest of the product says just "Estuary". This drops "Flow" from the subject of every alert type, and from the remaining body prose.

This mostly finishes a migration that was already underway — FreeTrial's fired subject was already Estuary Free Trial, MissingPaymentMethod's was already Estuary: …, and several bodies already read "Your Estuary account" / "Your Estuary {{spec_type}}".

Three commits, so the last two can be dropped independently if you'd rather scope this tightly:

  1. SubjectsEstuary Flow:Estuary: across all 13 subject templates. This is what Update product name in alert emails #3000 asks for.
  2. Bodies — the free-trial and missing-payment-method bodies still read "We hope you are enjoying Estuary Flow". Prose rather than subject lines, but the same "cohesive messaging" point.
  3. Tests — closes a coverage gap the rename exposed (see below).

Fixes #3000

Workflow steps:

No API or CLI surface changes; this only affects the subject and body text of outbound alert emails. For example, a failing capture previously sent:

Estuary Flow: Task failure detected for capture acmeCo/test/capture

and now sends:

Estuary: Task failure detected for capture acmeCo/test/capture

Affected alert types: AutoDiscoverFailed, BackgroundPublicationFailed, DataMovementStalled, FreeTrial, FreeTrialEnding, ShardFailed, TaskAutoDisabledFailing, TaskAutoDisabledIdle, TaskChronicallyFailing, TaskIdle.

Documentation links affected:

None. The subject strings live only in the notifications crate's handlebars templates; nothing under site/ documents them.

Notes for reviewers:

  • A coverage gap turned up while doing this, and it's the part most worth a look. The subject templates for TaskIdle, TaskAutoDisabledFailing and TaskAutoDisabledIdle had no test asserting them — I changed one to BROKEN: and the suite stayed green, so the rename was touching three lines nothing guarded. The third commit adds a fired-state test per type, following the existing assert_email + snapshot pattern; the same deliberate break now fails on subject mismatch. All three are fired-only, so there's no resolved case. Happy to split that commit into its own PR if you'd prefer it separate from a rename.
  • Snapshots: only the notifications__* files are updated. The parallel alert_notifications__* set appears orphaned — no test renders them, and they don't regenerate — and notifications: remove stale alert_notifications snapshot files #3079 is already removing them, so I left them alone rather than create a conflict. Each of the 5 updated snapshots is a one-line diff.
  • free_trial's resolved subject is a conditional; its has_credit_card branch becomes Estuary: Paid Tier, which lines up with the existing else branch (Estuary Paid Tier: Enter Payment Info…).
  • Verified with cargo test -p notifications — 28 passing (25 existing + 3 new). cargo fmt clean.

0xfandom added 3 commits July 15, 2026 17:38
Alert email subjects were prefixed "Estuary Flow:", while the rest of the
product refers to just "Estuary". Drop "Flow" from the subject line of
every alert type for consistent messaging.

This finishes a migration already partly done: the FreeTrial fired
subject was already "Estuary Free Trial", MissingPaymentMethod's was
already "Estuary: ...", and several bodies already say "Your Estuary
account" / "Your Estuary {{spec_type}}".

Email bodies still say "Estuary Flow" in a few places; those are prose
rather than subject lines and are left to the next commit.

Fixes estuary#3000
Follow through on the subject-line rename: the free-trial and
missing-payment-method bodies still read "We hope you are enjoying
Estuary Flow". Bodies elsewhere in the crate already say "Your Estuary
account" and "Your Estuary {{spec_type}}", so this brings the remaining
prose in line.

Only the `notifications__*` snapshots are updated. The parallel
`alert_notifications__*` snapshot files are orphaned leftovers that no
test renders, and are already being removed by estuary#3079.
The subject templates for TaskIdle, TaskAutoDisabledFailing and
TaskAutoDisabledIdle had no test asserting them: breaking any of their
subject strings left the suite green, so the rename in the preceding
commits touched three lines nothing guarded.

Add a fired-state test per alert type, following the existing
assert_email + body snapshot pattern. Each now fails on a subject
mismatch. All three are fired-only, so there is no resolved case.
@aeluce

aeluce commented Jul 15, 2026

Copy link
Copy Markdown
Collaborator

Hey, thanks for the interest in contributing to Estuary!

I ended up wanting to change some other aspects of notification emails beyond the "Estuary vs. Estuary Flow" issue, so I opened my own PR to address #3000. Appreciate the thought, though!

@aeluce aeluce closed this Jul 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update product name in alert emails

2 participants