Skip to main content

​
Overview

In Relaciona, teachers organize students into Class Groups. Each class group has a unique name, an automatically generated invite code, and can contain multiple students. This guide walks you through creating and configuring your first class.
Every class group automatically receives a unique 6-character invite code when created. This code is used for student enrollment and class identification.

​
Creating a New Class Group

1

Navigate to Class Creation

From your teacher dashboard, click on “Crear Grupo” (Create Group) or navigate to /crear/ to access the class creation form.
2

Enter Class Details

Fill in the required information:
  • Nombre del grupo (Class Name): Choose a descriptive name for your class (e.g., “Mathematics 2026”, “Science Group A”)
  • The class name can be up to 100 characters long
The invite code will be generated automatically when you save the class - you don’t need to create one manually.
3

Add Initial Students (Optional)

You can optionally add students during class creation:
  • Select students from the checkbox list showing all available students in the system
  • Multiple students can be selected at once
  • You can also add students later from the class detail page
The form will only show users with the student role in the selection list.
4

Save and Generate Invite Code

Click “Guardar” (Save) to create your class group.When you save:
  • The system automatically generates a unique 6-character invite code (uppercase letters and digits)
  • The code is verified for uniqueness across all class groups
  • You’re redirected to your class groups list at /mis-grupos/

​
Understanding Invite Codes

Invite codes are a key feature of Relaciona’s class management system:

Auto-Generated

Each class receives a unique 6-character code automatically when created

Unique & Verified

The system ensures no two classes share the same invite code

Alphanumeric

Codes use uppercase letters (A-Z) and digits (0-9) for easy sharing

Permanent

Once generated, the invite code remains with the class throughout its lifecycle

​
How Invite Codes Work

The invite code generation happens automatically in the ClassGroup model: 
# Source: teachers/models.py:32-38
def save(self, *args, **kwargs):
    if not self.invite_code:
        self.invite_code = generate_invite_code()
        # Uniqueness verification
        while ClassGroup.objects.filter(invite_code=self.invite_code).exists():
            self.invite_code = generate_invite_code()
    super().save(*args, **kwargs)
Students can use this code to join your class or you can use it to identify the class in system communications.

​
Class Configuration

After creating a class, you can configure additional settings:

​
Viewing Your Class

Once created, your class appears in:
  • Class List (/mis-grupos/): Shows all classes you teach
  • Class Detail (/grupo/<id>/): Displays the invite code, student roster, and learning styles

​
Managing Class Information

From the class detail page, you can:
1

Edit Class Name

Click “Editar” to modify the class name or adjust the student roster
2

View Class Statistics

Access learning style distribution (VARK results) for all students in the class
3

Monitor Student Profiles

See which students have completed their profiles and assessment questionnaires

​
Best Practices for Organizing Classes

Use Descriptive Names

Include the subject, grade level, or academic year in your class name:
  • ✅ “Biology 10th Grade - 2026”
  • ✅ “Mathematics Group A”
  • ❌ “My Class”

Start Small

Create the class first, then add students gradually as they register. You don’t need to add all students during creation.

Share Invite Codes Clearly

Display the invite code prominently to students:
  • Write it on the board
  • Include it in welcome emails
  • Add it to your course syllabus

Keep Classes Current

Create new class groups for each academic term or year to keep your student lists organized and relevant.

​
What Happens After Creation

Once your class is created:
  1. You’re assigned as the teacher - The class is linked to your teacher profile (teachers/views.py:19)
  2. Students are associated - Any selected students are added to the many-to-many relationship
  3. The invite code is stored - Your unique code is saved and displayed in the class detail view
  4. You can start tracking - Student participation in questionnaires (VARK, Chapman) and games becomes visible

​
Next Steps

Managing Students

Learn how to add, remove, and view student profiles in your class

Viewing Analytics

Understand how to track student engagement and learning styles

​
Technical Reference

Key Files:
  • Model definition: teachers/models.py:10-43
  • Creation view: teachers/views.py:10-26
  • Form configuration: teachers/forms.py:5-18
  • URL routing: teachers/urls.py:8
Database Fields:
  • name: CharField (max 100 characters)
  • teacher: ForeignKey to UserProfile
  • students: ManyToManyField to UserProfile (filtered by role=‘student’)
  • invite_code: CharField (max 10 characters, unique)

Build docs developers (and LLMs) love

Get started for freeTalk to us