Email Newsletter
Updated 04-14-26 - V: 1.0.0
Ubaid A
Last Update pred 2 mesecema
This article explains how to create email templates, schedule newsletter send-outs, manage recipient lists, and track delivery using the Email Newsletter app in FXMedSupport.
The Email Newsletter app lets you design professional email templates using a drag-and-drop builder and schedule them to be sent to your patients or custom email lists at a specific date and time. You can target recipients by patient conditions, a saved email list, or a combination of both — making it a powerful tool for patient outreach, promotions, and practice updates.
What It Supports
• Layout options: 2 columns, 3 columns, and 4 columns
• Configuration panel: size, padding, width, height, mobile width, and background image settings
• Source code editing: JSON source and MJML source
• Template filters: All Templates, Premium Templates, and Email Community Templates
• Schedule newsletter send-outs with a specific date and time
• Template selection from saved templates or PDF file attachment
• Recipient targeting: Patient Conditions, Saved Email List, or Both (List + Patient Conditions)
• Email type selection: Email 1 (primary), Email 2 (secondary), or Both
• Patient condition builder with condition types: Gender, Age, and more
• Save and load condition groups for reuse
• Saved Email Lists management: upload CSV, view/edit lists, remove individual recipients
• Scheduled Message Send Outs List showing Time To Send (UTC), Subject, Status, and Action
Before You Begin
• You are logged in with a user account that has access to the Email Newsletter app
• You have a newsletter template ready, or you will create one in the Template Builder
• If sending to a saved email list, your CSV file (First Name, Last Name, Email) is prepared and ready to upload
• Patient email addresses (Email 1 and/or Email 2) are updated in their Cerbo patient records
Step 1: Open the FXMedSupport Widget
1. On the right side of the Cerbo screen, click the FXMedSupport circular icon to open the widget.

Step 2: Open the Email Newsletter App
2. Scroll to the Communication section.
3. Locate and click Email/Newsletter.

Step 3: Browse and Manage Templates


• Create New Template — starts a blank template in the Template Builder
• All Templates — shows all templates you have created
• Premium Templates — shows premium templates available to your account
• Email Community Template — shows community-shared templates
3. Scroll down to view FxMedSupport Newsletters, which are pre-built newsletters created by the FXMedSupport team that you can use directly.
4. Click any template thumbnail to preview or open it.
Step 4: Create a New Template in the Template Builder

3. The builder has three panels:
• Left panel — Content blocks and Layout options
• Center panel — Live canvas preview of your email
• Right panel — Configuration or Source code settings
Content Blocks (left panel):
4. Drag any of the following blocks from the left panel onto the canvas:
• Text — adds a text block for body copy
• Image — adds an image block (upload or link an image)
• Button — adds a clickable button
• Social — adds social media links (Facebook, Google, Twitter)
• Divider — adds a horizontal divider line
• Spacer — adds vertical spacing
• Hero — adds a full-width hero/banner section
• Wrapper — adds a container wrapper around other blocks

5. Under the Layout section, choose a column structure to add to the canvas:
• 2 columns — two equal content areas side by side
• 3 columns — three equal content areas
• 4 columns — four equal content areas
6. Once a layout is added, drag content blocks into each column's "Drop a content block here" area.

7. Click any block on the canvas to select it. The right panel will show that block's settings:
• Dimension: set width, height, and full width
• Padding: set top, bottom, left, and right padding in pixels
• Background: upload a background image
• Social attributes: set mode (vertical or horizontal) and alignment (left, center, right)
• Typography: set font family, font size, font weight, and line height
Source Code (right panel, Source code tab):
8. Click the Source code tab on the right panel to edit the template directly in code:
• Json source — edit the template structure in JSON format
• MJML source — edit the template in MJML markup language
Preview modes (center top toolbar):
9. Use the device icons in the center toolbar to preview the template on desktop, tablet, or mobile views.
10. Use the undo and redo arrows in the toolbar to reverse or reapply changes.
11. When finished, click Save at the top right to save your template.
12. Click Back to return to the Templates list. Your new template will appear in the All Templates section under the tag name you assigned.

ℹ️ Info: Templates are sorted by creation date with the newest appearing first. The tag name you give the template during creation is used as its display name in the Templates List and in the Select Template dropdown on the Schedule Newsletter screen.
💡 Tip: Use the Layer tab (next to Block in the left panel) to view and manage the layer structure of your email, which is helpful when working with nested sections and complex layouts.
Step 5: Schedule a Newsletter
2. The Schedule Shipping Newsletter screen will open with a Template Builder button in the top right corner (this is a shortcut to open the Template Builder if you need to create or edit a template).
Date / Time to Send Out:
3. Click the Date field and select the date you want the newsletter to be sent using the calendar picker.
4. Click the Time field and set the time you want it to be sent.

5. Click the Select Template dropdown to choose a saved template for this newsletter. All your saved templates will appear in the dropdown list.

7. A live preview of the selected template will appear on the right side of the screen.
ℹ️ Info: All scheduled times use UTC (Coordinated Universal Time). Factor in your local time zone when setting the send time to ensure the newsletter reaches recipients at the right time in your local timezone.
Step 6: Select Recipients
Option A — Patient Conditions:
1. Select the Patient Conditions radio button.
2. Under Recipients - Patient Conditions, use the Load Condition Group Saved dropdown to load a previously saved condition group (e.g., Males 08-25-23).

• Click Add Conditions Group to add a new condition block.
• Under Select Condition Type, choose a type (e.g., Gender, Age).
• For Gender: select the Select Type dropdown and choose Male or Female.
• For Age: enter the Start Age and End Age (e.g., 20 to 50).
• Click Add condition to add more conditions within the same group.
• Click Save Condition Group to save the group for future reuse.
• Click Update Condition to update an existing saved group.
• Click Delete Condition Group to remove the condition group.


4. Select the Saved Email List radio button.

5. Under Saved List of Emails, click the Select List dropdown to choose from your saved email lists. Each list shows its name and number of emails (e.g., New List 07-10-25 (1034 Emails)).

6. Select the Both (List + Patient Conditions) radio button.
7. Both the Saved List of Emails section and the Recipients - Patient Conditions section will appear.

Select Email Type:
9. After choosing your recipients, select which email address to use for each patient:
• Email 1 — sends to the patient's primary email address (Email Address 1 in their Cerbo record)
• Email 2 — sends to the patient's secondary email address (Email Address 2 in their Cerbo record)
• Both — sends to both email addresses for each patient

ℹ️ Info: Email 1 and Email 2 correspond to the Email Address and Email Address 2 fields in each patient's Cerbo Basic Data record (found under Edit Information). Most patients have only Email 1 set up. Select Both only if you want to reach patients on both addresses and want maximum delivery coverage.
💡 Tip: Selecting Email 1 is recommended for most send-outs since almost all patients have their primary email address saved as Email 1. Use Both only when you specifically need to reach patients at a secondary email as well.
Step 7: Save and Schedule the Newsletter
2. The scheduled send-out will appear in the Scheduled Message Send Outs List at the bottom of the screen with the following columns:
• Time To Send (utc) — the scheduled date and time in UTC
• Subject — the template name used
• Status — the current send status
• Action — available actions for the scheduled send-out
3. The system will automatically send the newsletter to all defined recipients at the scheduled date and time.

Step 8: Manage Saved Email Lists
To upload a new email list:
1. Click the Saved Email Lists tab at the top of the Schedule Newsletter screen.

3. Under List File, click Choose file and select a CSV file from your computer. The CSV file must be formatted with three columns: First Name, Last Name, Email.
4. Click Upload New Emails List to upload the list.

To view or edit an existing list:
6. In the Manage Lists table, click View/Edit List next to the list you want to manage.

8. To remove an individual recipient, click Remove next to their row.

10. Click Back to return to the Saved Email Lists management screen

11. In the Manage Lists table, click Remove list next to the list you want to delete
To remove a recipient from the Schedule Newsletter screen directly:
12. On the Schedule Newsletter tab, under the recipient view, click Remove Recipient next to any individual recipient in the current list to remove them from the send-out.
⚠️ Warning: Removing a recipient from a list is permanent. Once removed, they will not receive future newsletters sent to that list unless they are re-added via a new CSV upload.
Summary
Browse templates using All Templates, Premium Templates, or Email Community Template filters
Click Create New Template to open the Template Builder
Drag content blocks (Text, Image, Button, Social, Divider, Spacer, Hero, Wrapper) onto the canvas
Add column layouts (2, 3, or 4 columns) and drop content blocks into each column
Configure each block using the right panel (size, padding, background, typography)
Edit in source code using Json source or MJML source if needed
Click Save to save the template → it appears in All Templates
Go to Schedule Newsletter tab → set Date and Time
Select a template from the Select Template dropdown → optionally attach a PDF
Choose recipients: Patient Conditions, Saved Email List, or Both
For Patient Conditions: select or build condition groups (Gender, Age, etc.) → click Save Condition Group
For Saved Email List: select a list from the Select List dropdown
Select Email Type: Email 1, Email 2, or Both
Click Save Scheduled Email → newsletter appears in the Scheduled Message Send Outs List
Manage email lists on the Saved Email Lists tab: upload CSV, view/edit, remove recipients, or remove entire lists
Troubleshooting
CSV file upload is failing → Verify the CSV file format is correct: three columns in this exact order — First Name, Last Name, Email. Remove any extra columns or special characters before uploading.
Scheduled newsletter did not send → Check the time was entered in UTC, not your local time. Open the Scheduled Message Send Outs List to check the Status column for any error indicators.
Recipients are not receiving the email → Confirm the patients have a valid email address saved in their Cerbo record (Email Address 1 or Email Address 2 under Basic Data). If Email 1 was selected, ensure Email Address 1 is populated for each patient.
Condition group is not filtering correctly → Verify the condition type and values match patient data in Cerbo. For example, Gender = Male will only match patients whose Gender at Birth is set to Male in their Cerbo record.
Template Builder is not saving changes → Make sure you clicked the Save button (top right of the Template Builder) before clicking Back. Changes are not auto-saved.
Saved Email List is not showing updated recipient count after edit → Click Update on the list editor after making changes, then return to the Saved Email Lists tab and refresh to see the updated count.
Need Help?
If you run into any issues with the Email Newsletter app, please reach out to our support team. We're happy to help!
