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

# Create and take quizzes to reinforce your learning

> Build quizzes manually or generate them with AI from your notes and PDFs, then track your scores, streaks, and progress over time to improve.

Clamly lets you build quizzes manually or generate them from a document with AI. Three difficulty modes give you control over how strict the scoring is.

## Creating a quiz

### Build a quiz manually

<Steps>
  <Step title="Open the Quiz Builder">
    Navigate to the **Quizzes** section in the sidebar and click **New Quiz**. Give your quiz a name and an optional description.
  </Step>

  <Step title="Add Questions">
    Click **Add Question** to open the question editor. Type your question, then add the correct answer and any distractor options.
  </Step>

  <Step title="Set the Difficulty">
    Choose a difficulty mode per question or set a default for the whole quiz. See [Difficulty modes](#difficulty-modes) below for details.
  </Step>

  <Step title="Save and Publish">
    Click **Save Quiz** when you're done. Your quiz is now ready to take or share with a study group.
  </Step>
</Steps>

### Generate a quiz with AI

Let Clamly AI read your notes or a PDF and write the questions for you.

<Steps>
  <Step title="Start a New Quiz">
    Click **New Quiz**, then select **Generate with AI**.
  </Step>

  <Step title="Choose Your Source Material">
    Select one or more notes from your library, or upload a PDF.
  </Step>

  <Step title="Configure the Output">
    Pick how many questions you want and which difficulty mode to apply. Click **Generate** and the AI will populate the Quiz Builder in seconds.
  </Step>

  <Step title="Review and Edit">
    Read through the generated questions, tweak any wording, remove questions that don't fit, and save.
  </Step>
</Steps>

<Tip>
  For best AI results, use notes that are detailed and well-organized. Learn more on the [Clamly AI](/ai/clamly-ai) page.
</Tip>

## Difficulty modes

<CardGroup cols={3}>
  <Card title="Normal" icon="check-circle">
    Standard scoring with generous answer matching. Good for first-pass review or casual practice.
  </Card>

  <Card title="Hard" icon="alert-triangle">
    Tighter answer requirements. Use this when you want to push your recall further.
  </Card>

  <Card title="Hell" icon="skull">
    Precise answers required, no partial credit. For serious exam prep.
  </Card>
</CardGroup>

## Taking a quiz

Click **Start Quiz** from the quiz detail page. Each question appears one at a time. After you submit an answer you'll see immediate feedback: whether you were correct, the right answer, and any explanation that was added.

At the end of a session Clamly shows a results summary with your score, time spent, and which questions you missed. Results are saved automatically so you can track improvement across multiple attempts.

## Scores, streaks, and progress

Your quiz history lives on the quiz detail page. From there you can:

* **Review past attempts:** see your score for every session you've completed.
* **Track streaks:** Clamly records consecutive days you've practiced.
* **Identify weak spots:** questions you answer incorrectly most often are flagged.

## Sharing quizzes in study groups

Open a quiz, click **Share**, and select the group you want to share it with. Group members can take the quiz and compare scores.

<Note>
  Shared quizzes are view-and-play only for group members. Only the original creator can edit or delete the quiz.
</Note>

## What's next

<CardGroup cols={2}>
  <Card title="Flashcards" icon="layers" href="/study-tools/flashcards">
    Use spaced repetition to lock in what you've learned from quizzes.
  </Card>

  <Card title="Clamly AI" icon="sparkles" href="/ai/clamly-ai">
    Generate quiz questions automatically from any document.
  </Card>
</CardGroup>