Skip to content

Configure Email Templates

Configure Email Templates

Customize email templates for automated notifications, communications, and system messages.

Time required: 10-15 minutes per template

Module: mail, openeducat_core_enterprise

User role: System Administrator

Prerequisites

  • System Administrator role
  • Email server configured
  • Understanding of template placeholders

Steps

Step 1: Access Email Templates

  1. Go to Settings -> Technical -> Email -> Templates
  2. Or search for “Email Templates” in the menu

Step 2: Find Existing Templates

OpenEduCat includes default templates:

TemplatePurposeModel
Admission ConfirmationAdmission submittedop.admission
Admission ApprovedApplication acceptedop.admission
Fee ReminderPayment due noticeop.student.fees
Exam ScheduleExam notificationop.exam
Result PublishedGrade notificationop.result

Step 3: Edit Template Content

  1. Open a template
  2. Modify the Body section
SectionDescription
SubjectEmail subject line
BodyMain content (HTML)
FromSender address
Reply-ToReply address

Step 4: Use Dynamic Placeholders

Insert dynamic content using placeholders:

PlaceholderDescriptionExample Output
${object.name}Student name”John Smith”
${object.email}Student emailjohn@email.com
${object.course_id.name}Course name”B.Sc Computer Science”
${user.name}Current user”Admin User”
${ctx.get('key')}Context valueVariable

Step 5: Format Template Body

Example template structure:

<p>Dear ${object.name},</p>
<p>Your admission application for
<strong>${object.course_id.name}</strong>
has been received.</p>
<p>Application Number: ${object.application_number}</p>
<p>Best regards,<br/>
Admissions Office</p>

Step 6: Add Attachments

In Attachments section:

  1. Add static files (brochures, documents)
  2. Or configure dynamic report attachments

Step 7: Preview Template

  1. Click Preview button
  2. Select a sample record
  3. Review rendered output

Step 8: Save Template

Click Save to update the template.

Creating New Templates

  1. Click Create in template list
  2. Fill required fields:
FieldDescription
NameTemplate identifier
ModelTarget model (op.student, etc.)
SubjectEmail subject
BodyHTML content

Common Placeholders by Model

Student (op.student)

PlaceholderDescription
${object.name}Student name
${object.student_id}Student ID
${object.course_id.name}Course
${object.batch_id.name}Batch

Admission (op.admission)

PlaceholderDescription
${object.name}Applicant name
${object.application_number}Application number
${object.state}Application status

Field Reference

Email Template

Technical FieldUI LabelTypeNotes
nameNameCharTemplate identifier
model_idModelMany2oneTarget model
subjectSubjectCharEmail subject
body_htmlBodyHtmlEmail content
email_fromFromCharSender address

Troubleshooting

Placeholders not rendering

  1. Check placeholder syntax is correct
  2. Verify field exists on the model
  3. Check object has data in that field

Template not sending

  1. Verify email server is configured
  2. Check template is linked to correct action
  3. Review email queue for errors

Formatting issues

Use inline CSS styles for reliable rendering across email clients.


Related: Configure Email | Set Up Email Notifications