Email sendouts in Candidacy
On this page, you can find an overview of all the emails sent by the system, what triggers/prompts them, and when.
Sign-up – this email is triggered when a new end-user signs-up to candidacy.
Forgot password – this email is prompted by the end-user, when they forgot their log in password to the system.
Didn’t receive confirmation instructions – receives the same email as in the sign-up. This email is prompted by the end-user when they have not received their sign-up confirmation instructions
Didn’t receive unlock instructions – this email is prompted by the end-user when their account is locked and they did not receive the unlock instructions
Request approved – this email is sent when a candidate or a party approval request has been approved by the user in the backend
Candidate:
Party:
Request rejected – this email is sent when a candidate or a party approval request has been rejected by the user in the backend
Candidate:
Party:
Invite recommender – this email is sent to a recommender when 1. a candidate invites them to endorse their candidacy profile; or 2. a party admin/owner invites them to endorse their party profile.
This email can also be triggered by a manual creation of a recommendation invitation in the backend.
Candidate:
Party:
Confirmation of recommendation – this email is sent to the recommender when they accept the recommendation invite
If they already have an account in the system:
If they do not have an account in the system:
Create a password – the following email is sent, when an account is created manually in the backend by a user or admin
Invite to join a party – this email is sent to an end-user by a party admin/owner, with the intent of inviting them to join the party.
In this example, John Doe is inviting Ally Smith to be a Candidate of the party in question. There are two other roles one can be invited to have: Owner and Administrator.
Joined a party – this email is sent to the end-user who has accepted an invite to join a party
Notice of joining a party – this email is sent to any Administrators and Owners of a party when a new member joins their party
Changes in party role – this email is sent when a party member’s role is changed to something else
Notice of changes in party role – this email is sent to any Administrators and Owners of a party when a member’s role is changed
From the “Translations” page, you can edit the text and template of all emails that are sent from the system to end-users (this is applicable to all end-users, that is, voters, candidates, and recommenders) – read more about Translations here.
To do that, look for all translation keys ending with “body_html”, as shown below:
Below you can find an overview of all translation keys that can be targeted to edit the email translations. To edit these emails in the translations, simply copy the “Translation key” from the table below and input it in the “Key” field (as highlighted above).
Function | Description | Translation key |
|---|---|---|
Sign-up & Confirm account | this email is triggered when a new end-user signs-up to candidacy. | candidacy.account_mailer.confirmation_instructions.body_html |
Reset password | this email is triggered by the “Forgot password” action | candidacy.account_mailer.reset_password_instructions.body_html |
Create a password | this email is triggered when an account is created in the backend | candidacy.account_mailer.welcome_instructions.body_html |
Unlock account | this email is triggered by the “Didn’t receive unlock instructions” action | candidacy.account_mailer.unlock_instructions.body_html |
Recommendation invitation | this email is triggered when an end-user asks for endorsement (ie. recommendation invitation) | candidacy.recommendation_invitation_mailer.invite.other_candidate_body_html |
Confirmation of email change | this email is triggered when the email address of an account is changed | candidacy.account_mailer.email_changed.body_html |
Confirmation of password change | this email is triggered when the password of an account is changed | candidacy.account_mailer.password_change.body_html |
Confirmation of recommendation submitted | this email is triggered when an end-user gives a recommendation (ie. accepts the recommendation invitation) | candidacy.recommendation_invitation_mailer.recommendation_confirmation.body_html |
Approval of requests | this email is triggered when a candidate asks for their profile’s approval | candidacy.approval_request_mailer.approval_request_created.body_html |
Notice of changes in party role | this email is triggered when a new role is attributed to a party member | candidacy.party_account_mailer.inform_of_new_role.body_html |
Notice of new party admin added | this email is triggered when a party member becomes an administrator in that party | candidacy.party_account_mailer.new_party_admin_created.body_html |
Notice of new candidate added to the party | this email is triggered when an end-user becomes a candidate for the party (this could be via frontend invitation or manual addition from the backend) | candidacy.candidate_mailer.candidate_created.body_html |
Confirmation of joining party | this email is triggered when an end-user joins a party (via invitation) | candidacy.party_account_invitation_mailer.party_account_confirmation.body_html |
Create password - party | this email is triggered when an end-user joins a party and they did not have an account prior to joining the party | candidacy.party_account_invitation_mailer.party_account_confirmation.account_creation_notice_html |
Invitation to join party | this email is triggered when a party owner or admin sends a party invitation to another end-user | candidacy.party_account_invitation_mailer.invite.body_html |
Recommendation rejected/accepted for party | this email is triggered when a recommender accepts or rejects a recommendation invitation | candidacy.recommendation_invitation_mailer.recommendation_invitation_rejected_accepted.body_html |
Invitation to recommend party | this email is triggered when a party owner or admin asks for endorsement to a party profile (ie. recommendation invitation) | candidacy.recommendation_invitation_mailer.invite.party_body_html |