User Email Notifications – Softr Help Docs

User email notifications refer to the transactional messages that are sent in a response to an action users take on an application. In order to ensure these messages are relevant to your app users, Softr allows you to edit email notification templates.

Softr currently supports the below scenarios:

Invite email via password

This email provides a temporary password for users added to the app by an app builder. The email can be sent at any time by the app builder and may be resent if necessary.

Learn how to add users manually.

Invite email via magic link

This email provides a special magic link for users added to the app by an app builder. The email can be sent at any time by the app builder and may be resent if necessary.

Learn how to import users manually.

Verification email

An email sent to allow users to obtain a code to sign in to this app. This email will be automatically triggered when a user requests a login code via the sign-in page.

A Sign in with Email Code block must be used to enable this option.

Forgot password email

An email sent to allow users to reset their password when they have forgotten it. This email will be automatically triggered when a user requests a password reset via the sign-in page.

Make sure you have added Forgot Password Form and Reset Password Form blocks to your app.

Editing notification templates

To edit notification templates, click on the Notifications tab in the Users Menu of Softr Studio. Here you’ll be able to see each of the above notification templates. Click into a template to begin editing.

From here, you can change the subject line, adjust the content of the email, and leverage the power of variables.

Variables

Variables are dynamic inputs to your message. They are defined by user and application level data points. For example, the variable @user_name is a user level attribute and will populate as the notification recipient’s name when the email is delivered.

To insert a variable simply start typing ‘@’ and a list of optional variables will appear. You can also click and hold to drag and drop variables already added.

Required variables

Each template has a unique list of required variables. Required variables are critical pieces of information required in each scenario. For example @login_code is required for the Verification email notification. Without it app users would not be able to sign in.

💡

To avoid errors when editing templates, we prevent you from removing required variables.

Optional variables

Optional variables can be added to any email template. Leverage optional variables to personalize your messages, making them more relevant for your users. You have the option to add and remove optional variables.

List of variables

Invite email via password

Variable Name	Required
@user_email	Yes
@password	Yes
@application_hyperlink	Yes
@application_name	No
@application_domain	No
@application_owner	No
@user_name	No

Invite email via magic link

Variable Name	Required
@magic_link	Yes
@application_hyperlink	No
@application_name	No
@application_domain	No
@application_owner	No
@user_email	No
@user_name	No

Forgot password email

Variable Name	Required
@reset_password_link	Yes
@application_hyperlink	No
@application_name	No
@application_domain	No
@application_owner	No
@user_email	No
@user_name	No

Sign in with code

Variable Name	Required
@login_code	Yes
@application_hyperlink	No
@application_name	No
@application_domain	No
@application_owner	No
@user_email	No
@user_name	No

Sender details

You can customize the sender details for your email notifications. To edit Sender Details, click on the Notifications tab in the Users Menu of Softr Studio. Here, you can provide a sender name and email address. The email address does not need to have an actual Inbox, however you should ensure any replies sent to it are forwarded or handled appropriately so you can verify it. Alias emails will still work.

💡

NOTE: You cannot use a public email domain. Email service providers restrict this to reduce security risks, such as phishing. You can only send from emails with custom domains.

Once you have entered the name and email you want to send from, you will get an email from our service provider, Postmark, asking you to verify email to enable sending from it. Be sure to click the verification button/link in the Postmark email. Come back to Softr to check that it has been verified. You can always click the Refresh button to re-check.

DKIM Authentication

(optional)

Ensuring that transactional emails from Softr apps reach their intended recipients is crucial for maintaining user engagement and satisfaction. Unfortunately, these emails can sometimes be blocked or end up in spam folders, leading to frustration and additional support overhead. Verifying the Sender Details (like in the step above) is a good first step, but by implementing DKIM (DomainKeys Identified Mail) verification, we can significantly improve email deliverability. This guide will walk you through the process of setting up DKIM for your domain to ensure consistent, reliable email delivery.

Setup

After setting your custom sender details, the DKIM setup option will become available. Clicking on the Verify button will open a popup modal showing you the DKIM records that need to be added to your DNS.

Requesting a DKIM record

Open the DKIM setup modal. Softr will generate and return a DKIM record for your domain.

Adding the DKIM record to tour DNS provider

Add the provided DKIM record to your DNS provider. This step is crucial for enabling DKIM for your domain. Below are general instructions for adding DKIM records to various DNS providers:

GoDaddy:

Go to the DNS management page for your domain.

Click "Add" and select "TXT" as the record type.

In the "Name" field, enter the host name provided in your DKIM record.

In the "Value" field, enter the value provided in your DKIM record.

Save the changes.

Cloudflare:

Select your domain.

Go to the "DNS" tab.

Click "Add record" and select "TXT" as the record type.

Enter the host name and value provided in your DKIM record.

Save the changes.

AWS Route 53:

Open the Route 53 console.

Select the hosted zone for your domain.

Click "Create record set."

Select "TXT - Text" as the record type.

Enter the host name and value provided in your DKIM record.

Save the changes.

Google Domains:

Select your domain.

Click on the "DNS" tab.

In the "Custom resource records" section, click "Add."

Select "TXT" as the record type.

Enter the host name and value provided in your DKIM record.

Save the changes.

Namecheap:

Select "Domain List" from the left sidebar and click "Manage" next to your domain.

Navigate to the "Advanced DNS" tab.

Click "Add New Record" and select "TXT Record" as the type.

Enter the host name and value provided in your DKIM record.

Save the changes.

Verifying the DKIM record

Click the "Verify" button to check the status. Note that DNS changes can take up to 24 hours to come into effect.

Once verified, Softr will automatically start signing emails with DKIM for your domain.

Benefits of DKIM

Improved deliverability: DKIM ensures that your emails are less likely to be marked as spam or blocked.

Enhanced security: DKIM helps verify that your emails are indeed from your domain, reducing the risk of phishing attacks.

Consistency: Automating DKIM setup through Postmark's API saves time and ensures reliable email delivery.