# Forward Email

> `UiPath.Mail.Activities.Business.ForwardMailX`

`UiPath.Mail.Activities.Business.ForwardMailX`

:::important
The new version of the Outlook application impacts this activity. For more details, check [New Outlook impact on UiPath Outlook Desktop activities](https://docs.uipath.com/activities/other/latest/productivity/new-outlook-impacts-outlook-desktop-activities#new-outlook-impact-on-uipath-outlook-desktop-activities).
:::

Forwards the specified email or invite. Should be used for the email or invite currently selected in the Outlook desktop app, or in a [For Each Email](https://docs.uipath.com/activities/other/latest/productivity/for-each-email-x) activity when iterating through Gmail or Outlook emails. This activity must be added inside a [Use Outlook 365](https://docs.uipath.com/activities/other/latest/productivity/exchange-application-card), [Use Gmail](https://docs.uipath.com/activities/other/latest/productivity/gmail-application-card), or [Use Desktop Outlook App](https://docs.uipath.com/activities/other/latest/productivity/outlook-application-card) activity.

:::important
HTML emails may not look as expected when using the [Use Desktop Outlook App](https://docs.uipath.com/activities/other/latest/productivity/outlook-application-card) activity. Using a Word document for the **Body** is recommended.
:::

## Configuring the activity

#### In the body of the activity

* **Email** - Select **Plus** on the right side of the field and then, from the menu, select the email to forward. When the activity is inside a **For Each Email** activity, select **CurrentMail** to indicate the current mail in the iteration. When automating the Outlook desktop app, you can also select **Selected Mail** to use the message that is selected in Outlook when the project is executed. Alternatively, you can select **Open in Advanced Editor** and enter a VB expression.
* **Add To recipients** - Select **Plus** on the right side of the field, and then use one of the options in the menu to select where to forward the email:

  + Data from the Project Notebook, a parent Excel file or email account. For example, you can select a cell in an Excel file that contains email addresses separated by semicolon (\;) to add multiple recipients, or, when automating the Outlook desktop app, use the email addresses from the **To** field of the email selected in Outlook when the project is executed.
  + **Use Saved Value** - Use data in the form of a list of email addresses that you previously saved for later use in the project.
  + **Text** - Enter one or more email addresses separated by semicolon (\;) in the Text Builder.
  + **Ask when run** - Prompt for the recipients when the project is executed.
  + **Paste from clipboard** - Paste an email address that you previously copied to the clipboard in the project.
  + **Open in Advanced Editor** - Enter a VB expression.
* **Add Cc recipients** - Select **Plus** on the right side of the field, and then use one of the options in the menu to select the secondary recipients of the email:

  + Data from the Project Notebook, a parent Excel file or email account. For example, you can select a cell in Excel with email addresses separated by semicolon (\;) to add multiple recipients, or, when automating the Outlook desktop app, use the email addresses from the **Cc** field of the email selected in Outlook when the project is executed.
  + **Use Saved Value** - Use data in the form of a list of email addresses that you previously saved for later use in the project.
  + **Text** - Enter one or more email addresses separated by semicolon (\;) in the Text Builder.
  + **Ask when run** - Prompt for the recipients when the project is executed.
  + **Paste from clipboard** - Paste an email address that you previously copied to the clipboard in the project.
  + **Open in Advanced Editor** - Enter a VB expression.
* **New subject** - Optionally, you can add a new subject for the email. If a new subject is not provided, the default Outlook subject for forwarded emails is used. Select **Plus** on the right side of the field and then use one of the options in the menu to add a subject for the email:

  + Data from the Project Notebook, a parent Excel file or email account. For example, you can select a cell in an Excel file, or, when automating the Outlook desktop app, you can use the subject of the of the email selected in Outlook when the project is executed.
  + **Use Saved Value** - Use data that you previously saved for later use in the project.
  + **Text** - Enter a subject in the Text Builder.
  + **Ask when run** - Prompt for the subject when the project is executed.
  + **Paste from clipboard** - Paste a value that you previously copied to the clipboard in the project.
  + **Open in Advanced Editor** - Enter a VB expression.
* **Body** - You can add a plain text body, use HTML, or select a Word document to add the file in the email body.
  * If you select **HTML**, select **Open Editor** to start drafting your email using the WYSIWYG HTML editor.
  * If you select **Text**, select **Plus** on the right side of the field, and then select one of the options from the menu to add the text for the body of the email:

    - Data from the Project Notebook, a parent Excel file or email account.
    - **Use Saved Value** - Use data that you previously saved for later use in the project.
    - **Text** - Enter the body text in the Text Builder.
    - **Ask when run** - Prompt for the body text when the project is executed.
    - **Paste from clipboard** - Paste a value that you previously copied to the clipboard in the project.
    - **Open in Advanced Editor** - Enter a VB expression.
  * If you select **Use Word Document**, indicate a Word document with tables, images. text formatting to add in the body. The email body is formatted as HTML.

  Select **Browse** next to the field, and then browse to a Word file and select it. Alternatively, you can indicate the path to a Word file by selecting an option from the **Plus** menu on the right side of the field:
      * Data from the Project Notebook, a parent Excel file or email account. For example, you can select a cell in an Excel file that contains a path.
      * **Use Saved Value** - Use data in the form of a file path that you previously saved for later use in the project.
      * **Text** - Enter a path in the Text Builder.
      * **Ask when run** - Prompt for the path when the project is executed.
      * **Paste from clipboard** - Paste a value that you previously copied to the clipboard in the project.
      * **Open in Advanced Editor** - Enter a VB expression.
      
      :::note
      * The option **Use Word Document** can only be used with the Outlook desktop app.
      * If the Word document you select contains pictures, some of the pictures may not appear in the body of the email that is sent. If a picture fails to appear in the email body, try one of the following workarounds:
      + Open the Word document, remove the picture, and then add the picture again.
      + Change the extension of the Word document to `.zip`, extract the archive, open the file **document.xml** located in the folder **word**, search for the attribute **r:link**, and remove it (for example, `r:link="rId11"`). Save the file, then zip the extracted files again and change the extension back to .`docx`.
      :::
  + **Save as draft** - If selected, the email is saved in the Drafts folder instead of being sent directly to the selected recipients, giving you a chance to check the email before sending it. This option is selected by default.
* **Attachments** - Select **Files** to attach individual files or **Folder** to attach all the files in a folder. To select the file or folder, select **Browse** ![](https://dev-assets.cms.uipath.com/assets/images/activities/activities-image-browse_files-1431ef7d.png) next to the field, and then browse to the file or folder and select it. Alternatively, you can indicate a file or folder path by selecting an option from the **Plus** menu on the right side of the field:

  + Data from the Project Notebook, a parent Excel file or email account. For example, you can select a cell in an Excel file that contains a path.
  + **Use Saved Value** - Use data in the form of a path that you previously saved for later use in the project.
  + **Text** - Enter a path in the Text Builder. You can combine text with a formula from an Excel file cell, for example to add a date to the file name using formulas in the Project Notebook.
  + **Ask when run** - Prompt for the path when the project is executed.
  + **Paste from clipboard** - Paste a value in the form of a path that you previously copied to the clipboard in the project.
  + **Open in Advanced Editor** - Enter a VB expression.

#### Properties panel

**Common**

* **DisplayName** - The name displayed for the activity in the Designer panel.

**Email**

* **Body** - The plain text body of the email, if **Text** is selected as the body type.
* **Body document path** - The path to the Word document to use as the body of the email, if **WordDocument** is selected as the body type.
* **New subject** - See **New subject** in the body of the activity.

**Input**

* **Email** - See **Email** in the body of the activity.

**Misc**

* **Private** - If selected, the values of variables and arguments are no longer logged at Verbose level.

**Options**

* **Body type** - See **Body** in the body of the activity.
* **HTML body from file** - Specifies the HTML body of the email created using the HTML editor.
* **HTML Template** - Document which stores the HTML template. When blank, a new template will automatically be created when you use the editor.
* **HTML body from text** - Specifies the HTML body of the email loaded from a different source and saved as text.
* **Max body document size** - The maximum size (in MB) a Word document can have to be used as the email body. The default value is 2MB.
* **Save as draft** - See **Save as draft** in the body of the activity.

**Receiver**

* **Add Bcc recipients** - Add hidden recipients of the email in a similar way to how you add **To** and **Cc** recipients.
* **Add Cc recipients** - See **Add Cc recipients** in the body of the activity.
* **Add To recipients** - See **Add To recipients** in the body of the activity.

**Sender**

* **Sent on behalf of** - Another user with access to the mailbox on behalf of whom to send the message. Indicate the user in a similar way to how you indicate a To or Cc recipient.