docs/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/manage-classrooms.md

title, intro, permissions, versions, redirect_from

title	intro	permissions	versions	redirect_from
Manage classrooms	You can create and manage a classroom for each course that you teach using {% data variables.product.prodname_classroom %}.	Organization owners who are admins for a classroom can manage the classroom for an organization. {% data reusables.classroom.classroom-admins-link %}	fpt *	/education/manage-coursework-with-github-classroom/archive-a-classroom /education/manage-coursework-with-github-classroom/manage-classrooms

About classrooms

{% data reusables.classroom.about-classrooms %}

About management of classrooms

{% data variables.product.prodname_classroom %} uses organization accounts on {% data variables.product.github %} to manage permissions, administration, and security for each classroom that you create. Each organization can have multiple classrooms.

After you create a classroom, {% data variables.product.prodname_classroom %} will prompt you to invite teaching assistants (TAs) and admins to the classroom. Each classroom can have one or more admins. Admins can be teachers, TAs, or any other course administrator who you'd like to have control over your classrooms on {% data variables.product.prodname_classroom %}.

Invite TAs and admins to your classroom by inviting the personal accounts on {% data variables.product.github %} to your organization as organization owners and sharing the URL for your classroom. Organization owners can administer any classroom for the organization. For more information, see AUTOTITLE and AUTOTITLE.

When you're done using a classroom, you can archive the classroom and refer to the classroom, roster, and assignments later, or you can delete the classroom if you no longer need the classroom.

{% data reusables.classroom.reuse-assignment-link %}

You can also view your classrooms and assignments directly from the {% data variables.product.github %} command line interface with the {% data variables.product.prodname_classroom %} extension. For more information, see AUTOTITLE.

About classroom rosters

Each classroom has a roster. A roster is a list of identifiers for the students who participate in your course.

When you first share the URL for an assignment with a student, the student must sign into {% data variables.product.github %} with a personal account to link the personal account to an identifier for the classroom. After the student links a personal account, you can see the associated personal account in the roster. You can also see when the student accepts or submits an assignment.

Prerequisites

You must have an organization account on {% data variables.product.github %} to manage classrooms on {% data variables.product.prodname_classroom %}. For more information, see AUTOTITLE and AUTOTITLE.

You must authorize the {% data variables.product.prodname_oauth_app %} for {% data variables.product.prodname_classroom %} for your organization to manage classrooms for your organization account. For more information, see AUTOTITLE.

Creating a classroom

{% data reusables.classroom.sign-into-github-classroom %}

1. Click New classroom on the right side of the page. {% data reusables.classroom.guide-create-new-classroom %}

After you create a classroom, you can begin creating assignments for students. For more information, see AUTOTITLE, AUTOTITLE, AUTOTITLE, or AUTOTITLE.

Creating a roster for your classroom

You can create a roster of the students who participate in your course.

If your course already has a roster, you can update the students on the roster or delete the roster. For more information, see Adding a student to the roster for your classroom or Deleting a roster for a classroom.

{% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.click-students %}

1. To connect {% data variables.product.prodname_classroom %} to your LMS and import a roster, your LMS administrator will first need to register your LMS instance and then you will need to connect your LMS course to your classroom. Once connected, you can click the Import from... button to import a roster from your LMS course. For more information, see AUTOTITLE.

   Note

   {% data reusables.classroom.google-classroom-note %}

2. Provide the student identifiers for your roster.

   • To import a roster by uploading a file containing student identifiers, click Upload a CSV or text file.
   • To create a roster manually, type your student identifiers in the text field.

3. Click Create roster.

Adding students to the roster for your classroom

Your classroom must have an existing roster to add students to the roster. For more information about creating a roster, see Creating a roster for your classroom.

{% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.click-students %}

1. To the right of "Classroom roster", click Update students. If you have already linked your classroom to an LMS course, then you will see a Sync from... button instead.
2. Follow the instructions to add students to the roster.

   • To import students from an LMS, your LMS administrator will first need to register your LMS instance and then you will need to connect your LMS course to your classroom. Once connected, you can click the Sync from... button. For more information, see AUTOTITLE.

     Note

     {% data reusables.classroom.google-classroom-note %}

   • To manually add students, under "Manually add students", click Upload a CSV or text file or type the identifiers for the students, then click Add roster entries.

Renaming a classroom

{% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.click-settings %}

1. Under "Classroom name", type a new name for the classroom.
2. Click Rename classroom.

Archiving or unarchiving a classroom

You can archive a classroom that you no longer use on {% data variables.product.prodname_classroom %}. When you archive a classroom, you can't create new assignments or edit existing assignments for the classroom. Students can't accept invitations to assignments in archived classrooms.

{% data reusables.classroom.sign-into-github-classroom %}

1. To the right of a classroom's name, select the {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} dropdown menu, then click Archive.

   

2. To view an archived classroom, use the dropdown menu next to the search bar to change the view to "Archived" or "All".

3. To unarchive a classroom, to the right of a classroom's name, select the {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} drop-down menu, then click Unarchive.

   

Deleting a roster for a classroom

{% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.click-students %}

1. Below the list of students, under "Delete this roster", click Delete roster.
2. Read the warnings, then click Delete roster.

Deleting a classroom

{% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.click-settings %}

1. To the right of "Delete this classroom", click Delete classroom.
2. Read the warnings.
3. To verify that you're deleting the correct classroom, type the name of the classroom you want to delete.
4. Click Delete classroom.

Further reading

• AUTOTITLE