Overview
Re-enrolment letters ask families to confirm their child's lessons, ensembles and instrument hire for the coming year. Music Monitor builds each letter from the student's current tuition enrolments, ensemble enrolments and instrument hire records, then emails or prints it.
From version 10.044 onward, the Re-enrolment Letters script:
prepares the letters on the server, so they're ready in seconds (154 letters took about 6 seconds in testing, down from about 7 minutes)
sends each parent their own email, with only their address in the To field, so parents never see each other's addresses and the emails are less likely to land in junk mail
greets each parent by name where a name is recorded
shows a summary when the emails have gone, with the option to print any letters that couldn't be emailed
adds settings for a greeting when no parent name is recorded, the student's ensemble part, start dates and future starts to the Re-enrolment Letter Preferences screen
Before version 10.044, the letters are prepared on your computer. Those steps are in the Before Version 10.044 section at the end of this article.
Which Enrolments Are Included
A re-enrolment letter lists only enrolments that are continuing and not about to finish. Check these before you run the letters, because an enrolment that's left out won't appear on the family's letter.
Type | Included | Left out |
Tuition | A Status of "Current", "Assigned" or "Suspended" | A Termination Date in the past or within the next 60 days |
Ensembles and classes | A Status of "Current", "Assigned" or "Suspended" | A Finish Date in the past or within the next 60 days |
Instrument hire | A Status of "Current" or "Overdue" | Any other Status |
An enrolment with a Termination Date or Finish Date of 31 December this year is always included, even though that's within 60 days. Schools often use 31 December to mean "runs to the end of the year", and those families still need to re-enrol. See Roll Over or Re-enrol for more detail.
A Termination Date or Finish Date more than 60 days away doesn't exclude the enrolment.
From version 10.044 onward, when a Future starts date is set on the Re-enrolment Letter Preferences screen, tuition that starts after that date is left out. Tuition that has already started is always included.
An ensemble enrolment with a future joining date has a Status of "Pending", so it's never included.
Students with no enrolments or hire records that qualify get no letter.
From Version 10.044 Onward
Prepare the Letters
Warning: Emails can't be recalled once they're sent. Check the letters in the preview before you choose to email them, and consider running a small group of students first.
If your emails send directly, Music Monitor sends at most 30 emails a minute, so a large batch can take a few minutes. Leave it running until the summary appears.
Choose the students in one of two ways:
In the Students table, perform a Find for the students you want, then select Scripts > Re-enrolment Letters.
Go to Common Tasks > End of Year Procedures > Re-enrolment Letters, enter your search criteria, then select Perform Find.
On the Select Letter screen, choose an existing letter from the drop-down list in the centre of the window, or select the blue Create NEW Template button below it to make a new one. Then select Continue.
Note: Re-enrolment letter templates can't yet be set up from Common Tasks > Templates.
On the Re-enrolment Letter Preferences screen, choose your settings. Music Monitor remembers them for next time.
Send to: "ALL parent contacts" (the parents on the student's record, plus any Additional Contacts with an email address) or "PRIMARY contact only" (just the parents on the student's record).
Greeting if no name: the greeting used when no parent name is recorded. Choose "Dear Families" or "Dear Parent, Guardian or Caregiver", or type your own. If you leave it empty, Music Monitor uses "Dear Parent, Guardian or Caregiver".
Select information to include: the tuition, ensemble and instrument hire details to list, and whether to show lesson and rehearsal times, rooms, teachers and serial numbers. Ensembles that rehearse more than once a week show every rehearsal time.
2.d Ensemble part: adds the student's part after the ensemble name, for example "Concert Band (Trombone)".
4. Start dates: adds the start date to each tuition and ensemble line, for example "Start date: 24 Apr 2023".
5. Future starts: pick a date to leave out tuition that starts after it, such as the first day of term, or 31 December to leave out new students already entered for next year. Leave it empty to include everyone.
Select Continue. Music Monitor prepares the letters in a few seconds and opens the preview.
Preview and Send
Check the letters in the preview. It shows one letter per family; use the arrows at the top right to move between letters.
Email to lists every address the letter will go to, each with the greeting that parent will receive, for example "sarah @ example.com (Dear Sarah)".
"(no email address)" means that family can't be emailed.
The grey Edit Template button at the top changes the wording in the body of the email for every letter.
Cancel stops here. Nothing is sent and no notes are added.
Select Continue, then choose one of the following:
"Email": each parent address gets its own email.
"Print": Music Monitor prints one letter per family.
"Cancel": nothing is sent or printed, and no notes are added.
If your emails open in your email application rather than sending directly (see Email from Music Monitor), Music Monitor asks whether to preview each email before it's sent. Some email programs won't send automatically, so choose "Yes" if the emails don't go.
When the emails have gone, check the summary. It shows how many emails were sent and for how many letters, how many letters had no parent email address, and any emails that failed, with the address and the error. If any letters weren't emailed, select Print 1 letter (or Print 3 letters, and so on) to print just those.
Music Monitor adds a note to each student whose letter was emailed or printed: "<letter title> sent to <the addresses it went to>". If you cancel the print, no note is added. A letter that wasn't emailed or printed gets no note. Before version 10.044, the note was tagged "Private"; it is no longer tagged at all.
How Greetings Are Chosen
From version 10.044 onward, each email greets the parent by the name recorded for them. When there isn't one, Music Monitor uses the Greeting if no name setting.
The email address comes from | Greeting |
Email 2 on the student's record | Parent 1's first name, or the Salutation if that's empty |
Email 3 on the student's record | Parent 2's first name, or the Salutation if that's empty |
An Additional Contact | That contact's Salutation, or their first name |
Both the student's record and an Additional Contact | Greeting if no name |
No name recorded | Greeting if no name |
The printed letter, and the letter in the preview, use the family greeting: the Salutation on the student's record, otherwise both parents' first names ("Dear David & Elissa"), otherwise Greeting if no name.
Music Monitor tidies names entered all in capitals, so "DAVID & ELISSA" becomes "David & Elissa". Names in mixed case, such as "McDonald", stay exactly as entered.
Split Families
Music Monitor treats the parents on the student's record and the parents in Additional Contacts as separate households. It also treats several Additional Contacts as separate households, because it can't tell whether they live together. So:
each parent receives their own email, with only their address in the To field
an email only ever names the recipient's own household
an address that is on both the student's record and an Additional Contact gets one email, greeted with Greeting if no name
If a letter's greeting is changed before sending, the change goes only to the parents on the student's record. Additional Contacts keep their own greeting.
Troubleshooting
Problem | What to check |
A family shows "(no email address)" | Add an email address to Email 2 or Email 3 on the student's record, or to an Additional Contact. Or print their letter from the summary. |
A parent is greeted with the default instead of their name | Fill in the parent's first name (Parent 1 or Parent 2) or the Salutation on the student's record, or the Additional Contact's Salutation. |
A greeting shows a full name, such as "Dear Emily Bunn" | The first-name field holds a full name. Correct it on the student's record. |
An enrolment is missing from a letter | Check its Status, its Termination Date or Finish Date, its start date and the Future starts date (see Which Enrolments Are Included). |
An Additional Contact wasn't emailed | Send to must be "ALL parent contacts". "PRIMARY contact only" uses only the email addresses on the student's record. |
Some emails failed | The summary lists each failed address with its error. Check the address, then print that letter or send it again. |
Before Version 10.044
This section is for systems before version 10.044. In these versions, Music Monitor sends one letter per student.
When you email the letters, they either open in your email application one after another, for you to preview each one and select Send, or send directly, depending on your email settings. See Email from Music Monitor for detail.
If the emails open in your email application, try a small group of students first, so it isn't overloaded.
Choose the students in one of two ways:
In the Students table, perform a Find, then select Scripts > Re-enrolment Letters.
Go to Common Tasks > End of Year Procedures > Re-enrolment Letters. The script will display a Find screen pre-set to find all "Active" students. Change the criteria if needed, then select Continue.
On the next screen, choose which details to merge into the letter from the students' tuition enrolments, ensemble enrolments and instrument hire records.
The script brings in the enrolment and instrument hire details and displays a screen for choosing the letter. Select the white space under Letter Title to see the drop-down list of existing templates. Choose a template and edit it to suit, or create a new one.
Tip: Re-use the same template for the same process each year and just update the dates. That way you only need different templates for different purposes, not a similar letter for every year.
Select Continue. Music Monitor creates a letter for each student, using the parents' name and address details. Additional contacts entered in the Mail Alert/Additional Contact portal get letters too.
To check each letter, move through the pages with the book icon in the toolbar at the top left of the screen.
Select Continue at the top right of the screen. Music Monitor asks whether you want to edit the letter. You can:
change the text in the body of the letter, which is saved for next time
change the letter's title with the Edit Letter Title button
change the date, closing and signature
Note: If you're emailing the letters, don't spend time on formatting such as text size or bold. Formatting isn't carried into emails; it only shows on printed letters.
Select Continue to preview the letters again. Repeat steps 5 and 6 until you're happy with them.
When asked whether to edit again, select "No". Then choose "Print" or "Email", or select Cancel.
The letters print, or the emails go out as described at the start of this section. Music Monitor returns you to your starting screen and adds a "Private" note to each student's record listing the date, the letter title and the person the letter was sent to.



