Adding LianaCMS domain to SendGrid

Depending on the installed features and built functionalities, LianaCMS can send emails in the following situations:

• Form submissions – notification to recipients and an optional confirmation message to the form filler
• User account management – activation and credentials messages to users, and password recovery messages
• Publication approval – notifications of pending publications and content changes
• Content notifications – notifications of new or modified news and events
• Comment moderation – notifications of new comments
   

LianaCMS uses the SendGrid service to send emails. For emails to be sent through SendGrid, the sender's email address domain must be authenticated in the SendGrid service. The authentication can be done in LianaCMS's settings.

1: Finding the Email Settings

Go to the installation's admin panel and click on “Settings” in the navigation list on the left side.

On the page that opens, find “Email Settings” and click the link.

The following site will open:

2: Adding the Domain to SendGrid

Under “Sender management,” you will find a list of the sender email addresses for emails sent by LianaCMS. The row where "Message purpose" reads "General" is the default sender email address. It is used as the message sender (the "From" field in the email) if no other more specifically set sender email address is found for the email.

If the email address domain has not yet been added or authenticated in the SendGrid service, you will see the following on the email address row:

Press the button “Add domain as authenticated sender in SendGrid”. This adds the domain to the SendGrid service.

If the domain has been added to the SendGrid service but has not yet been authenticated, you will see the DNS records required by SendGrid on the email address row:

 

Contact the domain administrator and ask them to make the mentioned changes to the DNS records. Once the domain's DNS changes have been made, return to this page. At this point, the authenication check is performed automatically. If SendGrid confirms the DNS changes, the domain will be authenticated, and the following will appear on the email address row:

You can now successfully send emails from LianaCMS.

3. Managing Denied Senders

If an email is sent from the LianaCMS installation when the sender's email address domain has not been authenticated in the SendGrid service, the sender is considered denied, and the email remains in the queue. Emails in the queue are displayed in their own section on the email settings page, if there are messages in the queue.

Above is an example of a situation where an email was attempted to be sent using a sender email address that has not been authenticated in SendGrid.

You can fix the situation by adding the listed email address domain to SendGrid using the guidance in section 2 and then pressing the “Try sending again” button. If this does not succeed, contact Liana support.