Skip to content

Conversation

luizvitorf
Copy link
Contributor

I have an instance named “DESKTOP-LUIZLIMA\SQL2022" and when I copy its name (SELECT @@ServerName) into the Database Mail Display Name field, the “\” character disappears when the email is sent. I was able to simulate this behavior and I've seen it happen in clients I work with as well.

DATABASEMAIL

Here is an example of the email:

image

When adjusting by including “\” the name appears correctly in the email.

image

Here is the correct email:

image

My suggestion would be to include something in this part of Database Mail talking about this slash “\” or other characters that may have a similar “disappearing” behavior.

https://learn.microsoft.com/en-us/sql/relational-databases/database-mail/configure-database-mail?view=sql-server-ver17

Also validate whether it is valid to insert it into the profile and account configuration pages, which also use the Display Name.

https://learn.microsoft.com/en-us/sql/relational-databases/database-mail/create-a-database-mail-profile?view=sql-server-ver17

https://learn.microsoft.com/en-us/sql/relational-databases/database-mail/create-a-database-mail-account?view=sql-server-ver17

I have an instance named “DESKTOP-LUIZLIMA\SQL2022" and when I copy its name (SELECT @@ServerName) into the Database Mail Display Name field, the “\” character disappears when the email is sent. I was able to simulate this behavior and I've seen it happen in clients I work with as well.
When adjusting by including “\\” the name appears correctly in the email.
My suggestion would be to include something in this part of Database Mail talking about this slash “\” or other characters that may have a similar “disappearing” behavior.

https://learn.microsoft.com/en-us/sql/relational-databases/database-mail/configure-database-mail?view=sql-server-ver17

Also validate whether it is valid to insert it into the profile and account configuration pages, which also use the Display Name.

https://learn.microsoft.com/en-us/sql/relational-databases/database-mail/create-a-database-mail-profile?view=sql-server-ver17

https://learn.microsoft.com/en-us/sql/relational-databases/database-mail/create-a-database-mail-account?view=sql-server-ver17
Copy link
Contributor

@luizvitorf : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

Copy link
Contributor

Learn Build status updates of commit 3786c05:

✅ Validation status: passed

File Status Preview URL Details
docs/relational-databases/database-mail/configure-database-mail.md ✅Succeeded

For more details, please refer to the build report.

@v-dirichards v-dirichards requested a review from Copilot October 13, 2025 20:33
@v-dirichards
Copy link
Contributor

@WilliamDAssafMSFT

Can you review the proposed changes?

Important: When the changes are ready for publication, adding a #sign-off comment is the best way to signal that the PR is ready for the review team to merge.

#label:"aq-pr-triaged"
@MicrosoftDocs/public-repo-pr-review-team

@prmerger-automator prmerger-automator bot added the aq-pr-triaged tracking label for the PR review team label Oct 13, 2025
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR addresses a documentation issue where the backslash character "" in Database Mail Display Names disappears in sent emails. The change adds a clarification to help users understand they need to escape backslashes by using "\" instead of a single "" to ensure proper display in email headers.

  • Adds documentation about backslash escaping requirement for Display Names

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

@WilliamDAssafMSFT
Copy link
Contributor

Thanks @luizvitorf for taking the time to submit this PR! This is a nice addition. Did some edits. Your commit will be merged and this article update is in flight. After the updated article is published, GitHub will list you as an article contributor.

Thanks again for this feedback, your suggestions help improve our documentation.

#sign-off

Copy link
Contributor

Learn Build status updates of commit d7af944:

✅ Validation status: passed

File Status Preview URL Details
docs/relational-databases/database-mail/configure-database-mail.md ✅Succeeded

For more details, please refer to the build report.

Copy link
Contributor

Learn Build status updates of commit 53a9b51:

✅ Validation status: passed

File Status Preview URL Details
docs/relational-databases/database-mail/configure-database-mail.md ✅Succeeded

For more details, please refer to the build report.

@WilliamDAssafMSFT
Copy link
Contributor

#sign-off

Copy link
Contributor

Learn Build status updates of commit 2a4a19a:

✅ Validation status: passed

File Status Preview URL Details
docs/relational-databases/database-mail/configure-database-mail.md ✅Succeeded

For more details, please refer to the build report.

@v-dirichards v-dirichards merged commit faaa7f3 into MicrosoftDocs:live Oct 14, 2025
2 checks passed
@luizvitorf
Copy link
Contributor Author

@WilliamDAssafMSFT, a doubt:

"GitHub will list you as an article contributor"

Where is the exact location that shows the article's contributors, would it be the one in the image below?

https://github.com/MicrosoftDocs/sql-docs/commits/live/docs/relational-databases/database-mail/configure-database-mail.md

GIT

I'm happy to contribute once again!

@WilliamDAssafMSFT
Copy link
Contributor

@luizvitorf correct

@luizvitorf
Copy link
Contributor Author

Ok, thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants