Skip to content

Document Clone with translations and variants feature for Emails#717

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

Document Clone with translations and variants feature for Emails#717
promptless-for-oss wants to merge 2 commits into
mautic:7.1from
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 💬

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.
@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

.. vale on

To create a copy of a single Email, use the Clone action in the Email detail page actions menu.
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.

Suggested change
To create a copy of a single Email, use the Clone action in the Email detail page actions menu.
To create a copy of a single Email, use the Clone action in the Actions menu on the Email detail view.

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
Contributor

Choose a reason for hiding this comment

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

Suggested change
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.
If an Email has translations or A/B variants, cloning the entire group in one step is possible using **Clone with translations and variants**. This action is available in the Actions menu on the Email detail view for parent Emails that have at least one translation or variant.

Comment thread docs/channels/emails.rst Outdated

To clone an Email with its translations and variants:

#. Go to the Email detail page of the parent Email.
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.

Suggested change
#. Go to the Email detail page of the parent Email.
#. Go to the Email detail view of the parent Email.

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

Mautic creates new unpublished 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.

Vale gives warning here that we need to use 'Unavailable or Deactivated' instead of 'unpublished'.

- Use 'Actions menu on the Email detail view' consistently
- Replace 'unpublished' with 'Unavailable or Deactivated' per Vale rules
@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.

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.

2 participants