Skip to content

Document Clone with translations and variants feature for Emails#717

Open
promptless-for-oss wants to merge 4 commits into
mautic:7.2from
Promptless:promptless/clone-email-with-translations-variants
Open

Document Clone with translations and variants feature for Emails#717
promptless-for-oss wants to merge 4 commits into
mautic:7.2from
Promptless:promptless/clone-email-with-translations-variants

Conversation

@promptless-for-oss
Copy link
Copy Markdown

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


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

@promptless-for-oss promptless-for-oss requested a review from a team as a code owner May 18, 2026 16:45
@promptless-for-oss promptless-for-oss removed the request for review from a team May 18, 2026 16:45
Comment thread docs/channels/emails.rst Outdated
Clone with translations and variants
------------------------------------

If an Email has translations or A/B variants, it's possible to clone the entire group in one step using **Clone with translations and variants**. This action is available in the Email detail page actions menu for parent Emails that have at least one translation or variant.
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 feature from PR #16131 adds cloneWithTranslationsAction in EmailController.php that clones parent email with all translations and A/B variants. Button appears via details.html.twig for parent emails with hasTranslations() or hasVariants().

Source: mautic/mautic#16131

Copy link
Copy Markdown
Contributor

@adiati98 adiati98 left a comment

Choose a reason for hiding this comment

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

@promptless-for-oss please address the suggestions

Comment thread docs/channels/emails.rst Outdated
Comment thread docs/channels/emails.rst Outdated
Comment thread docs/channels/emails.rst Outdated
Comment thread docs/channels/emails.rst Outdated
@promptless-for-oss
Copy link
Copy Markdown
Author

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.

Comment thread docs/channels/emails.rst Outdated
@promptless-for-oss
Copy link
Copy Markdown
Author

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.

Comment thread docs/channels/emails.rst
#. Select **Clone with translations and variants**.
#. Confirm the action in the dialog.

Mautic creates new Unavailable or Deactivated copies of:
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

@andersonjeccel is the "Unavailable or Deactivated" here correct?

cc: @mautic/core-team for visibility.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

@escopecz can you please confirm this? TIA!

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

It should make the cloned emails unpublished. Now it's called Active in the UI. So we could say inactive?

@andersonjeccel please confirm

@adiati98
Copy link
Copy Markdown
Contributor

@promptless-for-oss please rebase to 7.2 branch

promptless Bot added 3 commits May 26, 2026 11:39
Add documentation for the new Email cloning action that allows
cloning an entire Email family (parent, translations, and A/B
variants) in one step. This feature is introduced in Mautic 7.
- Use 'Actions menu on the Email detail view' consistently
- Replace 'unpublished' with 'Unavailable or Deactivated' per Vale rules
Change dash-prefixed list items to asterisk-prefixed items in emails.rst
as requested in PR review feedback.
@promptless-for-oss promptless-for-oss force-pushed the promptless/clone-email-with-translations-variants branch from 6bae409 to 92ea403 Compare May 26, 2026 11:39
@promptless-for-oss promptless-for-oss requested review from a team and adiati98 May 26, 2026 11:39
@promptless-for-oss promptless-for-oss changed the base branch from 7.1 to 7.2 May 26, 2026 11:40
@promptless-for-oss
Copy link
Copy Markdown
Author

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
Copy link
Copy Markdown
Author

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants