Introduction

AssignAI is a homework management platform for teachers. Create structured homework, share a single link with students, and use AI to grade submissions instantly.

No student accounts needed. Students access homework via a unique link and submit with just their name.

Quick Setup

1. Create a free account at /signup
2. Create a class and add your students
3. Create your first homework assignment
4. Copy the student link and share it with your class
5. View submissions from your dashboard

Dashboard Overview

The dashboard shows all your homework assignments as cards. Each card displays:

• Homework title
• Number of submissions received
• Creation date
• Quick links: Preview, Edit, Submissions, Copy Link

Managing Classes

Classes group your students. Navigate to Classes in the nav to create and manage them.

• Create a class with any name (e.g. "Year 10 Biology")
• Add students by name — no email or account needed
• Remove students at any time
• Assign homework to one or more classes

Students are shared across classes — adding the same name to two classes links them to the same student record.

Creating Homework

Go to Create Homework and fill in:

• Title — the homework name shown to students
• Content — your homework in AssignAI markdown (see below)
• Audio — optional audio clip that plays at the top of the student page (see Adding Audio)
• Answer Key — optional
• used by AI for grading —
• Classes — which classes can access this homework

After creating, you'll get a unique student link to share.

Markdown Formatting

AssignAI uses a simple markdown syntax to define homework elements.

Headings

# Section Title
## Sub-section

Short Answer

Start a line with ? followed by the question.

? What is the capital of France?

Long Answer

Use ?? for a larger text area.

?? Explain the causes of World War I in detail.

Multiple Choice

Write MCQ: followed by the question, then list options with -. Leave a blank line after the last option.

MCQ: Which planet is closest to the Sun?
- Mercury
- Venus
- Earth
- Mars

Instruction Callout

Use [NOTE] to add a highlighted instruction box — useful for section instructions or reminders.

[NOTE]
Answer in full sentences. Show your working where applicable.
[/NOTE]

Divider

---

Images

Use standard image syntax. You can paste or drag an image directly onto the content box — it uploads automatically and inserts the link for you.

![description](https://example.com/image.jpg)

![description](/images/uploaded-file.jpg)

Text Formatting

**bold text**
*italic text*
~~strikethrough~~
[link text](https://example.com)

Full Example

# Chapter 5 Quiz

[NOTE]
Answer all questions. Part B requires full sentences.
[/NOTE]

## Part A — Short Answers

? Name the process by which plants make food.

?? Describe the role of chlorophyll in photosynthesis.

---

## Part B — Multiple Choice

MCQ: Which gas do plants absorb during photosynthesis?
- Oxygen
- Carbon Dioxide
- Nitrogen
- Hydrogen

Adding Audio

You can attach an audio clip to any homework. It plays at the top of the student page — useful for listening exercises, spoken instructions, or pronunciation examples.

How to add audio

1. On the Create or Edit homework page
2. check "Add audio to this homework"
3. Either upload an audio file or record directly in the browser
4. Save the homework — the player will appear at the top of the student page

Recording in the browser

Click Record to start recording from your microphone. Click Stop when done. The recording is automatically set as the audio file — no need to upload separately. Your browser will ask for microphone permission the first time.

Limits

Accepted formats: MP3, MP4, OGG, WebM, WAV. After the expiry period the audio file is automatically removed, but the homework itself remains active.

Replacing or removing audio

On the Edit homework page, the current audio player is shown. You can upload a new file to replace it, or check "Remove audio" to delete it entirely.

Adding Images

Images are embedded directly in the homework content and display inline at a comfortable size (max 400px tall, full width).

Three ways to add an image

![description](https://example.com/diagram.png)

Uploaded images

When you paste or drag an image, it is uploaded to the server and compressed automatically (max 1200px wide, optimised JPEG). The inserted link looks like:

![image](/images/abc123xyz.jpg)

Uploaded images that are no longer referenced in any homework are automatically cleaned up after 180 days.

AI Features (Pro) Pro

AI Structuring

When creating homework, check "Use AI to structure" and AssignAI will send your plain text to Gemini AI, which automatically identifies headings, questions, MCQs, and other elements.

AI Grading

On any submission detail page, click "Grade with AI". The AI will:

• Assign an overall score (e.g. 7/10)
• Provide per-question feedback
• Highlight strengths and areas for improvement

Viewing Submissions

From any homework card, click Submissions to see all student responses. Click a submission to view the full detail including student answers and any AI feedback.

You can delete individual submissions if needed.

Accessing Homework

Students receive a link from their teacher, e.g. https://assignai.net/hw/abc123.

No account is needed. Students just open the link in any browser.

Completing & Submitting

1. Open the homework link
2. Select your class from the dropdown
3. Select your name from the student list
4. If the teacher attached audio
5. an audio player appears at the top — press play to listen
6. Answer all questions
7. Click Submit

Each student can only submit once per homework. If you've already submitted, you'll see a message saying so.

Troubleshooting

Students can't find their name

Make sure the homework is assigned to the correct class and that the student has been added to that class under Classes.

Submission says "already submitted"

Each student can only submit once per homework. Delete the existing submission from the submissions page if a resubmission is needed.

FAQ