Platform access level: Org Admins. System messages sit under Settings, which only Org Admins can open, so replacing Arist's wording is an Org Admin job. What you save here applies to every team and every schedule in your organization.
Alongside your lessons, Arist sends short messages of its own. A learner who replies SUPPORT gets one, a learner whose course is waiting in line gets one, and every response reminder is one. Arist writes all of them for you, and this page is where you replace that wording with your organization's own.
Rewriting them lets you point learners at your own support contact, match your organization's tone, and say the same thing in every language you deliver in.
1. Review the system messages your organization has customized
Open Settings and choose System messages in the sidebar.
The heading counts how many custom messages you have, and the table lists each one with three columns, MESSAGE TYPE, LANGUAGE, and TEXT. Select either MESSAGE TYPE or LANGUAGE to sort the list by that column.
A new organization starts with nothing on this page. Every row you see is a replacement someone in your workspace saved, and removing one hands that message straight back to Arist's default.
Use Search to find a message by its text, and Filters to narrow the list by Message types, by Languages, or by both together. The Filters button shows how many filters are active.
2. Create a system message
Select Create new at the top right to open the Create a new system message panel.
It asks for three things, in this order.
Field | What to enter |
Type | Choose the Arist message you want to replace. Section 3 lists every type. |
Language | Choose the language this wording applies to. |
Text | Write the message learners will receive, up to 400 characters. |
All three fields are required, so choosing a type on its own is not enough to save. Your organization can hold one custom message per type and language pair, which makes a Support message in English and a Support message in Spanish two separate rows, while a second English Support message is not allowed. Arist checks the pair while you fill in the form and tells you when the combination already exists. Select Create system message to save, or Cancel to close without adding anything.
Tip: Choose the type and the language first, and leave the Text box alone for a moment. Arist fills it with its own current wording for that combination, so you start from the right structure and the right variables.
3. Pick the message type you want to replace
There are 23 message types, and each one maps to a specific moment in an enrollment. The Select type dropdown offers the ones that apply to your workspace, so the Microsoft Teams types appear when Teams is one of your delivery methods, the Slack type appears when Slack mentions are in use, and a reminder you have switched off is left out.
Type | When a learner receives it |
Support | They reply SUPPORT or HELP and get their enrollment details and where to get help. |
Slack mention text | Arist mentions them in Slack to bring them back to the conversation. |
Response already accepted | They answer a question they have already answered. |
Up next enrollment pre-activation | Arist sends this message when they are enrolled in a course that has to wait for their current one to end. |
Instant course activation suffix (with scheduled delivery time) | An instant course starts and the first lesson is due at a set time. |
Instant course activation suffix (immediate delivery) | An instant course starts and the first lesson is on its way. |
Scheduled course activation suffix | A scheduled course starts, telling them which days and roughly what time to expect lessons. |
Activation support suffix (with STOP) | A course starts on a delivery method where replying STOP opts them out. |
Canceled enrollment response | They reply to an enrollment that has been canceled. |
Completed enrollment response | They reply to an enrollment they have already finished. |
Disabled enrollment response | They reply to an enrollment that has been disabled. |
STOP not supported (Teams/Slack) | They reply STOP on Microsoft Teams or Slack, where it does not opt them out. |
Microsoft Teams next lesson message | Arist tells them in Teams that their next lesson is ready. |
Survey ready message | Arist tells them their survey is ready. |
Microsoft Teams complete course button | Arist offers them a button in Teams to mark a course complete. |
Response reminder #1 for scheduled enrollments | The first reminder goes out on a scheduled course. |
Response reminder #1 for instant enrollments | The first reminder goes out on an instant course. |
Response reminder #2 | The second reminder in the sequence goes out. |
Response reminder #3 | The third reminder in the sequence goes out. |
Response reminder #4 | The fourth reminder in the sequence goes out. |
Response reminder #5 | The last reminder in the sequence goes out. |
Support message for SMS code enrollment | They ask for support over SMS while enrolled in more than one course, and get a link per enrollment. |
Microsoft Teams help message | They ask for help in the Arist app in Microsoft Teams. |
Response reminders have a settings page of their own for their timing and their Enabled toggles, covered in Configuring Response Reminders. Reminder labels here count only the reminders that are currently enabled, so a row saved as Response reminder #3 reads as Response reminder #2 once reminder 2 is switched off.
The type you choose decides which Arist message you replace, so picking Support changes the reply a learner gets after sending SUPPORT or HELP and nothing else. Using System Keywords covers what learners can send in the first place. Choosing a type saves nothing on its own, and Arist marks the fields still waiting for an answer.
Note: The welcome message is not on this list, because it is written per course in the content editor. The activation suffix types on this page are the standard lines Arist adds after it, so rewriting one changes the delivery detail every course carries. See Using the Content Editor.
4. Set the language the message applies to
The Language dropdown offers English plus each of Arist's 40 supported languages, which is the same list you choose from when you translate a course. See Supported Languages.
Arist matches a system message to the language the enrollment is delivered in, not to the language the course was built in. A custom Support message saved in English reaches the learners receiving English, and a learner receiving Spanish gets Arist's default Spanish text until you save a Spanish version too.
If you deliver a course in several languages, save the message once per language you send in. Translating the lessons themselves is a separate job, covered in Translating an Existing Course.
5. Write the message text
The Text box takes up to 400 characters and needs at least 2. Select the emoji button below the box to insert an emoji, and write the rest as plain text.
Arist's messages use variables in the form %{name}, which Arist fills in per learner as it sends. Type each one yourself, with the percent sign and the braces exactly as they appear here. Arist fills in any variable it can answer at send time, so this table covers the ones you will meet rather than every possibility.
Variable | What Arist fills in |
| The name of the learner's course. |
| The channel name when the enrollment has one, and the course name otherwise. |
| The question the learner still has waiting. |
| The learner's link for managing their enrollment. |
| Every course the learner is active in, each with its own link. |
| The time the next lesson is due, with its time zone. |
| The date the next lesson is due. |
| A full timestamp for the next lesson. |
| The day of the week the next lesson is due. |
| The time the next lesson is due in the learner's own time zone. |
| The number Arist sends from, on SMS and WhatsApp. |
| On SMS, the line offering to resend a lesson the learner has not received. |
Keep whatever variables arrived with the default text and change the words around them. A variable Arist does not recognize reaches the learner exactly as you typed it, so check the spelling of each one you add.
Important: Some message types never reach WhatsApp learners. The panel tells you under Type the moment you pick one of them, and every response reminder is on that list. Those learners receive Arist's default text whatever you save.
6. Edit or delete a system message
Select the three-dot menu at the end of a row to reach Edit and Delete, or select the message type to open the same edit panel. Edit offers the same three fields and Save applies your changes, so you can retype a message or move it to a different language without starting over. A change takes effect on the next message Arist sends, including for learners who are already part way through a course.
Select the checkboxes at the left of the rows to work on several at once, then choose Delete in the bar that appears. Deleting never leaves a gap, because that type falls back to Arist's own wording in that language. Deleting is also how you undo a change you no longer want.
Tip: Copy your current wording somewhere before you rewrite a message that is already live. Deleting the row restores Arist's default rather than your previous version.
Related articles
Note: Need help at any point? Reach out to your Arist Customer Success contact, or email [email protected].



