From d668b97ece4c015469f971340b975baac9527642 Mon Sep 17 00:00:00 2001 From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com> Date: Wed, 1 Oct 2025 17:33:05 +0200 Subject: [PATCH 1/6] feat(tem): merge pages --- menu/navigation.json | 12 +- .../how-to/add-mx-record-to-your-domain.mdx | 55 -------- .../add-spf-dkim-records-to-your-domain.mdx | 49 ------- .../how-to/authenticate-domain.mdx | 126 ++++++++++++++++++ 4 files changed, 128 insertions(+), 114 deletions(-) delete mode 100644 pages/transactional-email/how-to/add-mx-record-to-your-domain.mdx delete mode 100644 pages/transactional-email/how-to/add-spf-dkim-records-to-your-domain.mdx create mode 100644 pages/transactional-email/how-to/authenticate-domain.mdx diff --git a/menu/navigation.json b/menu/navigation.json index ff671d0799..d8eb1a23b2 100644 --- a/menu/navigation.json +++ b/menu/navigation.json @@ -3106,16 +3106,8 @@ "slug": "autoconfigure-domain" }, { - "label": "Add SPF and DKIM records to your domain", - "slug": "add-spf-dkim-records-to-your-domain" - }, - { - "label": "Add an MX record to your domain", - "slug": "add-mx-record-to-your-domain" - }, - { - "label": "Add a DMARC record to your domain", - "slug": "add-dmarc-record" + "label": "Authenticate your domain", + "slug": "authenticate-domain" }, { "label": "Set up BIMI for transactional emails", diff --git a/pages/transactional-email/how-to/add-mx-record-to-your-domain.mdx b/pages/transactional-email/how-to/add-mx-record-to-your-domain.mdx deleted file mode 100644 index 978b1965cc..0000000000 --- a/pages/transactional-email/how-to/add-mx-record-to-your-domain.mdx +++ /dev/null @@ -1,55 +0,0 @@ ---- -title: How to add an MX record to your domain -description: Step-by-step guide to adding an MX record to your domain for email routing. -tags: transactional mx-record domain -dates: - validation: 2025-04-08 - posted: 2023-09-13 ---- -import Requirements from '@macros/iam/requirements.mdx' - - -Setting up an [MX record](/transactional-email/concepts/#mx-record) ensures that your emails are delivered reliably. This page explains how to set up **your own MX record**, and how to set up Scaleway's blackhole MX if you do not have your own MX server. - - - - A Scaleway account logged into the [console](https://console.scaleway.com) - - A domain name - - [Configured your domain with Transactional Email](/transactional-email/how-to/configure-domain-with-transactional-email/) - - [Added SPF and DKIM records](/transactional-email/how-to/add-spf-dkim-records-to-your-domain/) to your domain - -## How to add your own MX record - - - We recommend you use your own MX server if you have one. If you do not have an MX server, we recommend you use Scaleway's blackhole MX, as it allows you to avoid email rejection. However, this also means that the emails sent back to the Scaleway blackhole MX, will be lost and unrecoverable. - - -1. Add an [MX record](/transactional-email/concepts/#mx-record) type in the root zone of your domain on your DNS zone. -2. Enter a name of your choice in the **Name** field. -3. Set `10` as a [priority](/transactional-email/concepts/#priority) for your MX record. - - Priority indicates the order in which your mail servers should be tried by a mail server that is attempting to deliver emails. - -4. Enter the name of your MX followed by a trailing dot in the **Hostname** field. -5. Save your changes. - -## How to add Scaleway's MX record - - - - Scaleway provides its own MX server to improve email deliverability.
However, Scaleway's MX server is a **blackhole**. This means that **any email sent back to it, will be lost with no possibility of recovery**. - - If you have no MX server, we recommend you use Scaleway's blackhole MX to avoid getting your emails rejected. - - -1. Add an [MX record](/transactional-email/concepts/#mx-record) type in the root zone of your domain on your DNS zone. -2. Enter a name of your choice in the **Name** field. -3. Set `10` as a [priority](/transactional-email/concepts/#priority) for your MX record. - - Priority indicates the order in which your mail servers should be tried by a mail server that is attempting to deliver emails. - -4. Enter `blackhole.tem.scaleway.com.` in the **Hostname** field. Make sure you add the trailing dot at the end of the value. -5. Save your changes. - - - Your changes might take up to 48 hours to apply. - - - diff --git a/pages/transactional-email/how-to/add-spf-dkim-records-to-your-domain.mdx b/pages/transactional-email/how-to/add-spf-dkim-records-to-your-domain.mdx deleted file mode 100644 index f3242902c9..0000000000 --- a/pages/transactional-email/how-to/add-spf-dkim-records-to-your-domain.mdx +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: How to add SPF and DKIM records to your domain -description: Instructions on adding SPF and DKIM records to secure your domain. -tags: spf spf-record dkim dkim-records transactional -dates: - validation: 2025-07-15 - posted: 2022-11-07 ---- -import Requirements from '@macros/iam/requirements.mdx' - -import image from './assets/scaleway_dkim_record_name.webp' -import image2 from './assets/scaleway_dkim_name_value.webp' - - -This page shows you how to set up [SPF](/transactional-email/concepts/#spf-record) and [DKIM](/transactional-email/concepts/#dkim-record) records to your domain to verify it. - -After you have configured your domain with Transactional Email, you are prompted to verify your domain by adding [SPF](/transactional-email/concepts/#spf-record), [DKIM](/transactional-email/concepts/#dkim-record), [DMARC](/transactional-email/how-to/add-dmarc-record) and [MX](/transactional-email/concepts/#mx-record). You can choose to do so right after you have validated your domain, or at a later time. - - - -- A Scaleway account logged into the [console](https://console.scaleway.com) -- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization -- A domain name -- [Configured your domain with Transactional Email](/transactional-email/how-to/configure-domain-with-transactional-email/) - -1. Click **Transactional Email** in the **Domains & Web Hosting** section of the [console](https://console.scaleway.com/) side menu. Your newly-added domain displays. -2. Click your domain. You are redirected to the SPF, DKIM, DMARC and MX configuration page. -3. Copy the value that applies to your case to add an SPF record. - - - If you have no SPF record on this domain, copy the following value: `v=spf1 include:_spf.tem.scaleway.com -all` - - If you already have configured an SPF record, copy the following value: `include:_spf.tem.scaleway.com` - - -4. Add a `TXT` record type in the root zone of your domain on your DNS zone. -5. Paste the value you have copied in the root zone of your domain. -6. Add an additional `TXT` record type in the root zone of your domain on your DNS zone. -7. Copy the name that displays in the console. - -8. Paste the name you have copied in the root zone of your domain on your DNS zone. -9. Copy the value that displays in the console and paste it in the root zone of your domain on your DNS zone. - -10. Add an [MX record](/transactional-email/how-to/add-mx-record-to-your-domain/). -11. Check the box "I have added these DNS records to my DNS zone" to confirm. -12. Click **Verify domain**. Your domain displays in the list of your domains. - - - - The verification of your domain might take up to 48 hours. - - Scaleway performs regular validity checks on your domain that can impact its validity. - \ No newline at end of file diff --git a/pages/transactional-email/how-to/authenticate-domain.mdx b/pages/transactional-email/how-to/authenticate-domain.mdx new file mode 100644 index 0000000000..aa3112ed2e --- /dev/null +++ b/pages/transactional-email/how-to/authenticate-domain.mdx @@ -0,0 +1,126 @@ +--- +title: How to authenticate your sending domain with Transactional Email +description: Guide to authenticating your domain for Scaleway Transactional Email. +tags: transactional sending-domain sending domain managed-services +dates: + validation: 2025-10-01 + posted: 2025-10-01 +--- +import Requirements from '@macros/iam/requirements.mdx' + + +This page shows you how to manually configure your sending domain's DNS records to authenticate the domain and start sending [transactional emails](/transactional-email/concepts/#transactional-email). + + + You can [set up autoconfiguration](/transactional-email/how-to/autoconfigure-domain) for your TEM domain. + + + + +- A Scaleway account logged into the [console](https://console.scaleway.com) +- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization +- [Configured a domain name](/transactional-email/how-to/configure-domain-with-transactional-email) for Transactional Email + +1. Click **Transactional Email** in the **Domains & Web Hosting** section of the [console](https://console.scaleway.com/) side menu. The **Transactional Email** overview page displays. +2. Click the name of the email domain you want to authenticate. The domain overview page displays. You can see the status of the DNS records. +3. Click the **DNS records** tab. + +On this tab you can configure: + - **SPF record** – Authorizes specific mail servers to send emails on behalf of your domain, preventing unauthorized use. + - **DKIM record** – Adds a digital signature to verify email integrity and confirms it was sent from your domain. + - **DMARC record** – Defines how receiving servers should handle authentication failures and enables reporting for your domain. + - **MX record** – Directs incoming emails to your mail server but is not involved in sending or authenticating outgoing emails. + +## How to configure SPF and DKIM records + +1. Scroll to the SPF, DKIM and DMARC records section. +2. Copy the value that applies to your case to add an SPF record. + + - If you have no SPF record on this domain, copy the following value: `v=spf1 include:_spf.tem.scaleway.com -all` + - If you already have configured an SPF record, copy the following value: `include:_spf.tem.scaleway.com` + + +3. Add a `TXT` record type in the root zone of your domain on your DNS zone. +4. Paste the value you have copied in the root zone of your domain. +5. Add an additional `TXT` record type in the root zone of your domain on your DNS zone. +6. Copy the name that displays in the console. + +7. Paste the name you have copied in the root zone of your domain on your DNS zone. +8. Copy the value that displays in the console and paste it in the root zone of your domain on your DNS zone. + +9. Add an [MX record](/transactional-email/how-to/add-mx-record-to-your-domain/). +10. Check the box "I have added these DNS records to my DNS zone" to confirm. +11. Click **Verify domain**. Your domain displays in the list of your domains. + + + - The verification of your domain might take up to 48 hours. + - Scaleway performs regular validity checks on your domain that can impact its validity. + + +## How to configure DMARC records + +1. Add a `TXT` record type in the same zone as your Transactional Email's domain, on your DNS zone. +2. Enter `_dmarc` in the **Name** field, followed by the domain name. For example, if your domain is called `my-domain.com`, you should have `_dmarc.my-domain.com.` in the **Name** field. +3. Enter your desired tags and their values in the **Value** section. Make sure that you add the mandatory `v` and `p` tags, and that you separate tags from each other with semi-colons. Find out about DMARC configuration in our [dedicated documentation](/transactional-email/reference-content/dmarc-configuration/). + Your **Value** field should look similar to the following + ``` + v=DMARC1; p=none; rua=mailto:your@email.com + ``` + + It is possible to configure several DMARC records for one domain, but they must have a different name to be valid. + For example, the `_dmarc.mydomain.com` and `_dmarc.tem.mydomain.com` DMARC records are valid. + +6. Confirm the changes and add the DMARC record. + + + If you have a domain at Scaleway Domains and DNS, you can access your account from the Scaleway [console](https://console.scaleway.com/), click **Domains and DNS** > **Your domain** > **DNS Zones**, then add a record in the same zone as your Transactional Email's domain. + + +### How to configure Scaleway's DMARC record + +1. Access your domain's **DNS Verification** tab and scroll down to the **DMARC record** section. +2. Copy the values that display in the **Name** and the **Value** fields. +3. Add a `TXT` record type in the same zone as your Transactional Email's domain, on your DNS zone. +4. In the **Name** field, paste the value you have copied in step 2, followed by the domain name. +5. In the **Value** field, paste the value you have copied in step 2. Your **Value** field should look like the following: + ``` + v=DMARC1; p=none; + ``` +6. Confirm the changes and add the DMARC record. + +## How to configure MX records + + + We recommend you use your own MX server if you have one. If you do not have an MX server, we recommend you use Scaleway's blackhole MX, as it allows you to avoid email rejection. However, this also means that the emails sent back to the Scaleway blackhole MX, will be lost and unrecoverable. + + +1. Add an [MX record](/transactional-email/concepts/#mx-record) type in the root zone of your domain on your DNS zone. +2. Enter a name of your choice in the **Name** field. +3. Set `10` as a [priority](/transactional-email/concepts/#priority) for your MX record. + + Priority indicates the order in which your mail servers should be tried by a mail server that is attempting to deliver emails. + +4. Enter the name of your MX followed by a trailing dot in the **Hostname** field. +5. Save your changes. + +### How to add Scaleway's MX record + + + - Scaleway provides its own MX server to improve email deliverability.
However, Scaleway's MX server is a **blackhole**. This means that **any email sent back to it, will be lost with no possibility of recovery**. + - If you have no MX server, we recommend you use Scaleway's blackhole MX to avoid getting your emails rejected. + + +1. Add an [MX record](/transactional-email/concepts/#mx-record) type in the root zone of your domain on your DNS zone. +2. Enter a name of your choice in the **Name** field. +3. Set `10` as a [priority](/transactional-email/concepts/#priority) for your MX record. + + Priority indicates the order in which your mail servers should be tried by a mail server that is attempting to deliver emails. + +4. Enter `blackhole.tem.scaleway.com.` in the **Hostname** field. Make sure you add the trailing dot at the end of the value. +5. Save your changes. + + + Your changes might take up to 48 hours to apply. + + + From 10746b66786399e33602f4efead9d0904ef502f7 Mon Sep 17 00:00:00 2001 From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com> Date: Wed, 1 Oct 2025 17:50:44 +0200 Subject: [PATCH 2/6] feat(tem): fix impory --- pages/transactional-email/how-to/authenticate-domain.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/pages/transactional-email/how-to/authenticate-domain.mdx b/pages/transactional-email/how-to/authenticate-domain.mdx index aa3112ed2e..6580fa36d3 100644 --- a/pages/transactional-email/how-to/authenticate-domain.mdx +++ b/pages/transactional-email/how-to/authenticate-domain.mdx @@ -8,6 +8,8 @@ dates: --- import Requirements from '@macros/iam/requirements.mdx' +import image from './assets/scaleway_dkim_record_name.webp' +import image2 from './assets/scaleway_dkim_name_value.webp' This page shows you how to manually configure your sending domain's DNS records to authenticate the domain and start sending [transactional emails](/transactional-email/concepts/#transactional-email). From e4d7e52287f65774195621891baba01ab9d4cfb9 Mon Sep 17 00:00:00 2001 From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com> Date: Mon, 6 Oct 2025 11:17:08 +0200 Subject: [PATCH 3/6] fix(tem): review jess Co-authored-by: Jessica <113192637+jcirinosclwy@users.noreply.github.com> Co-authored-by: Rowena Jones <36301604+RoRoJ@users.noreply.github.com> --- .../how-to/authenticate-domain.mdx | 20 +++++++++---------- 1 file changed, 9 insertions(+), 11 deletions(-) diff --git a/pages/transactional-email/how-to/authenticate-domain.mdx b/pages/transactional-email/how-to/authenticate-domain.mdx index 6580fa36d3..565b6acee2 100644 --- a/pages/transactional-email/how-to/authenticate-domain.mdx +++ b/pages/transactional-email/how-to/authenticate-domain.mdx @@ -27,7 +27,7 @@ This page shows you how to manually configure your sending domain's DNS records 2. Click the name of the email domain you want to authenticate. The domain overview page displays. You can see the status of the DNS records. 3. Click the **DNS records** tab. -On this tab you can configure: +On this tab, you can configure: - **SPF record** – Authorizes specific mail servers to send emails on behalf of your domain, preventing unauthorized use. - **DKIM record** – Adds a digital signature to verify email integrity and confirms it was sent from your domain. - **DMARC record** – Defines how receiving servers should handle authentication failures and enables reporting for your domain. @@ -44,7 +44,7 @@ On this tab you can configure: 3. Add a `TXT` record type in the root zone of your domain on your DNS zone. 4. Paste the value you have copied in the root zone of your domain. -5. Add an additional `TXT` record type in the root zone of your domain on your DNS zone. +5. Add another `TXT` record type in the root zone of your domain on your DNS zone. 6. Copy the name that displays in the console. 7. Paste the name you have copied in the root zone of your domain on your DNS zone. @@ -64,15 +64,15 @@ On this tab you can configure: 1. Add a `TXT` record type in the same zone as your Transactional Email's domain, on your DNS zone. 2. Enter `_dmarc` in the **Name** field, followed by the domain name. For example, if your domain is called `my-domain.com`, you should have `_dmarc.my-domain.com.` in the **Name** field. 3. Enter your desired tags and their values in the **Value** section. Make sure that you add the mandatory `v` and `p` tags, and that you separate tags from each other with semi-colons. Find out about DMARC configuration in our [dedicated documentation](/transactional-email/reference-content/dmarc-configuration/). - Your **Value** field should look similar to the following + Your **Value** field should look similar to the following: ``` v=DMARC1; p=none; rua=mailto:your@email.com ``` - It is possible to configure several DMARC records for one domain, but they must have a different name to be valid. + It is possible to configure several DMARC records for one domain, but they must have different names to be valid. For example, the `_dmarc.mydomain.com` and `_dmarc.tem.mydomain.com` DMARC records are valid. -6. Confirm the changes and add the DMARC record. +4. Confirm the changes and add the DMARC record. If you have a domain at Scaleway Domains and DNS, you can access your account from the Scaleway [console](https://console.scaleway.com/), click **Domains and DNS** > **Your domain** > **DNS Zones**, then add a record in the same zone as your Transactional Email's domain. @@ -83,8 +83,8 @@ On this tab you can configure: 1. Access your domain's **DNS Verification** tab and scroll down to the **DMARC record** section. 2. Copy the values that display in the **Name** and the **Value** fields. 3. Add a `TXT` record type in the same zone as your Transactional Email's domain, on your DNS zone. -4. In the **Name** field, paste the value you have copied in step 2, followed by the domain name. -5. In the **Value** field, paste the value you have copied in step 2. Your **Value** field should look like the following: +4. In the **Name** field, paste the value you copied in step 2, followed by the domain name. +5. In the **Value** field, paste the value you copied in step 2. Your **Value** field should look like the following: ``` v=DMARC1; p=none; ``` @@ -93,7 +93,7 @@ On this tab you can configure: ## How to configure MX records - We recommend you use your own MX server if you have one. If you do not have an MX server, we recommend you use Scaleway's blackhole MX, as it allows you to avoid email rejection. However, this also means that the emails sent back to the Scaleway blackhole MX, will be lost and unrecoverable. + We recommend you use your own MX server if you have one. If you do not have an MX server, we recommend you use Scaleway's blackhole MX, as it allows you to avoid email rejection. However, this also means that the emails sent back to the Scaleway blackhole MX will be lost and unrecoverable. 1. Add an [MX record](/transactional-email/concepts/#mx-record) type in the root zone of your domain on your DNS zone. @@ -108,7 +108,7 @@ On this tab you can configure: ### How to add Scaleway's MX record - - Scaleway provides its own MX server to improve email deliverability.
However, Scaleway's MX server is a **blackhole**. This means that **any email sent back to it, will be lost with no possibility of recovery**. + - Scaleway provides its own MX server to improve email deliverability.
However, Scaleway's MX server is a **blackhole**. This means that **any email sent back to it will be lost with no possibility of recovery**. - If you have no MX server, we recommend you use Scaleway's blackhole MX to avoid getting your emails rejected. @@ -124,5 +124,3 @@ On this tab you can configure: Your changes might take up to 48 hours to apply. - - From d975a88c732d5a6b0706527ff788257bcf855d70 Mon Sep 17 00:00:00 2001 From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com> Date: Mon, 6 Oct 2025 11:33:24 +0200 Subject: [PATCH 4/6] feat(tem): review jj --- .../how-to/authenticate-domain.mdx | 50 +++++++------------ 1 file changed, 18 insertions(+), 32 deletions(-) diff --git a/pages/transactional-email/how-to/authenticate-domain.mdx b/pages/transactional-email/how-to/authenticate-domain.mdx index 565b6acee2..29f0ed5496 100644 --- a/pages/transactional-email/how-to/authenticate-domain.mdx +++ b/pages/transactional-email/how-to/authenticate-domain.mdx @@ -7,8 +7,6 @@ dates: posted: 2025-10-01 --- import Requirements from '@macros/iam/requirements.mdx' - -import image from './assets/scaleway_dkim_record_name.webp' import image2 from './assets/scaleway_dkim_name_value.webp' This page shows you how to manually configure your sending domain's DNS records to authenticate the domain and start sending [transactional emails](/transactional-email/concepts/#transactional-email). @@ -33,10 +31,17 @@ On this tab, you can configure: - **DMARC record** – Defines how receiving servers should handle authentication failures and enables reporting for your domain. - **MX record** – Directs incoming emails to your mail server but is not involved in sending or authenticating outgoing emails. -## How to configure SPF and DKIM records + +Keep in mind that: + - The verification of your domain might take up to 48 hours. + - Scaleway performs regular validity checks on your domain that can impact its validity. + + +## How to configure SPF records 1. Scroll to the SPF, DKIM and DMARC records section. 2. Copy the value that applies to your case to add an SPF record. + - If you have no SPF record on this domain, copy the following value: `v=spf1 include:_spf.tem.scaleway.com -all` - If you already have configured an SPF record, copy the following value: `include:_spf.tem.scaleway.com` @@ -44,20 +49,17 @@ On this tab, you can configure: 3. Add a `TXT` record type in the root zone of your domain on your DNS zone. 4. Paste the value you have copied in the root zone of your domain. -5. Add another `TXT` record type in the root zone of your domain on your DNS zone. -6. Copy the name that displays in the console. - -7. Paste the name you have copied in the root zone of your domain on your DNS zone. -8. Copy the value that displays in the console and paste it in the root zone of your domain on your DNS zone. - -9. Add an [MX record](/transactional-email/how-to/add-mx-record-to-your-domain/). -10. Check the box "I have added these DNS records to my DNS zone" to confirm. -11. Click **Verify domain**. Your domain displays in the list of your domains. +5. Save your changes. - - - The verification of your domain might take up to 48 hours. - - Scaleway performs regular validity checks on your domain that can impact its validity. - +## How to configure DKIM records +1. Scroll to the SPF, DKIM and DMARC records section. +2. Copy the value that applies to your case to add an DKIM record. +3. Add a `TXT` record type in the root zone of your domain on your DNS zone. +4. Copy the name that displays in the console. +5. Paste the name you have copied in the root zone of your domain on your DNS zone. +6. Copy the value that displays in the console and paste it in the root zone of your domain on your DNS zone. + +7. Save your changes. ## How to configure DMARC records @@ -78,18 +80,6 @@ On this tab, you can configure: If you have a domain at Scaleway Domains and DNS, you can access your account from the Scaleway [console](https://console.scaleway.com/), click **Domains and DNS** > **Your domain** > **DNS Zones**, then add a record in the same zone as your Transactional Email's domain. -### How to configure Scaleway's DMARC record - -1. Access your domain's **DNS Verification** tab and scroll down to the **DMARC record** section. -2. Copy the values that display in the **Name** and the **Value** fields. -3. Add a `TXT` record type in the same zone as your Transactional Email's domain, on your DNS zone. -4. In the **Name** field, paste the value you copied in step 2, followed by the domain name. -5. In the **Value** field, paste the value you copied in step 2. Your **Value** field should look like the following: - ``` - v=DMARC1; p=none; - ``` -6. Confirm the changes and add the DMARC record. - ## How to configure MX records @@ -120,7 +110,3 @@ On this tab, you can configure: 4. Enter `blackhole.tem.scaleway.com.` in the **Hostname** field. Make sure you add the trailing dot at the end of the value. 5. Save your changes. - - - Your changes might take up to 48 hours to apply. - From 1346bbabd361ee216ab2fe2361d7a8eab028b72b Mon Sep 17 00:00:00 2001 From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com> Date: Tue, 7 Oct 2025 11:25:07 +0200 Subject: [PATCH 5/6] fix(tem): review jj Co-authored-by: jerjako --- .../how-to/authenticate-domain.mdx | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/pages/transactional-email/how-to/authenticate-domain.mdx b/pages/transactional-email/how-to/authenticate-domain.mdx index 29f0ed5496..b8ec8860f6 100644 --- a/pages/transactional-email/how-to/authenticate-domain.mdx +++ b/pages/transactional-email/how-to/authenticate-domain.mdx @@ -47,19 +47,18 @@ Keep in mind that: - If you already have configured an SPF record, copy the following value: `include:_spf.tem.scaleway.com` -3. Add a `TXT` record type in the root zone of your domain on your DNS zone. -4. Paste the value you have copied in the root zone of your domain. +3. Add a `TXT` record type in the same zone as your Transactional Email's domain, on your DNS zone. +4. Paste the value you have copied in the **Value** section. 5. Save your changes. ## How to configure DKIM records 1. Scroll to the SPF, DKIM and DMARC records section. 2. Copy the value that applies to your case to add an DKIM record. -3. Add a `TXT` record type in the root zone of your domain on your DNS zone. -4. Copy the name that displays in the console. -5. Paste the name you have copied in the root zone of your domain on your DNS zone. -6. Copy the value that displays in the console and paste it in the root zone of your domain on your DNS zone. +3. Add a `TXT` record type in the same zone as your Transactional Email's domain, on your DNS zone. +4. Copy the name that displays in the console and past it in the **Name** field. +5. Copy the value that displays in the console and paste it in the **Value** section. -7. Save your changes. +6. Save your changes. ## How to configure DMARC records From 73d98e7b808fe7f98190c59266ddcb1d0f398a0b Mon Sep 17 00:00:00 2001 From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com> Date: Tue, 7 Oct 2025 14:29:33 +0200 Subject: [PATCH 6/6] feat(tem): remove page after rebase --- .../how-to/add-dmarc-record.mdx | 52 ------------------- 1 file changed, 52 deletions(-) delete mode 100644 pages/transactional-email/how-to/add-dmarc-record.mdx diff --git a/pages/transactional-email/how-to/add-dmarc-record.mdx b/pages/transactional-email/how-to/add-dmarc-record.mdx deleted file mode 100644 index d0ecd98894..0000000000 --- a/pages/transactional-email/how-to/add-dmarc-record.mdx +++ /dev/null @@ -1,52 +0,0 @@ ---- -title: How to configure a DMARC record -description: This page explains how to configure a DMARC record -tags: spf spf-record dkim dkim-records dmarc dmarc-record transactional -dates: - validation: 2025-10-01 - posted: 2024-03-12 ---- -import Requirements from '@macros/iam/requirements.mdx' - - -This page shows you how to configure a basic [DMARC record](/transactional-email/concepts/#dmarc-record) on your domain. -If you have registered a domain at Scaleway Domains and DNS, you can still use this documentation, as the process is similar. -For more information about DMARC configuration and examples of DMARC records you can configure, refer to the [dedicated documentation](/transactional-email/reference-content/dmarc-configuration/). - - - -- A Scaleway account logged into the [console](https://console.scaleway.com/) -- A domain name -- [Configured your domain with Transactional Email](/transactional-email/how-to/configure-domain-with-transactional-email/). -- [Owner](/iam/concepts/#owner) status of the Organization in which the actions will be performed, or be an IAM user with the [necessary permissions](/iam/concepts/#permission). To follow this procedure you need `DomainsDNSFullAccess` and `TransactionalEmailDomainFullAccess` permissions. - -## How to configure a DMARC record - -1. Add a `TXT` record type in the same zone as your Transactional Email's domain, on your DNS zone. -2. Enter `_dmarc` in the **Name** field, followed by the domain name. For example, if your domain is called `my-domain.com`, you should have `_dmarc.my-domain.com.` in the **Name** field. -3. Enter your desired tags and their values in the **Value** section. Make sure that you add the mandatory `v` and `p` tags, and that you separate tags from each other with semi-colons. Find out about DMARC configuration in our [dedicated documentation](/transactional-email/reference-content/dmarc-configuration/). - Your **Value** field should look similar to the following - ``` - v=DMARC1; p=none; rua=mailto:your@email.com - ``` - - It is possible to configure several DMARC records for one domain, but they must have a different name to be valid. - For example, the `_dmarc.mydomain.com` and `_dmarc.tem.mydomain.com` DMARC records are valid. - -6. Confirm the changes and add the DMARC record. - - - If you have a domain at Scaleway Domains and DNS, you can access your account from the Scaleway [console](https://console.scaleway.com/), click **Domains and DNS** > **Your domain** > **DNS Zones**, then add a record in the same zone as your Transactional Email's domain. - - -## How to configure the Transactional Email DMARC record - -1. Access your domain's **DNS Verification** tab and scroll down to the **DMARC record** section. -2. Copy the values that display in the **Name** and the **Value** fields. -3. Add a `TXT` record type in the same zone as your Transactional Email's domain, on your DNS zone. -4. In the **Name** field, paste the value you have copied in step 2, followed by the domain name. -5. In the **Value** field, paste the value you have copied in step 2. Your **Value** field should look like the following: - ``` - v=DMARC1; p=none; - ``` -6. Confirm the changes and add the DMARC record. \ No newline at end of file