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

# Assignments

> Issue assignments to a class, collect student submissions with attachments and text responses, and grade them so results feed each student's grade.

Assignments are pieces of work you set for the class. You issue an assignment to a classroom, students hand in a submission (a file, a written response, or both), and you grade it. Assignment results are one of the inputs to each student's grade.

***

## Who Uses This Feature

| Role                        | What They Do                                                             |
| --------------------------- | ------------------------------------------------------------------------ |
| **Teacher**                 | Creates assignments, reviews submissions, and grades them with feedback. |
| **Classroom Administrator** | Manages assignments across all classes.                                  |
| **Student**                 | Submits work against an assignment and sees their grade and feedback.    |

***

## Before You Start

You need an **Active classroom** with a roster. Assignments are typically placed inside a section as an activity, so students find them alongside the rest of the class content.

***

## Issuing an Assignment

<Steps>
  <Step title="Create the assignment">
    Add an assignment to the classroom, giving it a title and instructions.
  </Step>

  <Step title="Attach reference material">
    Add any attachments students need to complete the work.
  </Step>

  <Step title="Place it in the class">
    Add the assignment as an activity in the relevant section so students reach it from the classroom.
  </Step>
</Steps>

### Field Guide - Assignment

| Field            | Description / Purpose                            |
| ---------------- | ------------------------------------------------ |
| **Classroom**    | The class the assignment is issued to. Required. |
| **Title**        | The name students see.                           |
| **Instructions** | What students must do.                           |
| **Attachments**  | Reference files provided with the assignment.    |

***

## Collecting Submissions

Students open the assignment from the activity page and hand in their work.

<Steps>
  <Step title="Student opens the activity">
    On `/classroom/{code}/activity/{activity}`, the student opens the assignment.
  </Step>

  <Step title="Student submits">
    They attach a file, write a text response, or both, and submit.
  </Step>

  <Step title="Teacher reviews">
    You see each submission against the assignment, with the student's attachments and response.
  </Step>
</Steps>

### Field Guide - Assignment Submission

| Field             | Description / Purpose                             |
| ----------------- | ------------------------------------------------- |
| **Assignment**    | The assignment this submission answers. Required. |
| **Student**       | The person who submitted. Required.               |
| **File**          | The attached submission file, if any.             |
| **Text response** | A written answer, if any.                         |
| **Score**         | The grade you award.                              |
| **Feedback**      | Comments returned to the student.                 |

***

## Grading and the Grade Snapshot

When you grade a submission - awarding a score and optional feedback - that student's grade snapshot recomputes automatically. Assignments carry whatever weight the classroom's grade scheme gives them relative to attendance and quizzes. See [Grading](/education/e-classroom/grading).

***

## Upstream and Downstream

* **Upstream (must exist first)**: an Active classroom with a roster; ideally a section to hold the assignment.
* **Downstream (this enables)**: graded submissions feed each student's grade.

***

## Best Practices

* Place every assignment inside a section as an activity so students find it in the normal flow of the class, not in a separate list.
* Provide clear instructions and any reference attachments up front to reduce back-and-forth.
* Grade with feedback, not just a score: the feedback is returned to the student alongside their grade.
* Grade promptly so the student's live grade reflects their real standing.