# Creating training modules

Turn your knowledge base articles and documents into a short quiz. The AI drafts the questions from your own text, you review and edit them, then publish the module for your team.

For: Admins · On: Web · [Help Center](https://www.mays.app/help) › [Knowledge & training](https://www.mays.app/help/knowledge-training) · Last updated October 10, 2026 · Mays Team

Turn your knowledge base articles and documents into a short quiz. The AI drafts the questions from your own text, you review and edit them, then publish the module for your team.

**Where:** **Learning → Modules** on the web. **Who:** admins; managers don't see Learning. Staff take the quizzes in the Mays app (see [Taking training in the app](https://www.mays.app/help/knowledge-training/take-quizzes-on-mobile)).

Learning is part of the **Pro** plan. The Mays team switches it on for your organization: if you're on Pro and **Learning** is in your sidebar but nothing you create is saved, write to support.

![The Learning Modules page: three modules, Allergen awareness (published), Food safety: handwashing (published, with a Compliance tag) and Opening the store (draft), each with its question, assignment and attempt counts, and the New module button](https://mays-uploads.s3.us-east-2.amazonaws.com/site/help__create-learning-modules__01-module-list.5696643549.png)

## 1. Create the module

1. Go to **Learning → Modules** and click **New module**.
2. Enter a **Title**, such as *Food safety: handwashing*, and a short **Description (optional)**.
3. Tick **Compliance-critical (issues a PDF certificate on pass)** if the module is one people must pass, like food safety. See [Training certificates](https://www.mays.app/help/knowledge-training/training-certificates). A compliance module also limits retakes: someone who doesn't pass sees which answers were wrong but not the right ones, waits 30 minutes before trying again, and gets 3 tries a day.
4. Click **Create**. The module opens as a **Draft**.

![The Create learning module window with the title Food safety: handwashing, the description When and how to wash your hands on shift, the Compliance-critical box ticked with the note that after a failed attempt learners see which answers were wrong but not the right ones, wait 30 minutes before trying again and get 3 attempts a day, and the Create button](https://mays-uploads.s3.us-east-2.amazonaws.com/site/help__create-learning-modules__02-create-module.f765440b5d.png)

Choose the title and the compliance box carefully: there's no way to change either after you click **Create**. To change them, create a new module.

## 2. Let the AI write the questions

1. In the module, click **Generate from docs**.
2. Set the **Question count** (1 to 15; it starts at 5) and the **Difficulty**: **Easy**, **Medium** or **Hard**.
3. Tick the **Documents** and **Articles** from your knowledge base that the quiz should cover.
4. Click **Generate from 1 source** (the button counts what you ticked).

![The Generate quiz with AI window: Question count 5, Difficulty Medium, the document Cooling-Cooked-Food.pdf, and four articles with Handwashing: when and how ticked, and the Generate from 1 source button](https://mays-uploads.s3.us-east-2.amazonaws.com/site/help__create-learning-modules__03-generate-quiz.bca6d22f13.png)

After a few seconds you see *5 questions ready for review.* Click **Review questions**.

How the AI writes them:

- It uses **only your text**, not general food-safety knowledge. If your source doesn't say it, it isn't asked.
- Each question is **multiple choice** (four answers) or **true/false**, with a one-sentence **explanation** that staff see after they answer.
- Each question comes with the exact sentence it was based on, shown in grey under it (*source: "…"*).
- A second check reads every question against your text and throws out any that don't match it. You'll see *Dropped 1 hallucinated question.* with the reason. So you may get fewer questions than you asked for.
- Generating a quiz doesn't use AI credits.

**It didn't work?** The window says why, in red, and keeps your choices so you can try again or tick other sources:

![The Generate quiz with AI window with the article Opening the store ticked and, above the Cancel and Generate from 1 source buttons, a red message: AI quiz generation isn't set up on this server yet. Contact Mays support.](https://mays-uploads.s3.us-east-2.amazonaws.com/site/help__create-learning-modules__05-generate-quiz-error.00007e4e3f.png)

- *Selected sources have no extracted text yet.* The document has no readable text, such as a scanned PDF. Try an article, or a document with real text in it.
- *The AI service is out of credits…*, *…is busy right now…* or *The AI couldn't generate a quiz this time…* The AI service Mays uses didn't answer. This isn't your organization's AI credits. Wait a minute and try again, and contact Mays support if it keeps happening.
- *AI quiz generation isn't set up on this server yet.* Contact Mays support.

If the AI answered but none of its questions matched your text, the window says *No questions were generated.* with the reason. Click **Pick other sources** to try again.

Very long sources are cut off: the AI reads roughly the first 7,000 words of what you tick.

## 3. Review and edit

Read every question before you publish: your team is graded on them.

- **Edit** changes the question, the answers and which answer is correct (the radio button). Click **Save**.
- The **bin** deletes a question.
- **Add question** writes your own: pick **Multiple choice** or **True / False**, type the **Question**, the answers, choose the correct one and add an **Explanation (shown to learner after answer)**. It appears once the module has at least one question.
- **Passing score (%)** is 80 to start with. Change it and click outside the box to save.
- **Compliance retake rules** (compliance modules only): **Wait after a failed attempt (min, 0 = none)**, 30 to start with, and **Attempts per day (0 = no limit)**, 3 to start with. Change a number and click outside the box to save.

![A draft compliance module, Food safety: glove use, with the Draft and Compliance tags and the Generate from docs and Publish buttons, three questions with the correct answer highlighted and an explanation under each, Quiz settings with Passing score 80 and Time limit 0, and Compliance retake rules with Wait after a failed attempt 30 and Attempts per day 3](https://mays-uploads.s3.us-east-2.amazonaws.com/site/help__create-learning-modules__04-review-questions.3e3662cc9f.png)

## 4. Publish

Click **Publish**. The module is now **Published** and the **Assign** button appears, see [Assigning training](https://www.mays.app/help/knowledge-training/assign-training). You can only publish a module that has at least one question.

## Good to know

- **Staff don't see a module until it's published and assigned.**
- **Letting someone try again sooner:** on a compliance module, **Who's taken it** has a **Retakes** column (*Can retry in 23 min*, *3 of 3 used today*). **Reset attempts** lets that person start again straight away. Their earlier attempts stay in the list.
- **Changing a published module:** edits and new questions apply to the next person who takes it. Earlier results aren't recalculated. A published module can't be switched back to draft.
- **Generating again** replaces the questions, including your edits and added questions, and sets the passing score back to 80, as long as nobody has taken the module yet. Once someone has, edit or add questions instead: new AI questions for a module that's already been taken don't reach your team.
- **Time limit (min, 0 = none)** is saved, but the apps don't show or enforce a timer yet.
- **Deleting a module** (the bin on the **Modules** list) deletes its questions, its assignments and everyone's results and certificates in Mays. Points already earned stay.
- **Your own SOPs only.** A Mays module isn't a state-approved food handler course. With Labor law compliance on, keep outside certificates such as food handler cards and food manager certificates on the **Certificates** tab of the team member's page. See [Food safety certificates](https://www.mays.app/help/team-roles/food-safety-certificates).

## Related articles

- Knowledge & training: [Assigning training](https://www.mays.app/help/knowledge-training/assign-training) — Send a published training module to whole locations, roles, departments or single people, with an optional due date, then see who has taken it, their best score and every answer.
- Knowledge & training: [Taking training in the app](https://www.mays.app/help/knowledge-training/take-quizzes-on-mobile) — Your training modules are under Profile → Learning in the Mays app. Answer one question at a time, see your score, and learn from the explanation under each answer.
- Knowledge & training: [Training certificates](https://www.mays.app/help/knowledge-training/training-certificates) — When someone passes a compliance-critical module for the first time, Mays creates a PDF certificate with their name, score and date. Admins set the certificate's look under Learning → Settings.
- Knowledge & training: [Snap quizzes](https://www.mays.app/help/knowledge-training/snap-quizzes) — A pop quiz is a push notification with one question from a module someone hasn't passed yet. Mays sends at most one a day, only to people on shift, inside the hours an admin sets.
- Knowledge & training: [Points, badges and leaderboards](https://www.mays.app/help/knowledge-training/points-badges-and-leaderboards) — Quizzes earn points, levels and badges. Locations compete on a weekly and monthly leaderboard, winners go on the wall of fame, and admins can note the prize they gave.
- Knowledge & training: [Your knowledge base](https://www.mays.app/help/knowledge-training/knowledge-base-basics) — Keep your SOPs, recipes and policies in one place. Admins and managers build folders of articles and documents on the web; the whole team reads and searches them in the app.
- Account & billing: [AI credits](https://www.mays.app/help/account-billing/ai-credits) — Mays's AI features use AI credits from each location's balance. What uses them, how many your plan adds every month, how to check a balance and how to buy more.
- Account & billing: [Plans, the free trial and locked modules](https://www.mays.app/help/account-billing/plans-and-free-trial) — Every organization starts with a 30-day free trial of all plan modules, then picks Basic or Pro (or your company's own package, if Mays set up custom pricing). What each plan includes, what the add-ons are, what a locked module means, and how each location's package decides its features.
- Team & roles: [Food safety certificates](https://www.mays.app/help/team-roles/food-safety-certificates) — Keep food handler cards and food protection manager certificates on file with their expiry dates, see who is missing one or due at each location, and get reminders before a card expires.

## Still need help?

Send us a support request and a real person on the Mays team will get back to you.

[Contact support](https://www.mays.app/contact?topic=support) · [Call +1 (561) 286-3939](tel:+15612863939)

Canonical: https://www.mays.app/help/knowledge-training/create-learning-modules