---
title: "Creating Class Notifications"
slug: "class-notifications"
tags: ["NFR"]
updated: 2024-11-07T17:31:58Z
published: 2024-11-07T17:31:58Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skillable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating Class Notifications

Automated Notification Plans are a way to notify students, instructors and staff when something changes in the Skillable TMS. Most notifications are triggered based on an action taken in the platform, but we also have time triggers for Enrollments, Classes and Course Assignments. Using notifications can save you a significant amount of time because you will not need to email people with updates.

Please keep in mind, all users have the right to opt out of notifications. Even though a notification is sent out by the platform it does not mean that the email will be received by the user.

![Automated Notifications Diagram](https://cdn.document360.io/a298db04-a0fe-47e0-bfe3-c52d6f9d7c8c/Images/Documentation/notification-process.png)

## Preparation for Creating a Notification

Take some time to answer the following questions for each notification you want to create.

1. What action triggers a notification?
2. Who is the user completing the action triggering the notification?
3. Who are the user(s) receiving the notification?
4. A valid email address to display in the “From” line of the notification
5. Subject for the email notification
6. Text for the email you are sending through the notification

## Select a Trigger Event

The Trigger Event is an action in the platform causing a notification to be sent out. In most cases this is an action that is taken in the platform, like changing a class status from Scheduled to Cancelled, then when the class is saved it triggers the notification to be sent. A time trigger is also available based on when a class begins and ends or when a course assignment is set to expire.

One or more trigger events may be used. When multiple triggers are in place a notification is sent when any of the event triggers are met. After choosing the first trigger the selection list is limited to similar types of notifications based on filters and replacement text options used.

## Types of Class Notifications

Available class triggers are when a class is created, deleted, or cancelled. There is also a class time trigger.

The Class created trigger sends a notification when a class is created in an organization using the notification. The Class deleted trigger sends a notification if someone in your organization deletes a class. The Class cancelled notification is sent when a class’ status is changed to Cancelled.

The class Time Trigger sends notifications in relation to the class start or class end times. The trigger time is set in hours prior to or after the class start or end time. This trigger is very similar to the Class enrollment class time trigger, which has three additional filters available, the First occurrence of course only, Attendance Location, and Lab Availability filters.

## Add a Trigger Event

Select trigger(s) for your automated notification.

1. Beside Trigger Event select the **Add event** link, this opens a pick list of triggers.
2. Select a trigger and select **Add** to enable the trigger for your notification, it is added in the Trigger Event field.
3. Select **Add event** again to add more triggers.

### Trigger Filters

After adding a trigger event, different filters can be applied to further define when a notification is sent. Along with the Trigger Event you can add criteria to limit it to specific circumstances. This will also allow you to send different notifications for the same type of trigger event with different criteria enabled.

Trigger filters must be applied with a time trigger, but they are optional for all other trigger types. A time trigger must have the number of hours and the class start or class end options added.

### Class Filters

Explanations of the filters available when setting up class notifications are listed below.

#### Scoped to student Organization?

By default, class and enrollment notifications are sent based on class ownership, this means that anyone registered for the class receives notifications sent by the Organization holding the class. This setting is in place for instances where one organization is holding a class and students from other Organizations are attending the class. Enabling this setting allows the student’s organization to send a notification to their student when they are enrolled in another organization’s class. It may be used when you have multiple organizations or are using preferred partners.

#### Dedicated Classes

Dedicated classes are set up to only allow registration of students who belong to a specific company. Use Do Not Check for the notification to go out whether or not the class is dedicated, or you can specify that the notification only goes out for dedicated classes, or that it only goes out for classes that are not dedicated. *Dedicated class is set up in a class. It is found on the Basic Information tab with Advanced Settings opened; the Company field must have a company added for the class to be dedicated.*

#### Class Status

The Class status is set to show that a class is going to run or not. You can have notifications sent based on the status set on the class. You may only want notifications to go out based on a class status being Scheduled or Guaranteed to Run. If a class status is not specified, then notifications are sent for all class statuses.

#### Time Triggers

Time trigger notifications must have settings input for the time filter. The time trigger sends notifications based on the designated amount of time you set; and are set to a specific number of hours before class starts, after class has started, before class ends, or after class has ended. Notifications are sent at the top of the hour for any time triggered in the previous hour.

#### Time Trigger – Hours

Only displays for the Class time trigger.

You can set the notification to trigger a set number of hours before class starts, after class starts, before class ends, or after class ends. Input the number of hours and the class start or end setting needed.

### Add Trigger Filters

Select filters you wish to add.

1. Enable check boxes and choose from pick lists if you wish to change the default filter settings.

## Select the User Triggering the Notification and Users Receiving the Notification

The Triggered by and Send to selections are based on the user’s Roles. Trigger by allows you to choose the person completing the action triggering the notification, while Send to indicates who the recipients of the notifications will be. For example, if you would like to have a notification sent when a staff member enrolls a student into a class, then you will choose Triggered by Administrator and Send to User.

### Triggered By

For most notifications, two user types are available to select from as the one triggering the action to send the notification, User or Administrator.

For Triggered by:

- User refers to a student taking an action in the platform.
- Administrator means a user with a role with administrative rights acting in the platform.

One or both can be selected as the one triggering the notification. For example, both a student and an administrator can cancel a student’s enrollment, you may want to set up a notification where it is sent when either have initiated the cancellation.

No user is selected for time-based triggers, they are triggered based on the time selected in the trigger filters.

### Add a Triggered by User

Select the user taking the action in the platform that triggers the notification.

1. Check the box beside **User** or **Administrator** based on the criteria above.

### Select Users Receiving the Notification

Notification recipients are set by role. For some choices the user role chosen is limited based on their connection to the trigger event. In other cases, everyone in your organization with the chosen role will receive the notification.

#### Send to Options:

Explanations of the users available when setting up notifications are listed below.

#### User

When the user is the recipient, user is not defined by role but is a user that the trigger event and filters apply to. For example, for the Class Enrollment enrolled trigger, all users enrolled in the class receive a notification.

#### Account Executive

Adding the Account Executive as a recipient will send a notification to a user’s Account Executive when the trigger event and filters applies to that user. The Account Executive is set on the User Profile.

#### Instructor

Adding Instructor as a recipient sends a notification to the assigned instructor(s) on a class.

#### Creator

Enabling Creator as a recipient sends a notification to the user who created an item, like a class, an enrollment, a course assignment, etc.

#### Editing Delegates

Editing delegates is for organizations using roles that limit editing of a class to the class creator. Adding Editing delegates on a class allows the creator to assign other users to be able to edit their class. Adding an editing delegate as a recipient on notifications will send a notification to any editing delegate that is added to a class.

#### Class Custom Users

Class custom users is a custom field option that can be added to a class allowing specific users to be selected based on their role. Enabling Class custom users on your notification allows you to select from Custom Fields that are enabled to use Class custom users. Select the custom fields you want added and notifications are sent to the users added to a class through that field.

#### Organization Managers

Adding Organization managers allows you to choose roles, like Operations Manager role or Automated Notification Recipient 1, once added all users with that role are sent a notification.*

#### Company Managers

A company manager has access to users based on the Company added on their User profile, management of users in a company is added on the User profile’s Company Management tab. Adding Company managers to your notification allows you to choose roles, like Company Training Manager, once added all users with that role are sent a notification.

Please Note

We have created roles called "Automated Notifications Recipient" and they are numbered 1-5. These roles do not have permissions, they are in place to give you flexibility to assign a user the role to have them receive a notification.

### Add Recipients of the Notification

One or multiple recipients can be set for a notification. Follow the instructions below to add recipients in the To field.

1. Place check marks beside all **recipients** for the notification.
2. For **Class Custom Users**, once checked a section opens below, select the **Add Class Custom User Field** link opening the Choose Custom Field dialog. Search for and select one or more **custom field** and select **OK** to add your selections.
3. For **Organization Managers**, once checked a section opens below, **Include parent Organizations** is selected by default, uncheck this if you do not want users in your parent organizations to receive notifications. Select the **Add Organization manager user role** link opening the Choose User Role dialog. Search for and select one or more **user role** and select **OK** to add your selections.
4. For **Company Managers**, once checked a section opens below, select the **Add company manager user role** link opening the Choose User Role dialog. Search for and select one or more *user role ** and select **OK** to add your selections.

## Email Header Information

Each notification sends an email showing a Subject line and From line. You can also add a CC’d email to receive the notification.

### Notification From Line

You need to provide a valid email address to display in the **From** address, an invalid email address may be read as spam and be rejected by a recipient’s email server. The email will be sent by our servers, but this is the address which is shown to recipients.

### Notification CC Line

A carbon copy (CC) email address can be added. When in place a copy of each notification is sent to the recipient.

### Notification subject Line

Input a Subject for the email notification. Replacement text fields can be added to the subject.

### Add Email Header Information

Follow the instructions to add information in the From, CC, To, Subject fields, and add a calendar appointment.

1. In the **From** field input a valid email address.
2. If needed, add an email address in the **CC** field to be copied on each notification sent.
3. Input a title in the **Subject** field to let the recipient know what the email is about.
4. Uncheck **Enabled** until you are ready to test the notification.

## Email’s Content

The Notification text tab is where you input the message you want to send out to recipients.

You can use HTML code to format the email, add links, and images, like a logo. Replacement text fields are located below the text field, these are used to pull data from the platform to add information specific to the recipient or event. For example, using the replacement text field [ClassName] inputs the recipients class name or the name of the class created or deleted.

### Add Email Content

Follow the steps below to add the text to your notification email.

1. Open the **Notification Text** tab.
2. Input plain text by selecting the top left corner of the text field.
3. Use the formatting bars to enhance the text.
4. Use the Source Code button, **< >**, to enter HTML code directly.
5. Be certain to use Replacement text for anything that can change by person or event, like the student’s name, class name, class date and time, etc.

## Organization Availability

Organization availability determines which organizations the notification is enable for.

Organization management, set on the user profile, determines which organizations an administrative user can view and manage. If you only have one organization, then check the organization to enable your notification for it. If you manage multiple organizations, check the box beside the organizations that will use the notification.

The organization show in their hierarchies, if a down arrow, **v**, shows beside an organization name, then the arrow can be selected to show its child organizations. Checking the box beside a parent organization automatically selects all its child organizations, however, child organizations can be selected individually if the parent organization is unchecked.

### Add Organization Availability

Follow the instructions below to enable your notification in your chosen organizations.

1. Open the **Organizations** tab, you will see a listing of organizations you manage.
2. Check the box beside the **organization(s)** that will use the notification.

## Specify Which Courses are Required for the Notification to be Sent

Your notification can be set to apply to all courses or to only apply to specific Course(s). It defaults to being used with all courses and that is what is needed in most cases. When you have unique instructions for a course that do not apply to other courses, it can be helpful to be able to send instructions about that course or courses. You can set up the notification against individual courses or use course groups. Course groups are given a title and a group of courses is added, this feature is for convenience of finding a set of courses in the platform.

It is best to not set a Program. Most organizations only use the Training program. Programs align with permissions and entities, if you set a program that doesn’t apply to your Users, courses, Subscriptions, or classes, then the notification will not work.

### Add Courses to Trigger Notifications

Do the following to add courses as triggers for notifications. Using courses as a trigger limits the notification to only be sent for the selected courses.

#### Individual Courses

1. Open the **Courses** tab, Applies to all courses is selected by default, select the radio button beside **Specify courses**.
2. Under Individual courses, select the **Add Course** link, this opens the Choose Course dialog.
3. Input part of the **course name**, select **Search**, and select the desired **course**.
4. Continue to search and select all the courses needed, then select **OK**. The selections are added under the Individual courses heading.

#### Course Groups

1. Open the **Courses** tab, Applies to all courses is selected by default, select the radio button beside **Specify courses**.
2. Under Course Groups, select the **Add Course Group** link, this opens the Choose Course Group dialog.
3. Input part of the **course group name**, select **Search**, and select the desired **course group**.
4. Continue to search and select all the course groups needed, then select **OK**. The selections are added under the Course Groups heading.

## Enable Notifications on a Class

Notifications related to classes must have Enable Notifications checked to have them sent.

To enable notifications on a class,

1. Edit the class and stay in the **Basic Information** section.
2. Select **Show Advanced Settings** in the top right above the section header.
3. Check the box for **Enable Notifications**.
4. **Save**.

You can also add this as a default setting so that each class created has notifications enabled. To do this,

1. Edit your **Organization** profile.
2. Open the **Preferences** tab.
3. Under Class Settings, check **Enable Class Notifications**.
4. **Save**.

## Test a Class Notification

Testing a notification gives you the opportunity to verify that the notification sends when you want it to go out and does not send when you do not want it to go out. You can limit the impact by restricting the notification to only go out for one course.

For testing purposes, to limit the users a notification is sent to you may create a course specifically for this purpose and then specify the course in the notification plan.

To create the course with the minimum fields:

1. From Site Admin on the Courses tile, select **Create Course**.
2. On the Basic Information tab,
  1. Input a **name**for the course, **Testing Automated Notifications**.
  2. In the **Program**field select **Training**.
  3. On the **Content Provider**field, select your **organization**.
  4. Check the box to enable **Available Instructor-Led**.
3. On the Publishing Groups tab, add a publishing group under your **organization**.

Open your Notification Plan, if you have disabled the notification you will need to add the **Enabled** filter on the **Find Notifications** page and filter by **Is not Enabled**.

To set up testing, begin by preparing your notification.

1. Select **Edit** on the notification.
2. Open the **Courses** tab and select **Specify courses**.
3. Under the **Individual courses** heading, select **Add course**.
4. Search for and select a course named, **Testing Automated Notifications**, then select **OK**.
5. On the **Basic Information** tab, check the **Enabled** box.
6. **Save**.

### Create a class.

1. Create a new class using the course set on your notification.
2. Verify any notification filters you have set are set in the class. For example, if the class must be Dedicated for the notification to send, then assign a company to the class.
3. **Save** the class.
4. If testing a class status change, change the status and save again.

### Check for Notifications.

1. Select the **Details** link in the top right corner of the page to return to the **Class** profile.
2. Select the **Find Sent Notifications** link to view all notifications sent for the class.

## Enable your Notification

Once you have completed testing, you will want to enable your notification to put it in use.

1. Return to your **Notification Plan** to select **Edit** and open the **Courses** tab.
2. To make your notification available for all courses used in your organization, remove the **Testing Automated Notifications** course and select **Applies to all courses**.
3. To make your notification available for specific courses used in your organization, remove the **Testing Automated Notifications** course. Select **Add Course** and select all courses that need this notification, then select **OK**.
4. **Save**.

### Additional Resources

[Creating Notification Template for a Pre-class Reminder](/v1/docs/template-preclass-reminder) [Creating Notification Template for after Class Thanks](/v1/docs/template-after-class-thanks) [Creating Notification Template for Class Cancellation](/v1/docs/template-class-cancellation) [Using Automated Notifications](/v1/docs/use-automated-notifications) [Creating An Automated Notification](/v1/docs/create-an-automated-notification) [Creating New User Notification](/v1/docs/new-user-created-notification) [Creating Instructor Notifications](/v1/docs/instructor-notifications) [Creating Course Assignment Notifications](/v1/docs/course-assignment-notifications) [Creating User Role Assignment Notification](/v1/docs/user-role-notification) [Notifying for Subscription Assignments](/v1/docs/subscription-assignment-notification)

A notification plan is an automated email template. It is automatically triggered by an action in the system or a time setting to send out reminders, enrollment updates, training assignments and many other items.

Skillable's Training Management System. A learning management system designed to streamline the delivery, tracking, and reporting of your training programs.

An enrollment is the student registration for a class. Enrollments have multiple statuses, but only the Enrollment Status of Enrolled gives a student access to class. Within the enrollment the student will access the labs and activities and if set up digital courseware and virtual classroom for their class.

A class is a scheduled instructor-led event with a start and end time/date. Typically, these include lectures and hands on activities such as labs.

A course assignment delivers self-paced access to a course. A course is assigned to a student giving immediate access to the student. It can be accessed at any time for the duration of the assignment. The assignment duration begins and is billed when it is created.

An action in the platform causing a notification to be sent out.

This is dependent on the start and end times of a class or the expiration date of a course assignment.

An organization is assigned to each entity in the TMS, such as, users, classes, subscriptions, and courses. The organization is a basis to determine access given based on roles within the organization and management over the organization.

Organizations are the containers in which all objects in Skillable Studio reside. Each organization has two child orgs, Development and Production. Development is used for content creation and testing. Production is used only for content that is ready for consumption. Organizations also provide one of the security boundaries within the Skillable Studio platform.

Roles contain sets of permissions giving a user access within the platform.

The user profile contains information about the user and their preferences, including roles, managed organizations, and settings.

Custom fields can allow organizations to capture and apply their own information to TMS Users, Classes, Enrollments, Subscriptions, and Courses for reporting on information they wish to collect. Custom fields can be set up as a text field, dropdown list, checkbox, number field, user selector, or checkbox list.

A user role that is assigned to organization administrators. This is the highest level of permissions which customers can receive. It enables users to be able to create and manage users, content, training, pull reports, assign roles and organization management.

On the user profile, management of one or more companies can be added giving the user limited permissions to view training those users who are in the company are scheduled to take and have completed.

Organization management sets the organizations a user with administrative roles can work within. All entities such as, users, courses, classes, subscriptions, have an organization assigned. An administrative user must have management of the organization to view and work with the entities.

Bundles together content to then be set up for training through classes, subscriptions, and course assignments. Courses can include labs, videos, SCORM, LTI, external links, assessments, and documents. Courses must be assigned to a Content Provider and a Publishing Group to be available to set up for training.

People who interact with the platform. Typically, we can break down users into three categories: Operations Managers, Instructors and Basic Users..

A subscription is an assignment to an individual for access to a set of courses for a set amount of time for self-paced access. Students can choose which courses to access from the subscription, which then open as a course assignment, and they can access the courses at any time for the duration of the subscription.

Enable notifications is an option on the user profile allowing the user to opt in or out of automated notifications generated through the TMS.

Publishing groups are applied to courses to create different catalogs of content which you can make available exclusively to specific customers by publishing to organizations. A publishing group must be added to make the course available to schedule. Organizations can have one or multiple publishing groups to operate.