Creating Exercises
Videos and some interface labels may appear in their original language.
Exercise Creator: User Guide
Section titled “Exercise Creator: User Guide”This guide explains how to use Slingui’s exercise creation page. It helps teachers and content creators build exercises manually or with support from AI Chat, review the result in the preview, and save the exercise safely.
Button, tab, field, and interface message names appear in this guide in the UI’s original language, English, such as AI Chat, Exercise Overview, Edit Question, Save, and Review and finish.
Overview
Section titled “Overview”The exercise creation page lets you create, edit, duplicate, review, and save custom exercises for your school.
With it, you can:
- Create an exercise from scratch using
Exercise OverviewandEdit Question. - Create an exercise with help from
AI Chat. - Generate images for questions.
- Upload images and audio.
- Generate audio with one or two voices.
- Generate reading passages for
Readingexercises. - Automatically classify grammar, vocabulary, and difficulty with AI.
- Save progress with
Save. - Publish or save as unpublished using
Published. - Review and save the final exercise with
Review and finish. - Find previously created exercises in
My exercises. - Duplicate an existing exercise with
Duplicate exercise.
This guide does not cover Journeys and Pathways.
Understand the Main Screen
Section titled “Understand the Main Screen”The Exercise Creator screen has two main areas.
Settings Column: on the left, containing the creation and editing tabs.
Preview Column: on the right, showing a preview of what the student will see.
Header
Section titled “Header”At the top of the left column, you will see the New Exercise title and a menu with additional actions.
Useful menu options:
Settings: opens global image and audio settings.Restart: restarts the current exercise. The interface warns that unsaved progress will be lost.My exercises: opens the screen for finding and editing previously created exercises.Duplicate exercise: lets you load a copy from an exercise ID or link.
Exercise creation is organized into three tabs.
| Tab | Purpose |
|---|---|
AI Chat | Create or update the exercise by chatting with AI. |
Exercise Overview | Edit general exercise information and manage the question list. |
Edit Question | Edit the content of a specific question. |
Footer buttons
Section titled “Footer buttons”Two buttons appear at the bottom of the left column when you are in Exercise Overview or Edit Question.
Save: saves current progress as a draft. Use it during creation to avoid losing work.
Review and finish: validates and saves the final exercise. Use this button when the exercise is ready.
These buttons are hidden while you are using AI Chat.
Preview
Section titled “Preview”The preview shows a simulation of the exercise.
When you are in Exercise Overview, the preview shows the exercise’s start screen with:
- cover image or default banner
- title
- description
- number of questions
- CEFR level
Let's Startbutton
When you are in Edit Question, the preview shows the selected question with a layout similar to the student experience.
The preview may display:
BackSkipConfirm- multiple-choice options
- written-answer field
- audio player
- question image
- reading passage
Start recordingbutton forRecord Voice
Important: the preview is only a simulation. Actions such as clicking options, Confirm, or Start recording do not record actual answers.
Global Settings
Section titled “Global Settings”Open Settings in the top menu to access Global Settings.
These settings define the defaults used when generating images or audio. You can still adjust images and audio individually for each question.
Image Generation
Section titled “Image Generation”In Image Generation, you configure defaults for AI-generated images.
Default Style sets the default visual style.
Options:
| Option | Recommended use |
|---|---|
Vector Art | Clean, simple, educational illustrations. |
Photorealistic | Realistic-looking images. |
Cartoon | Colorful, more playful visuals. |
Editorial | Conceptual illustrations with an editorial look. |
Low-poly 3D | Simplified 3D visuals with geometric shapes. |
Default Aspect Ratio sets the default image format.
Options:
| Option | Format |
|---|---|
1:1 (Square) | Square image. |
4:3 (Landscape) | Standard landscape image. |
16:9 (Wide) | Wide landscape image. |
Remove Background by Default generates an image with a transparent background when possible. The interface itself states: Note: This increases image generation time.
Audio Generation
Section titled “Audio Generation”In Audio Generation, you configure defaults for AI-generated audio.
Default Voice sets the default voice. The Alternate (Achernar/Achird) option alternates voices between questions, which helps with exercises involving multiple lines of speech or listening variety.
Default Speaking Rate (0.25 - 4.0) sets the speaking speed. Use values close to 1 for natural speech. Lower values slow speech down. Higher values speed it up.
Save or restore settings
Section titled “Save or restore settings”Use Save Settings to save your preferences.
Use Restore Defaults to return to the interface defaults.
AI Credits
Section titled “AI Credits”Some Exercise Creator actions use AI and consume credits. These credits are an internal unit used to track monthly usage of features such as exercise, image, audio, and text generation, and automatic classification.
Usage is not a fixed amount per exercise. It depends on the type of action performed and the volume processed, such as prompt length, response length, number of images generated, number of audio clips generated, and the length of texts used for audio or classification.
Actions that consume credits
Section titled “Actions that consume credits”These Exercise Creator actions may consume AI credits:
| Interface action | What happens |
|---|---|
AI Chat | Generates or updates the exercise plan. |
Requesting images in AI Chat | Generates images for questions that have an image description. |
Regenerate images in chat | Regenerates images for questions with imageDescription. |
Generate in Image | Generates an image for the current question. |
Generate in Audio | Generates single-speaker audio for the current question. |
Create Dialogue and Generate Audio | Generates two-speaker audio. |
Generate Dialogue Lines | Uses AI to create structured dialogue lines. |
Generate Reading Text | Generates a formatted reading passage. |
Select terms automatically using AI | Classifies the exercise’s grammar, vocabulary, and difficulty. |
Automatic classification after AI Chat | Analyzes the generated exercise and fills in grammar, vocabulary, and difficulty when possible. |
Each generation counts separately. For example, if an exercise has 5 questions and you request images for all of them, generating the exercise plan consumes credits and each generated image may also consume credits.
Actions that do not consume AI credits
Section titled “Actions that do not consume AI credits”These actions do not use AI directly and do not consume AI credits:
- Manually editing the title, description, questions, answers, and options.
- Adding questions with
+ Add Question. - Reordering questions.
- Selecting
Mark Question as Completed. - Manually uploading with
Upload Image,UploadinImage, orUploadinAudio. - Copying media with
Copy from.... - Saving a draft with
Save. - Saving the final exercise with
Review and finish. - Opening, searching for, or editing exercises in
My exercises. - Duplicating exercises with
Duplicate exercise.
Note: attaching a file or pasting a URL into AI Chat prepares that material for use by AI. Preparing the attachment does not directly record credits, but generating an exercise using that material may consume credits.
How credits are calculated
Section titled “How credits are calculated”Slingui calculates credits from the actual usage returned by AI providers.
In practical terms:
- generated or analyzed text is charged based on input and output tokens
- images use image-generation usage data
- audio uses voice-model usage data
- automatic classification uses input and output tokens
- longer texts, longer prompts, and longer responses tend to consume more credits
- generating multiple images or audio clips increases total usage
You do not need to calculate this manually. Use the AI Usage page to track recorded usage.
Monthly limits
Section titled “Monthly limits”The system may have a monthly credit limit for the user, the school, or both.
Before performing an AI action, Slingui checks whether the user or school has already reached the configured monthly limit.
If the limit has already been reached, new AI actions may be blocked. Depending on the action, the interface may show a generation error message, such as a failure to generate content, an image, or audio.
The check takes place before the AI call. This means an action can start while there is still allowance available and, after completion, cause the monthly total to exceed the limit.
How to track usage
Section titled “How to track usage”Use the AI Usage page to track credit usage.
To open it:
- Use the side navigation in the exercises area.
- Click
AI Usage. - Choose the month in
Select Month:. - Choose the year.
- Use
Refreshto update the data.
The AI Usage Summary screen shows:
Total Credits Used- daily usage chart
- breakdown by feature, such as
Create ExerciseandAI Tutor - daily details
- details by user, feature, and usage type
Click a chart bar in Daily Usage to see details for that day.
Report scope
Section titled “Report scope”What you see in AI Usage depends on your role.
| Role | What the screen shows |
|---|---|
| Student | Personal AI usage. |
| Independent teacher | Usage by the teacher and their students. |
| School owner | Usage across the entire school, including teachers and students. |
| School teacher | Usage by the teacher and students assigned to them. |
The screen itself displays a message explaining the scope, such as Showing your personal AI usage. or Showing AI usage for your entire organization (teachers and students). (usage across your entire school, including teachers and students).
Best practices for saving credits
Section titled “Best practices for saving credits”Review your prompt before sending it in AI Chat.
Clearly specify the language, level, number of questions, and exercise type to avoid unnecessary regeneration.
Generate images only after the questions are close to their final version.
Generate audio only after reviewing Audio Script.
Use Copy from... when multiple questions can share the same image, audio, or reading passage.
Avoid clicking Generate multiple times while the first generation is still running.
Use Save to save progress manually. Save does not consume AI credits.
If an AI action fails
Section titled “If an AI action fails”If an AI action fails, try:
- reviewing the prompt
- reducing the size of the request
- generating fewer images at once
- generating audio after reviewing the scripts
- checking the
AI Usagepage - trying again later
- contacting your school’s administrator if you suspect the monthly limit has been reached
Some calls may consume credits when the AI provider returns a response, even if you later decide not to use the result. For this reason, review content before requesting new generations.
Create an Exercise with AI Chat
Section titled “Create an Exercise with AI Chat”AI Chat is the quickest way to get started. It collects a few preferences, generates an exercise plan, and fills in the structure for you to review.
Even when using AI, always review the final content. The interface itself displays the warning: Slingui AI can make mistakes. Please consider reviewing exercises created.
Step by Step
Section titled “Step by Step”- Open the
AI Chattab. - Answer the initial question about the exercise’s target language.
- Choose how many questions the exercise should have.
- Choose the CEFR level.
- Specify whether you want to generate images for the questions.
- Describe your exercise idea.
- Wait for the plan to be generated.
- Review the exercise in
Exercise Overview. - Adjust each question in
Edit Question. - Use
Review and finishwhen ready.
Quick suggestions
Section titled “Quick suggestions”The chat displays suggestions at certain points.
Examples:
- Languages such as
English (US),Spanish (Spain), andPortuguese (Brazil). - Numbers such as
3,4,5,10, andAny. - Levels such as
A0,A1,A2,B1,B2,C1,C2, andAny. YesandNoanswers for image generation.- Ideas such as
Travel vocabulary,Business meeting,Daily routine,Present Perfect grammar, andRestaurant dialogue.
You can click a suggestion or type your own answer.
Use attachments and links
Section titled “Use attachments and links”AI Chat accepts attachments and URLs to help AI create content based on existing materials.
You can attach:
- images
- videos
- audio
- PDFs
.txtfiles
The current local file limit is 50 MB.
You can also paste links into the chat field.
YouTube links, such as youtube.com and youtu.be, are treated as YouTube content.
Other http or https links are used as reference URLs.
What AI generates
Section titled “What AI generates”Depending on your request, AI may fill in:
Exercise TitleDescriptionLanguageSkillQuestion TypeOpen Questions- questions
- correct answers
- options
- audio scripts
- image descriptions
- reading passages for
Reading - grammar, vocabulary, and difficulty through automatic classification
If you requested images, AI attempts to generate images for questions that have imageDescription.
If questions have audioScript, the interface attempts to generate audio automatically.
After generation, the chat usually directs you to open Exercise Overview to review the exercise.
Update an exercise with chat
Section titled “Update an exercise with chat”After an exercise has been generated or loaded, you can continue using AI Chat to request changes.
Example requests:
Make the questions easier.Change the topic to airport travel.Turn this into a Multiple Choice exercise.Add more business vocabulary.Regenerate images.Regenerate audio.
When you request a content update, AI returns the complete updated exercise structure. Always review the result in Exercise Overview and Edit Question.
When you request image or audio regeneration, the interface uses the current Global Settings.
Prompt best practices
Section titled “Prompt best practices”A good AI Chat request includes the objective, audience, level, and question type.
Example:
Create a B1 English (US) listening exercise with 5 Dictation questions about checking into a hotel. Use natural travel vocabulary and generate audio.Another example:
Create an A2 Spanish (Mexico) Complete the sentence exercise about daily routines. Focus on present tense verbs and include one blank in each question.If you already know the question type you want, mention the UI name, such as Text Answer, Multiple Choice, Put words in order, Complete the sentence, Dictation, or Record Voice.
Create an Exercise Manually
Section titled “Create an Exercise Manually”Manual creation takes place mainly in Exercise Overview and Edit Question.
Use Exercise Overview to configure the exercise as a whole.
Use Edit Question to edit one question at a time.
Quick Step-by-Step Guide
Section titled “Quick Step-by-Step Guide”- Open
Exercise Overview. - Fill in
Exercise Title. - Fill in
Description. - Choose
Language. - Choose
Skill. - Choose
Question Type. - Enable or disable
Open Questionswhen the type allows it. - Choose
Level. - Choose
Difficulty. - Select
Vocabulary. - Select
Grammar Point (Primary focus). - Optionally select
Grammar Point (Secondary focus). - Click
+ Add Question. - Open the question in
Edit Question. - Fill in instructions, text, answers, and additional content.
- Review it in the preview.
- Select
Mark Question as Completedif you want to track your progress. - Repeat for all questions.
- Click
Review and finish.
Exercise Overview
Section titled “Exercise Overview”Exercise Overview contains the general settings and question list.
Published
Section titled “Published”The Published toggle determines whether the exercise will be saved as published.
When Published is enabled, the exercise is saved as published.
When Published is disabled, the exercise is saved as unpublished and appears as Unpublished in My exercises.
Before the final save, the interface confirms: This exercise will be saved as published. or This exercise will be saved as unpublished.
Exercise Title
Section titled “Exercise Title”Use a clear, easily recognizable title.
Examples:
Present Perfect PracticeRestaurant DialogueA2 Daily Routine VocabularyHotel Check-in Dictation
The title is required.
Description
Section titled “Description”Use the description to explain the exercise’s objective or guide the student.
Examples:
Practice using the present perfect in short answers.Listen and write what you hear about hotel reservations.Complete each sentence with the correct daily routine verb.
The description is required.
Exercise Cover
Section titled “Exercise Cover”Use Exercise Cover to add a cover image.
Click Upload Image and choose an image file.
During upload, the interface may show Uploading..., Uploaded!, or Upload failed.
The cover is optional, but helps students identify the exercise’s topic.
Language
Section titled “Language”Language sets the exercise’s target language.
Options available in the UI:
English (US)English (UK)Spanish (Spain)Spanish (Mexico)French (France)French (Canada)GermanItalianPortuguese (Brazil)Chinese (Mandarin, Simplified)JapaneseKorean
The language is required.
When you switch to a different language family, the interface clears Vocabulary, Grammar Point (Primary focus), and Grammar Point (Secondary focus) to avoid mixing incompatible classifications.
Example: if you switch from English (US) to Spanish (Spain), the selected grammar and vocabulary points are cleared.
Skill sets the exercise’s main skill.
Options:
GrammarListeningReadingPronunciation
The skill is required.
See the Skills section of this guide to understand each type.
Question Type
Section titled “Question Type”Question Type defines how students will answer the questions.
Options:
Text AnswerMultiple ChoicePut words in orderComplete the sentenceDictationRecord Voice
The question type is required.
Important rule: all questions in the same exercise must have the same Question Type.
If you change Question Type in Exercise Overview, the interface updates the type of every question already created. For this reason, choose the type before creating many questions whenever possible.
In Edit Question, the Question Type field is disabled. If you try to click it, the interface warns: This field must be edited on the "Exercise Overview" tab.
Open Questions
Section titled “Open Questions”Open Questions turns the exercise into open-ended questions, with no correct answer saved for automatic grading.
Types that can use Open Questions:
Text AnswerPut words in orderComplete the sentence
Types that cannot use Open Questions:
Multiple ChoiceDictationRecord Voice
When you select Multiple Choice, Dictation, or Record Voice, the Open Questions toggle is disabled.
When Open Questions is enabled, all questions must also have Open Questions enabled. The interface keeps this synchronized when you use the toggle in Exercise Overview.
Level sets the exercise’s CEFR level.
Options:
| Level | General use |
|---|---|
A0 | First exposure to the language. |
A1 | Beginner. |
A2 | Elementary. |
B1 | Intermediate. |
B2 | Upper-intermediate. |
C1 | Advanced. |
C2 | Proficient. |
The level is required.
Difficulty
Section titled “Difficulty”Difficulty sets the exercise’s difficulty within the chosen level.
Options:
| Difficulty | General use |
|---|---|
Easy | Straightforward questions, familiar language, and little ambiguity. |
Medium | More context, more vocabulary, or less obvious choices. |
Hard | More nuance, more demanding answers, or denser content. |
The difficulty is required.
Vocabulary
Section titled “Vocabulary”Vocabulary sets the exercise’s vocabulary tags.
Click the Vocabulary field to open Select Vocabulary.
In the modal, select one or more tags and click Save.
Use Cancel or the close button to leave without applying changes.
At least one vocabulary tag is required to save the final exercise.
Vocabulary options are organized into groups such as basic vocabulary, daily life, work, school, travel, and celebrations. The names displayed may vary depending on the selected language.
Grammar Point (Primary focus)
Section titled “Grammar Point (Primary focus)”Grammar Point (Primary focus) indicates the exercise’s main grammar focus.
Click the field to open Select Grammar (Primary).
Select one or more terms and click Save.
At least one primary grammar point is required.
Use this field to indicate what the exercise is designed to practice.
Examples:
Present SimplePresent PerfectModals of Obligation (must, have to)Vocabulary Focus
Grammar Point (Secondary focus)
Section titled “Grammar Point (Secondary focus)”Grammar Point (Secondary focus) indicates other grammar points present in the exercise that are not its main objective.
Click the field to open Select Grammar (Secondary).
This field is optional.
Use it when the exercise practices one main structure but also exposes the student to other structures.
Example: an exercise focused on Present Perfect may have Past Simple as a secondary focus.
Grammar taxonomies by language
Section titled “Grammar taxonomies by language”Grammar options depend on the language family.
English (US) and English (UK) use the English grammar taxonomy.
Spanish (Spain) and Spanish (Mexico) use the Spanish grammar taxonomy.
Other languages currently use the English grammar list until new language-specific taxonomies are added.
Select terms automatically using AI
Section titled “Select terms automatically using AI”The Select terms automatically using AI button analyzes the exercise’s title, description, and questions to suggest:
Grammar Point (Primary focus)Grammar Point (Secondary focus)VocabularyDifficulty
During analysis, the button may show Thinking....
Use this button after adding content to the exercise. AI classifies more effectively when the title, description, and questions are filled in.
Even when using automatic classification, review the selected terms before saving.
Pack lets you associate the exercise with one or more existing packs.
Click the field to open Manage Packs.
In the modal, you can:
- Select existing packs.
- Create a pack using
New Pack NameandCreate Pack. - Edit a pack’s name with
Edit Name. - Delete a pack with
Delete. - Close using
Done.
Pack is optional when creating an exercise. Use it if your school groups exercises into collections.
Question list
Section titled “Question list”The Questions section shows every question in the exercise.
Each item shows:
- question number
- question type
- question text or
New Question CompletedorIncompletestatus
To add a question, click + Add Question.
To edit a question, click its list item. The interface switches to Edit Question.
To reorder questions, drag an item using its drag handle.
Edit Question
Section titled “Edit Question”Edit Question lets you edit one question at a time.
If there are no questions yet, the tab displays No questions yet and directs you to create a question in Exercise Overview.
Basic Info
Section titled “Basic Info”In Basic Info, you see the question type and whether it uses Open Questions.
These two fields are locked in Edit Question because they must be changed in Exercise Overview.
Question Instruction
Section titled “Question Instruction”Question Instruction is the instruction shown to the student.
Examples:
Choose the correct optionAnswer the questionComplete the sentenceListen and write what you hearPut the words in the correct orderListen and repeat
This field is optional for saving, but recommended for instructional clarity.
Question Text
Section titled “Question Text”Question Text is the question’s main text.
It appears in several question types, but not in the same way for all of them.
In Dictation, the focus is on the audio and the Script / Correct Answer field.
In Put words in order, the correct sentence goes in Sentence to Order, and the shuffled words appear in Scrambled Words.
Answers and options
Section titled “Answers and options”Each Question Type has its own answer fields.
Examples:
Text AnswerusesCorrect Answers (Acceptable variations).Multiple ChoiceusesOptionsand one option marked as correct.Put words in orderusesSentence to OrderandScrambled Words.Complete the sentenceusesCorrect Answersand_in the text.DictationusesScript / Correct Answer.Record VoiceusesScript / Correct Answer.
See the Question Type section for details and validation rules.
Additional Content per Question
Section titled “Additional Content per Question”In addition to text and answers, each question can have additional content.
Reading Text
Section titled “Reading Text”Reading Text appears only when the exercise’s skill is Reading.
Use this feature to add rich text that students should read before answering.
In the question, you will see:
Reading TextCreate TextbuttonCopy from...selector
Clicking Create Text opens Edit Reading Text.
In the modal, you can:
- Write an idea in
Prompt / Idea for Reading Text. - Click
Generate Reading Text. - Edit the generated content in the
Reading Texteditor. - Click
Save. - Click
Cancelto discard it.
The reading passage supports formatting such as headings, bold, italics, underline, and lists.
Use Copy from... to copy the reading passage from another question.
The Image section lets you generate, upload, copy, or remove a question’s image.
Fields and actions:
Image: main section.- settings icon: opens
Image Configuration. - description field with the placeholder
Describe the image you want for this question.... Generate: generates an AI image from the description.Upload: uploads an image from your computer.Copy from...: copies the image and description from another question.×button: removes the current image.
When generating an image, write a clear description of the scene.
Good example:
A student buying a train ticket at a station counterAvoid requesting visible text within the image, such as signs, captions, numbers, and logos, unless it is truly necessary. Image generation already attempts to avoid visible text by default.
Image Configuration
Section titled “Image Configuration”In Image Configuration, you can adjust the current question’s image.
Fields:
StyleAspect RatioRemove Background
These options override the Global Settings defaults only for the current question.
The Audio section lets you generate, upload, copy, or remove a question’s audio.
Fields and actions:
Audio: main section.- settings icon: opens
Audio Configuration. Speakers: switches between 1 and 2 speakers.Script for the audio...: text to be spoken in the audio.Generate: generates single-speaker audio.Create Dialogue: opens dialogue creation whenSpeakersis set to 2.Upload: uploads an audio file.Copy from...: copies audio and script from another question.×button: removes the current audio.
For Dictation and Record Voice, the Script / Correct Answer field and Audio Script stay synchronized. Editing one updates the other in the interface.
Audio Configuration
Section titled “Audio Configuration”In Audio Configuration, you adjust the current question’s voice and speed.
Fields:
VoiceSpeaking Rate (0.25 - 4.0)
Use a slower speed for beginners and a more natural speed for intermediate and advanced levels.
Two-speaker dialogue
Section titled “Two-speaker dialogue”When Speakers is set to 2, the audio button changes to Create Dialogue.
Clicking it opens Dialogue Generation.
In the modal, you can:
- Write a prompt in
Prompt / Original Script. - Click
Generate Dialogue Lines. - Choose
Speaker A Voice. - Choose
Speaker B Voice. - Edit
Dialogue Lines. - Click
+ Add Lineto add lines manually. - Click
Generate Audioto create the final audio. - Click
Cancelto close without saving.
For dialogues, keep lines short and natural. In listening exercises, this makes comprehension practice more realistic.
Mark Question as Completed
Section titled “Mark Question as Completed”At the end of Edit Question, there is a Mark Question as Completed toggle.
This toggle helps you track which questions you have already reviewed.
It does not replace the final validation in Review and finish. Even when marked as complete, a question must still meet the required rules for the selected type.
Skills
Section titled “Skills”Skill describes the main skill the exercise develops.
It does not replace Question Type. For example, a Grammar exercise can use Multiple Choice, Text Answer, or Complete the sentence.
| Skill | When to use it | Notes |
|---|---|---|
Grammar | When the objective is to practice grammatical structures. | Combine with Complete the sentence, Text Answer, Multiple Choice, or Put words in order. |
Listening | When students need to listen to answer. | Use audio for each question. Works particularly well with Dictation and dialogues. |
Reading | When students need to read a text before answering. | Enables the Reading Text section in Edit Question. |
Pronunciation | When students need to listen and repeat. | Usually paired with Record Voice. In the system, this skill is saved internally as speaking. |
Grammar
Section titled “Grammar”Use Grammar for exercises focused on a structure, verb tense, question form, word order, or another grammar point.
Examples:
- present simple
- past simple
- modals of obligation
- articles
- conditionals
- comparison
Even in a grammar exercise, also select Vocabulary and Grammar Point (Primary focus), as these fields are required to save.
Listening
Section titled “Listening”Use Listening when audio is essential to answering.
Examples:
- students listen to a sentence and choose the correct option
- students listen and write what they hear
- students answer questions about a dialogue
Recommendations:
- Fill in
Audio Scriptclearly. - Generate or upload audio for each question.
- Use
Dictationwhen students need to transcribe. - Use dialogues with 2 speakers for communicative situations.
Reading
Section titled “Reading”Use Reading when students need to read a text to answer.
This skill enables the Reading Text section in Edit Question.
Recommendations:
- Use short texts for
A0,A1, andA2. - Use longer texts or texts requiring inference for
B1,B2,C1, andC2. - Combine with
Multiple Choice,Text Answer, orComplete the sentence.
Pronunciation
Section titled “Pronunciation”Use Pronunciation when the objective is for students to listen and repeat.
The most common type for this skill is Record Voice.
Recommendations:
- Keep sentences short.
- Make sure
Question Text,Script / Correct Answer, andAudio Scriptmake sense together. - Generate clear audio to serve as a model.
Question Type
Section titled “Question Type”Question Type defines the student’s answer format.
Every exercise must have a single question type. The interface and final save reject exercises containing questions of different types.
Summary of types
Section titled “Summary of types”| UI | Internal type | Allows Open Questions | Main use |
|---|---|---|---|
Text Answer | write-answer | Yes | Short or open-ended written answers. |
Multiple Choice | choose-answer | No | Choosing between options. |
Put words in order | write-put-in-order | Yes | Ordering words to form a sentence. |
Complete the sentence | write-complete | Yes | Filling in blanks marked with _. |
Dictation | dictation-write-answer | No | Listening and writing what was said. |
Record Voice | read-listen-repeat | No | Listening and repeating while recording your voice. |
Text Answer
Section titled “Text Answer”Use Text Answer when students should type an answer.
This type is flexible and can be used for vocabulary, grammar, reading comprehension, or short answers.
Main fields
Section titled “Main fields”Question InstructionQuestion TextCorrect Answers (Acceptable variations)+ Add an answer
Answers are displayed as chips. You can edit or delete each answer using the chip’s edit icon.
Accepted answers
Section titled “Accepted answers”For questions that are not open-ended, all answers listed in Correct Answers (Acceptable variations) are accepted as correct.
Example:
| Field | Example |
|---|---|
Question Text | What is the opposite of hot? |
Correct Answers (Acceptable variations) | cold, Cold |
With Open Questions
Section titled “With Open Questions”Text Answer can be used with Open Questions.
When Open Questions is enabled, you do not need to fill in correct answers.
Use it for subjective, reflective, or free-production questions.
Example:
Describe your ideal vacation in three sentences.Final validation
Section titled “Final validation”To save Text Answer without Open Questions:
- there must be at least one correct answer.
- all questions must have the same type.
question.openQuestionsmust matchexercise.openQuestions.
To save Text Answer with Open Questions:
- a correct answer is not required.
- answers are saved as empty.
Multiple Choice
Section titled “Multiple Choice”Use Multiple Choice when students should choose the correct answer from a set of options.
Main fields
Section titled “Main fields”Question InstructionQuestion TextOptions+ Add an option
Click an option to mark it as the correct answer.
The correct option is visually highlighted.
Example
Section titled “Example”| Field | Example |
|---|---|
Question Text | Choose the correct sentence. |
Options | She goes to school., She go to school., She going to school. |
| correct answer | She goes to school. |
Important differences
Section titled “Important differences”Multiple Choice uses options that are visible to the student.
This type does not allow Open Questions, because grading depends on a correct option.
Final validation
Section titled “Final validation”To save Multiple Choice:
- there must be at least two nonempty options.
- a correct answer must be selected.
- the correct answer must exactly match one of the options.
Open Questionsmust be disabled.- all questions must have the same type.
Put words in order
Section titled “Put words in order”Use Put words in order when students should arrange words to form a correct sentence.
Main fields
Section titled “Main fields”Question InstructionSentence to OrderScramble WordsScrambled Words (Drag to reorder, Edit to change)+ Add Chip
Type the correct sentence in Sentence to Order and click Scramble Words.
The interface splits the sentence into words, shuffles them, and creates chips in Scrambled Words.
You can also drag chips to rearrange them or edit each chip manually.
Example
Section titled “Example”| Field | Example |
|---|---|
Sentence to Order | I love apples |
Scrambled Words | apples, love, I |
In the preview, students see a word bank and type their answer.
With Open Questions
Section titled “With Open Questions”Put words in order can be used with Open Questions.
In this case, the system does not save a final correct answer. However, the scrambled words must still be present.
Final validation
Section titled “Final validation”To save Put words in order without Open Questions:
Sentence to Ordermust contain the correct sentence.Scrambled Wordsmust contain at least two items.- internally, scrambled words must be separated by commas.
- all questions must have the same type.
To save Put words in order with Open Questions:
- a correct answer is not required.
Scrambled Wordsmust still contain at least two items.- answers are saved as empty.
Complete the sentence
Section titled “Complete the sentence”Use Complete the sentence when students should fill in a blank within a sentence.
Main fields
Section titled “Main fields”Question InstructionQuestion TextCorrect Answers+ Add an answer
Use _ in Question Text to indicate the blank.
Example:
I _ apples.Accepted answers
Section titled “Accepted answers”Add correct answers in Correct Answers.
You can include just the expected word or accepted variations, depending on the exercise’s objective.
Example:
| Field | Example |
|---|---|
Question Text | I _ apples. |
Correct Answers | like, I like apples. |
With Open Questions
Section titled “With Open Questions”Complete the sentence can be used with Open Questions.
Even so, Question Text must contain _, because the blank defines the question format.
Final validation
Section titled “Final validation”To save Complete the sentence without Open Questions:
Question Textmust contain_.- there must be at least one correct answer.
- all questions must have the same type.
To save Complete the sentence with Open Questions:
Question Textmust contain_.- a correct answer is not required.
- answers are saved as empty.
Dictation
Section titled “Dictation”Use Dictation when students should listen to audio and write exactly, or almost exactly, what they hear.
Main fields
Section titled “Main fields”Question InstructionScript / Correct AnswerAlternative Answers (Optional)+ Add an answerAudio ScriptGenerateorUploadinAudio
The Script / Correct Answer field is synchronized with Audio Script.
If you change the main text, the interface copies the value to the audio script.
Example
Section titled “Example”| Field | Example |
|---|---|
Script / Correct Answer | I would like a glass of water. |
Alternative Answers (Optional) | I'd like a glass of water. |
Audio Script | I would like a glass of water. |
Important differences
Section titled “Important differences”Dictation requires audio or an audio script because students need to listen before answering.
This type does not allow Open Questions.
Final validation
Section titled “Final validation”To save Dictation:
Open Questionsmust be disabled.- there must be a correct answer or a script that can be used as the answer.
scriptoraudioScriptis required.- alternative answers are accepted as additional answers.
- all questions must have the same type.
Record Voice
Section titled “Record Voice”Use Record Voice when students should listen to a sentence and repeat it aloud.
This type is particularly useful for Pronunciation.
Main fields
Section titled “Main fields”Question InstructionQuestion TextScript / Correct AnswerAudio ScriptGenerateorUploadinAudio
The Script / Correct Answer field is synchronized with Audio Script.
In the preview, students see the Start recording button.
Example
Section titled “Example”| Field | Example |
|---|---|
Question Text | The weather is beautiful today. |
Script / Correct Answer | The weather is beautiful today. |
Audio Script | The weather is beautiful today. |
Important differences
Section titled “Important differences”Record Voice is not an open-ended question. The objective is to repeat an audio model.
AI attempts to keep answer, text, and audioScript identical for this type, unless you request something different.
Final validation
Section titled “Final validation”To save Record Voice:
Open Questionsmust be disabled.- there must be an answer, text, or script indicating what students should repeat.
scriptoraudioScriptis required.- all questions must have the same type.
Open Questions
Section titled “Open Questions”Open Questions is useful when there is no single correct answer.
Use it for:
- personal answers
- free production
- reflections
- short creative writing
- open-ended comprehension questions
Allowed types:
Text AnswerPut words in orderComplete the sentence
Blocked types:
Multiple ChoiceDictationRecord Voice
When Open Questions is enabled, the final save forces question answers to an empty list.
This means the question will have no correct answers saved for automatic validation.
Save Progress with Save
Section titled “Save Progress with Save”Use Save to save progress while you are still creating.
This button does not perform the final exercise save. It works as a draft.
When you click it, the interface may show:
Saving...Saved!Error
You must be logged in to save progress. If you are not, the interface displays Login required.
Use Save before long breaks or before making major changes to the exercise.
Save the Final Version with Review and finish
Section titled “Save the Final Version with Review and finish”Use Review and finish when the exercise is ready for its final save.
When clicked, the interface validates the exercise and displays messages if anything is missing.
If the initial validation passes, the Save exercise? confirmation appears with the Save Exercise button.
After a successful save, the interface displays Saved and finished.
What happens during the final save
Section titled “What happens during the final save”During the final save, the system:
- validates required fields
- validates consistency between the exercise and its questions
- validates rules specific to each
Question Type - validates language, skill, level, and difficulty
- validates vocabulary tags
- validates grammar points
- validates images and audio
- copies final media to permanent storage
- saves the exercise
- updates selected packs, if any
- removes the progress saved as a draft
Final Validation
Section titled “Final Validation”Final validation ensures that students can use the exercise correctly.
Some validation takes place immediately in the interface. Other checks take place on the server during Review and finish.
Required exercise fields
Section titled “Required exercise fields”Before saving, fill in:
Exercise TitleDescriptionLanguageSkillQuestion TypeLevelDifficultyVocabulary, with at least one tagGrammar Point (Primary focus), with at least one item- at least one question
Consistency rules
Section titled “Consistency rules”The exercise must also meet these rules:
- all questions must have the same
Question Type - all questions must have the same
Open Questionsstate as the exercise Multiple Choice,Dictation, andRecord Voicecannot useOpen Questions
Validation by type
Section titled “Validation by type”| Type | Main validation rules |
|---|---|
Text Answer | Requires at least one correct answer, unless Open Questions is enabled. |
Multiple Choice | Requires at least two options and a correct answer, and that answer must be one of the options. |
Put words in order | Requires a correct sentence when not open-ended and at least two items in Scrambled Words. |
Complete the sentence | Question Text must contain _, and a correct answer is required when not open-ended. |
Dictation | Requires an answer or script, and script or audioScript is mandatory. |
Record Voice | Requires an answer, text, or script, and script or audioScript is mandatory. |
Media validation
Section titled “Media validation”Images and audio are also validated during the final save.
For images:
- accepted formats include PNG, JPG, WEBP, GIF, and BMP
- SVG is not supported
- the image must be valid and decodable
- the image must not be corrupted
- the image must be no larger than 10 MB
For audio:
- the file must be in a supported audio format
- the audio must not be corrupted
- the audio must have a valid duration
- the duration must be between 0.2 and 300 seconds
- the audio must be no larger than 25 MB
For media URLs:
- they must use
httporhttps - they must be accessible during saving
- temporary browser URLs, such as
blob:, are rejected
If there is a media error, the interface attempts to show a friendlier message, such as Cover image, Question 1 image, or Question 2 audio, to indicate where to make the correction.
Duplicate exercise
Section titled “Duplicate exercise”Use Duplicate exercise to create a copy of an existing exercise.
Step by step:
- Open the menu at the top of the page.
- Click
Duplicate exercise. - Paste an exercise ID or link into the
Exercise ID or linkfield. - Click
Duplicate.
The interface accepts links with the exerciseId parameter, including playground and assign links. The modal states: Accepted links include playground and assign URLs with an exerciseId parameter.
When duplicated, the loaded exercise no longer has its original ID. When you save it, it will be created as a new exercise.
Packs selected in the original exercise are not retained in the duplicate.
If the ID or link is incorrect, the interface displays Unable to load exercise.
Restart
Section titled “Restart”Use Restart to clear the current exercise and start again.
When clicked, the interface asks Restart exercise? and states All unsaved progress will be lost.
Confirm only if you really want to discard anything that has not yet been saved.
My exercises
Section titled “My exercises”My exercises lets you find, review, and edit exercises created by your school.
For users with administrative permission to create official content, My exercises lists official Slingui exercises.
Open My exercises
Section titled “Open My exercises”Step by step:
- Open the menu at the top of the page.
- Click
My exercises. - Use search, filters, or cards to find an exercise.
The header may show a description such as:
Search and manage exercises created by your organization.(exercises created by your school).Search and manage official Slingui exercises.
Search
Section titled “Search”Use the Search exercises... field to search by title, description, or tags.
Search updates automatically as you type.
Filters
Section titled “Filters”My exercises provides the following filters.
| Filter | Purpose |
|---|---|
Language | Filters by language family. |
Skill | Filters by Grammar, Listening, Reading, or Pronunciation. |
CEFR | Filters by level from A0 to C2. |
Grammar | Filters by grammar points. |
Difficulty | Filters by Easy, Medium, or Hard. |
Type | Filters by Question Type. |
Vocabulary | Filters by vocabulary tags. |
Author | Shows the fixed source of the listed exercises. |
Pictures | Shows only exercises with an image. |
Open Questions | Shows only exercises with open-ended questions. |
Use Clear all to clear active filters. The Author filter remains set to your school or Slingui, because My exercises always lists this fixed collection.
Language filter
Section titled “Language filter”The Language filter works by language family.
Examples:
- selecting
Englishsearchesen-USanden-GB - selecting
Spanishsearcheses-ESandes-MX - selecting
Portuguesesearchespt-BR
You can choose only one language family at a time.
Changing Language clears the Grammar and Vocabulary filters.
Grammar and Vocabulary filters
Section titled “Grammar and Vocabulary filters”Grammar and Vocabulary become available only after you select Language.
If you click Grammar or Vocabulary before selecting a language, the interface displays Select Language first.
This happens because grammar and vocabulary options depend on the selected language family.
Author filter
Section titled “Author filter”The Author filter is fixed in My exercises.
For regular users, it shows exercises from your school.
For official-content administrators, it shows Slingui exercises.
When you open the filter, the interface explains:
My exercises always shows exercises from your organization.(exercises from your school).My exercises lists official Slingui exercises for admins.
Exercise cards
Section titled “Exercise cards”Each card may show:
PublishedorUnpublishedstatus- title
- description
- vocabulary tags
- grammar tags
- CEFR level
- difficulty
- image icon when the exercise has an image
- number of questions, such as
5 qs Open questionsindicator, when applicable
Cards for your school’s exercises may display the school’s visual identity.
Card actions
Section titled “Card actions”Open the three-dot menu on a card to see its actions.
Available actions:
| Action | What it does |
|---|---|
Open in playground | Opens the exercise in a new playground tab. |
Edit exercise | Loads the exercise in the creator for editing. |
Copy exercise ID | Copies the exercise ID to the clipboard. |
When you use Edit exercise, the exercise loads in Exercise Overview.
If you are the exercise’s author, saving will update the same exercise.
If you are not the author, the exercise loads as a copy and the next save creates a new exercise.
Recommended Review Workflow
Section titled “Recommended Review Workflow”Before clicking Review and finish, carry out this review.
- Check
Exercise TitleandDescription. - Confirm
Language,Skill,Question Type,Level, andDifficulty. - Check that
Publishedis in the desired state. - Confirm at least one tag in
Vocabulary. - Confirm at least one item in
Grammar Point (Primary focus). - Open each question in
Edit Question. - Check
Question Instructionand the text visible to students. - Check answers, options, scripts, images, and audio.
- Use the preview to simulate the student experience.
- Regenerate any problematic media before the final save.
- Click
Saveif you want to save progress before the final version. - Click
Review and finishwhen everything is ready.
Best Practices
Section titled “Best Practices”Choose Question Type before creating many questions, because the type applies to the entire exercise.
Use AI Chat to generate a first version, then review it manually.
Generate images and audio after texts and scripts are stable. This avoids regenerating media repeatedly.
Use Select terms automatically using AI after the exercise has enough content.
Keep Question Instruction simple and consistent across questions.
In Multiple Choice, avoid very similar options for beginner levels.
In Dictation, keep the audio faithful to Script / Correct Answer.
In Record Voice, use short, natural sentences.
In Complete the sentence, check that each question has at least one _.
In Put words in order, prefer Scramble Words over assembling the words manually.
Use Preview to check layout, images, audio, reading, and navigation between questions.
Use Save as a draft during creation and Review and finish only for the final version.
Common Problems
Section titled “Common Problems”I cannot save: required fields are missing
Section titled “I cannot save: required fields are missing”Check that you have filled in:
Exercise TitleDescriptionLanguageSkillQuestion TypeLevelDifficultyVocabularyGrammar Point (Primary focus)- at least one question
The interface says Correct answer required
Section titled “The interface says Correct answer required”A question without Open Questions is missing a correct answer.
Check the type being used:
- in
Text Answer, add at least one answer inCorrect Answers (Acceptable variations) - in
Complete the sentence, add at least one answer inCorrect Answers - in
Multiple Choice, select a correct option - in
Put words in order, fill inSentence to Order - in
Dictation, fill inScript / Correct Answer - in
Record Voice, fill inScript / Correct Answer
Multiple Choice, Dictation, or Record Voice will not let me enable Open Questions
Section titled “Multiple Choice, Dictation, or Record Voice will not let me enable Open Questions”This is expected behavior.
These types do not support Open Questions because they depend on an answer, audio, repetition, or a correct option.
Error in Complete the sentence
Section titled “Error in Complete the sentence”Make sure Question Text contains _.
Correct example:
She _ to school every day.Error in Put words in order
Section titled “Error in Put words in order”Make sure there is a correct sentence in Sentence to Order and at least two chips in Scrambled Words.
Click Scramble Words again if necessary.
Image or audio error when saving
Section titled “Image or audio error when saving”The media may be corrupted, inaccessible, too large, or in an unsupported format.
Try:
- generating the image again with
Generate - uploading another image with
Upload - generating the audio again with
Generate - uploading another audio file with
Upload - temporarily removing the media and saving again
Grammar or Vocabulary will not open in My exercises
Section titled “Grammar or Vocabulary will not open in My exercises”Select Language first.
Then open Grammar or Vocabulary again.
I cannot find my exercise in My exercises
Section titled “I cannot find my exercise in My exercises”Try:
- clearing filters with
Clear all - checking the
Languagefilter - searching for part of the title in
Search exercises... - checking that you are searching in the correct school
- remembering that unpublished exercises appear as
Unpublished
Duplicate exercise does not load
Section titled “Duplicate exercise does not load”Check that you pasted a valid ID or a link with exerciseId.
If you are using a link, make sure it contains something like:
?exerciseId=EXERCISE_IDThe preview does not save answers
Section titled “The preview does not save answers”This is expected.
The preview is only intended to simulate the student experience during creation.
Quick Start
Section titled “Quick Start”If you want the short version for creating an exercise manually:
- Open
Exercise Overview. - Fill in the title, description, language, skill, type, level, and difficulty.
- Select
VocabularyandGrammar Point (Primary focus). - Click
+ Add Question. - Open
Edit Questionand fill in the question. - Add an image, audio, or reading passage if needed.
- Review it in the preview.
- Click
Saveto save a draft. - Click
Review and finishfor the final save.
If you want the short version with AI:
- Open
AI Chat. - Specify the language, number of questions, level, and whether you want images.
- Describe your exercise idea.
- Wait for generation.
- Review in
Exercise OverviewandEdit Question. - Adjust answers, images, audio, and classifications.
- Click
Review and finish.