feat(mailbox): add email forwarding MTA-7512

pages/mailbox/concepts.mdx

@@ -57,6 +57,10 @@ A **domain name** or **domain** is a unique alphanumeric name used to identify a
 | `validation_failed`  | The domain failed the validation process.                                                                          |
 | `waiting_validation` | The domain is registered but not yet validated.                                                                    |
 
+## Email forwarding
+
+Email forwarding lets you automatically forward emails received in your Mailbox account to another email address, called a destination.
+
 ## Mailbox status
 
 |     Status name      |                                                     Description                                                      |

pages/mailbox/how-to/set-email-forwarding.mdx

@@ -0,0 +1,74 @@
+---
+title: Set email forwarding for a Mailbox email account
+description: This page explains how to set email forwarding for a Mailbox email account on the Scaleway console.
+tags: mailbox forwarding
+dates:
+  validation: 2026-10-30
+  posted: 2026-10-30
+---
+import Requirements from '@macros/iam/requirements.mdx'
+import BetaNoteMailbox from '@macros/mailbox/beta-note.mdx'
+
+<BetaNoteMailbox />
+
+Email forwarding lets you automatically forward emails received in your Mailbox account to another email address, called a destination.
+
+ This feature is useful to:
+  - **Centralize your emails**: receive emails from several accounts in a single inbox.
+  - **Use a different email client**: read your emails in the client of your choice.
+  - **Back up your emails**: keep a copy of each email in another account.
+
+<Message type="note">
+  In the current beta version of Mailbox, an email account is limited to 5 destinations.
+</Message>
+
+<Requirements />
+
+- A Scaleway account logged into the [console](https://console.scaleway.com)
+- [Owner](/iam/concepts/glossary/#owner) status or [IAM permissions](/iam/concepts/glossary/#permission) allowing you to perform actions in the intended Organization
+- [Configured your Mailbox domain](/mailbox/how-to/configure-mailbox/) with email accounts
+
+## Add a destination to a Mailbox email account
+
+1. Click **Mailbox** in the **Domains & Web Hosting** section of the [console](https://console.scaleway.com/) side menu. The list of your domains appears.
+2. Click the domain you wish to configure. The list of Mailboxes created for this domain appears.
+3. Click a Mailbox email account to configure. The Mailbox account information appears.
+4. Navigate to the **Forwarding** tab.
+5. Click **Add destination**.
+6. Enter the email address to use as a forwarding destination.
+7. Click **Add destination**.
+
+## Enable or disable email forwarding
+
+You can enable and disable email forwarding for all destinations set for a Mailbox email account.
+
+<Message type="note">
+  If you want to disable email forwarding for a specific destination, you must delete the destination.
+</Message>
+
+
+1. Click **Mailbox** in the **Domains & Web Hosting** section of the [console](https://console.scaleway.com/) side menu. The list of your domains appears.
+2. Click the domain you want to configure. The list of Mailboxes created for this domain appears.
+3. Click a Mailbox email account to configure. The Mailbox account information appears.
+4. Navigate to the **Forwarding** tab.
+5. In the **Email forwarding** section, click the **Forwarding** toggle to enable or disable email forwarding for all destinations.
+6. (Optional) Click the **Keep a copy in this mailbox** toggle to keep a copy of forwarded emails in the Mailbox email account. This option is disabled by default when email forwarding is enabled.
+
+## Edit a destination
+
+1. Click **Mailbox** in the **Domains & Web Hosting** section of the [console](https://console.scaleway.com/) side menu. The list of your domains appears.
+2. Click a Mailbox domain to configure. The list of Mailboxes created for this domain appears.
+3. Click a Mailbox email account to configure. The Mailbox account information appears.
+4. Navigate to the **Forwarding** tab.
+5. Click <Icon name="more" /> next to the destination you want to edit and select **Edit destination** from the dropdown. A dialog box appears.
+6. Enter the new email address to use as a forwarding destination.
+7. Click **Confirm**.
+
+## Delete a destination
+
+1. Click **Mailbox** in the **Domains & Web Hosting** section of the [console](https://console.scaleway.com/) side menu. The list of your domains appears.
+2. Click a Mailbox domain to configure. The list of Mailboxes created for this domain appears.
+3. Click a Mailbox email account to configure. The Mailbox account information appears.
+4. Navigate to the **Forwarding** tab.
+5. Click <Icon name="more" /> next to the destination you want to delete and select **Remove destination** from the dropdown. A dialog box appears.
+6. Click **Confirm**.

pages/mailbox/menu.ts

@@ -38,6 +38,10 @@ export const mailboxMenu = {
           label: 'Add an alias to a Mailbox email account',
           slug: 'add-alias',
         },
+        {
+          label: 'Set email forwarding',
+          slug: 'set-email-forwarding',
+        },
         {
           label: 'Delete a Mailbox email account',
           slug: 'delete-email-account',

pages/mailbox/reference-content/mailbox-capabilities-and-limits.mdx

@@ -18,6 +18,7 @@ This page provides information about the capabilities and limits of Scaleway Mai
 - Mailbox storage: up to 20 GB per mailbox (for emails, attachments, and mailbox folders).
 - Number of Mailboxes: 20 Mailbox email accounts per project (during Beta phase). If you need to create more mailboxes, contact [Scaleway Support](https://console.scaleway.com/support/tickets/create?for=product&productName=mailbox).
 - Number of aliases: 5 aliases per Mailbox email account (during Beta phase). If you need to create more aliases, contact [Scaleway Support](https://console.scaleway.com/support/tickets/create?for=product&productName=mailbox).
+- Number of email forwarding destinations: 5 destinations per Mailbox email account (during Beta phase). If you need to create more destinations, contact [Scaleway Support](https://console.scaleway.com/support/tickets/create?for=product&productName=mailbox).
 
 ## Message limits