Skip to content

Add SimploMail Domain Connect email template#910

Open
simplyi wants to merge 8 commits intoDomain-Connect:masterfrom
simplyi:add-simplomail-template
Open

Add SimploMail Domain Connect email template#910
simplyi wants to merge 8 commits intoDomain-Connect:masterfrom
simplyi:add-simplomail-template

Conversation

@simplyi
Copy link
Copy Markdown

@simplyi simplyi commented Mar 27, 2026

Description

Update the SimploMail Domain Connect template for email sending to use the synchronous flow.

This template configures:

  • Amazon SES Easy DKIM using 3 CNAME records
  • SPF using SPFM
  • DMARC with p=none
  • Custom MAIL FROM using SES MX + SPF

This update changes the template from async-only behavior to synchronous behavior by:

  • setting syncBlock to false
  • adding syncPubKeyDomain
  • adding syncRedirectDomain

This update also removes the rua email address from the DMARC record, so the DMARC value is now simply v=DMARC1; p=none;.

Type of change

  • New template
  • Bug fix (non-breaking change which fixes an issue in the template)
  • New feature (non-breaking change which adds functionality to the template)
  • Breaking change (fix or feature that would cause existing template behavior to be not backward compatible)

How Has This Been Tested?

Checklist of common problems

  • syncPubKeyDomain is set
  • warnPhishing is not set alongside syncPubKeyDomain
  • syncRedirectDomain is set whenever the template uses redirect_uri in the synchronous flow
  • no TXT record contains SPF content ("v=spf1 ...") — use the SPFM record type instead
  • txtConflictMatchingMode is set on every TXT record that must be unique per label or content prefix (e.g. DMARC)
  • no variable is used as a bare full record value (e.g. @ TXT "%foo%") unless necessary
  • no bare variable is used as the full host label — the non-variable parts are fixed to limit misuse
  • no variable is used in the host field to create a subdomain — use the host parameter or multiInstance instead
  • %host% does not appear explicitly in any host attribute
  • essential is set to OnApply on records the end user may need to modify or remove without breaking the template (e.g. DMARC)

Online Editor test results

Editor test link(s):

@github-actions github-actions bot added PR description incomplete The PR description template was not filled in at all, altered or filled in improperly. no syncPubKeyDomain syncPubKeyDomain not set. Template is not secured. Test links missing No test links from Online Editor provided warnPhishing warnPhishing is set. Template is not secured. labels Mar 27, 2026
@github-actions
Copy link
Copy Markdown

github-actions bot commented Mar 27, 2026

JSON Filename Check Passed

@github-actions
Copy link
Copy Markdown

github-actions bot commented Mar 27, 2026

JSON Schema Validation Passed

@github-actions
Copy link
Copy Markdown

github-actions bot commented Mar 27, 2026

Linter OK

simplomail.com.email.json

Level Code Note

@github-actions github-actions bot added syncBlock syncBlock is set for the template and removed no syncPubKeyDomain syncPubKeyDomain not set. Template is not secured. warnPhishing warnPhishing is set. Template is not secured. labels Mar 27, 2026
@github-actions github-actions bot removed the PR description incomplete The PR description template was not filled in at all, altered or filled in improperly. label Mar 27, 2026
@github-actions github-actions bot removed the Test links missing No test links from Online Editor provided label Mar 27, 2026
@simplyi
Copy link
Copy Markdown
Author

simplyi commented Mar 27, 2026

All checks are passing now. This PR is ready for review.

@pawel-kow pawel-kow enabled auto-merge March 27, 2026 14:05
"description": "Configure your domain for email sending with SimploMail. Sets up DKIM, SPF, DMARC, and custom MAIL FROM for improved deliverability.",
"variableDescription": "%dkimToken1%: First DKIM token; %dkimToken2%: Second DKIM token; %dkimToken3%: Third DKIM token; %region%: AWS SES region",
"warnPhishing": true,
"syncBlock": true,
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

are you super sure about syncBlock?
Are you in contact with DNS providers which will onboard the template for async flow?

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

No. I am not very sure about the syncBlock. The reason I chose to go with it is because it sounded simpler to start. Since it is my first time doing this, I wanted to start small with an easy integration. And then, expand. syncBlock sounded much easier to go with. I am not in touch with DNS providers yet because it is my understanding that the first step is to prepare the template, and only then contact providers to onboard it. I trust you have much more experience with this than I do. If you think that going with async will be more problematic than going with sync, then I will go with the sync approach and will update this template.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

No. I am not very sure about the syncBlock. The reason I chose to go with it is because it sounded simpler to start. Since it is my first time doing this, I wanted to start small with an easy integration.

syncBlock = you are left with async flow. This one is way more complex than sync.

And then, expand. syncBlock sounded much easier to go with. I am not in touch with DNS providers yet because it is my understanding that the first step is to prepare the template, and only then contact providers to onboard it. I trust you have much more experience with this than I do. If you think that going with async will be more problematic than going with sync, then I will go with the sync approach and will update this template.

Yes, you will be better off with sync. Use signature though.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Alright, thank you 👍🏻. I will update it to use the sync flow instead.

auto-merge was automatically disabled March 30, 2026 12:12

Pull Request is not mergeable

@github-actions github-actions bot added warnPhishing warnPhishing is set. Template is not secured. Test links missing No test links from Online Editor provided and removed syncBlock syncBlock is set for the template labels Apr 6, 2026
@simplyi simplyi force-pushed the add-simplomail-template branch from afad0c3 to a5e77b3 Compare April 6, 2026 19:37
@github-actions github-actions bot removed the Test links missing No test links from Online Editor provided label Apr 6, 2026
@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 6, 2026

PR Description Check Passed

All required sections are filled in correctly.

Details
  OK  Type of change: 1/4 checkboxes ticked
  OK  How Has This Been Tested?: all 3 checkboxes ticked
  OK  Checklist of common problems: 10/10 checkboxes ticked
  OK  Online Editor test results: 2 link(s) found
  OK  Template coverage: all 1 template(s) covered
Labels to remove: Checklist of common problems not complete, Forged editor links, PR description incomplete, Test links missing

PR description check PASSED

@github-actions github-actions bot removed the warnPhishing warnPhishing is set. Template is not secured. label Apr 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants