Skip to content

Conversation

ldecarvalho-doc
Copy link
Contributor

No description provided.

@ldecarvalho-doc ldecarvalho-doc self-assigned this Oct 1, 2025
@ldecarvalho-doc ldecarvalho-doc added type: maintenance Improvements or additions to documentation status: tech review Waiting for technical review priority: medium Maintenance PRs to fix several visible mistakes status: doc review Waiting for doc team review do not merge PR that shouldn't be merged before a specific date (eg release) labels Oct 1, 2025
Comment on lines +53 to +55
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.
Copy link
Contributor

Choose a reason for hiding this comment

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

the lines 9, 10 and 11 should be in a separate last section or just removed

- **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
Copy link
Contributor

Choose a reason for hiding this comment

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

Having SPF and DKIM in one section. And DMARC in another could be improved.

  • SPF need some "logic" (add an include in the right place)
  • DMARC needs also some logic
  • But DKIM is just a copy / paste in a unique dns record name.

Separate all of them may help people in case of error on one particular record

Comment on lines +81 to +91
### 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.
Copy link
Contributor

Choose a reason for hiding this comment

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

IMO, this 2nd section of the same title "How to configure Scaleway's DMARC record" could be removed

v=DMARC1; p=none; rua=mailto:[email protected]
```
<Message type="important">
It is possible to configure several DMARC records for one domain, but they must have a different name to be valid.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
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.

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.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
4. In the **Name** field, paste the value you have copied in step 2, followed by the domain name.
4. In the **Name** field, paste the value you copied in step 2, followed by the domain name.

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:
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
5. In the **Value** field, paste the value you have copied in step 2. Your **Value** field should look like the following:
5. In the **Value** field, paste the value you copied in step 2. Your **Value** field should look like the following:

## How to configure MX records

<Message type="important">
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.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
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.

### How to add Scaleway's MX record

<Message type="important">
- Scaleway provides its own MX server to improve email deliverability. <br /> 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**.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
- Scaleway provides its own MX server to improve email deliverability. <br /> 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. <br /> 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**.

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:
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
On this tab you can configure:
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.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
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.

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
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Your **Value** field should look similar to the following
Your **Value** field should look similar to the following:

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.
</Message>
6. Confirm the changes and add the DMARC record.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
6. Confirm the changes and add the DMARC record.
4. Confirm the changes and add the DMARC record.

Comment on lines +127 to +128


Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
do not merge PR that shouldn't be merged before a specific date (eg release) priority: medium Maintenance PRs to fix several visible mistakes status: doc review Waiting for doc team review status: tech review Waiting for technical review type: maintenance Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants