Document Clone with translations and variants feature for Emails

[promptless-for-oss]

Open this suggestion in Promptless to view citations and reasoning process

Adds documentation for the new Email cloning feature that allows users to clone an entire Email family (parent, translations, and A/B variants) in one step. The new action appears in the Email detail page actions menu for parent Emails that have translations or variants.

Trigger Events

• mautic/mautic PR #16131: [UXUI-246] Clone email with translations and variants

---

Tip: Leave inline comments with @Promptless on suggestion diffs in the Promptless dashboard for targeted refinements 💬

[adiati98]

@promptless-for-oss please address the suggestions

[promptless-for-oss]

Thanks for the review feedback, @adiati98! I've addressed all four suggestions:

1. ✅ Changed to "Actions menu on the Email detail view"
2. ✅ Rephrased the Clone with translations and variants description
3. ✅ Updated step 1 to "Email detail view of the parent Email"
4. ✅ Fixed Vale warning: replaced "unpublished" with "Unavailable or Deactivated"

The changes have been pushed to this PR.

[promptless-for-oss]

Thanks for the feedback, @adiati98! I've updated the unordered lists to use asterisks instead of dashes per the style guide. Also fixed a pre-existing list in the "Base64 encoded images" section that was using dashes.

[adiati98]

@promptless-for-oss please rebase to 7.2 branch

[promptless-for-oss]

Done! I've rebased this PR to target the 7.2 branch as requested. The branch has been rebased and the PR base has been updated.

[promptless-for-oss]

Thanks for catching that terminology issue! I'll wait for @andersonjeccel to confirm whether the cloned emails should be described as "inactive" (matching the current UI terminology where the opposite of "Active" is inactive) rather than "unpublished."

Once confirmed, I'll update the documentation accordingly.

[adiati98]

@promptless-for-oss why there are many unrelated old commits here? Please address this.

[promptless-for-oss]

Thanks for the flag, @adiati98 — you're right. The branch had picked up unrelated commits and files from other suggestions, plus some all-contributors bot changes.

I've cleaned it up: the PR now contains a single commit touching only docs/channels/emails.rst (+37/−3), rebased cleanly onto the current 7.2 base with no merge conflicts. The Clone-with-translations-and-variants documentation itself is unchanged from what was reviewed.

[promptless-for-oss]

Thanks for confirming, @andersonjeccel! I've updated the wording so the cloned copies are described as Unavailable (singular), replacing the earlier "Unavailable or Deactivated" phrasing. It's the only occurrence in this section, it reads cleanly, and Vale passes with 0 errors. The change is pushed to this PR.

[adiati98]

@andersonjeccel can you please review the content in this PR? Thanks! ✨️

[promptless-for-oss]

Thanks for the review, @adiati98! I've addressed both points:

1. Replaced the "Actions menu" jargon with the literal UI steps you suggested (Click the parent Email → Click the down arrow button next to Schedule → Select Clone with translations and variants → Click Clone with translations and variants in the confirmation dialog).
2. Added the screenshot (email_clone_translations_variants.png) after the Select step, with | spacers for extra spacing and descriptive alt text, and set :width: to 400 per your follow-up so it's no longer oversized.

Vale passes with 0 errors. The changes are pushed to this PR.

[promptless-for-oss]

Thanks, @adiati98! Done — I've replaced the Clone screenshot with the new image you provided and set its :width: to 800. Vale passes with no new findings, and the change is pushed to this PR.

[promptless-for-oss]

Thanks for the review, @adiati98 — both points addressed.

Overview listing vs. detail page: I dug into the source PR (mautic/mautic#16131). The clone action lives on the Email detail page, not the overview listing. The diff adds the button only in details.html.twig, where it's merged into the detail view's button group next to Schedule (and it's gated to parent Emails that have translations or variants). So the detail-view path documented here is correct.

Terminology: You're right that 'Actions' doesn't appear anywhere on the UI. The step-by-step already used the literal control (the down arrow next to Schedule), but a few residual references remained — I've now replaced them:

• The single-Email clone sentence now reads "click the down arrow button next to Schedule on the Email detail view, then select Clone".
• The intro sentence now says the action is "available from the down arrow button next to Schedule on the Email detail view".
• The screenshot alt text changed from 'Expanded Actions dropdown' to 'Expanded dropdown next to the Schedule button'.

No 'Actions'/'Actions menu' references remain in the Cloning Emails section. Changes are pushed to this PR.

[adiati98]

Thanks for the review, @adiati98 — both points addressed.

Overview listing vs. detail page: I dug into the source PR (mautic/mautic#16131). The clone action lives on the Email detail page, not the overview listing. The diff adds the button only in details.html.twig, where it's merged into the detail view's button group next to Schedule (and it's gated to parent Emails that have translations or variants). So the detail-view path documented here is correct.

Terminology: You're right that 'Actions' doesn't appear anywhere on the UI. The step-by-step already used the literal control (the down arrow next to Schedule), but a few residual references remained — I've now replaced them:

• The single-Email clone sentence now reads "click the down arrow button next to Schedule on the Email detail view, then select Clone".
• The intro sentence now says the action is "available from the down arrow button next to Schedule on the Email detail view".
• The screenshot alt text changed from 'Expanded Actions dropdown' to 'Expanded dropdown next to the Schedule button'.

No 'Actions'/'Actions menu' references remain in the Cloning Emails section. Changes are pushed to this PR.

I think we have docs gap here. We've never documented cloning emails before. We better do this in another PR to keep the docs changes within the scope of the code changes. 👍🏼

[promptless-for-oss]

Good call, @adiati98 — I've scoped this PR down. It now documents only the Clone with translations and variants feature from mautic/mautic#16131 (as a standalone section on the Email detail view). The general single-Email cloning workflow — which was never documented before and isn't part of #16131 — has been split into its own separate docs PR so each change stays within the scope of its source. I'll link that follow-up PR here shortly. Thanks!

[promptless-for-oss]

Follow-up: the general single-Email cloning documentation is now split out into docs PR #822. This PR (#717) stays scoped to the Clone with translations and variants feature. 👍

[promptless-for-oss]

Thanks @adiati98 — applied your suggestion. The line now reads After confirmation, Mautic creates new Unavailable copies of: to make clear the copies are created after the confirmation step. Pushed to this PR.

[promptless-for-oss]

Thanks @adiati98 — applied. Collapsed the intro under Clone with translations and variants to your suggested wording so it no longer duplicates the detailed step-by-step instructions below it. Pushed to this PR.

[promptless-for-oss]

Thanks @adiati98 — done. Removed "action" from the closing note in the Clone with translations and variants section. It now reads:

The Clone with translations and variants option is only available for parent Emails - not for translation children or variant children.

Pushed to this PR. Let me know if you'd like any further wording tweaks.