How to create an item
Introduction
An item is one problem a student answers. CodeChum ships thousands of them, and the ones you write yourself live beside them in your Item Bank, ready to drop into any activity.
All six kinds of item are written in the same window. Create Item asks what type you are making first, and then shows only the steps that type needs, so a console item asks for test cases while a questionnaire asks for questions. Let's walk through what every type has in common, and then pick the type you are after.
Steps
Note: Writing test cases or questions yourself is open to everyone, but letting CodeChum write them is not. Auto-generate solution and test cases with AI, and Auto-generate questions with AI on a questionnaire, need a verified teacher: clicking either one before you are opens a card reading "You need to be a verified teacher to use this feature" with a Get verified now button on it.
To create an item in CodeChum, follow these instructions:
- Click Item bank in the sidebar, then click Create item. The Create Item modal opens.

- Under Choose what type of item you want to create., click one of the six cards: Console application, Questionnaire, GUI application, Web application, MySQL database or Diagram. Each card says what students do to answer that type.

- Read the steps that appear under the card you picked. A console item has six steps, a questionnaire four, and a MySQL or diagram item three. The type is what decides them, and you cannot change it later.

- Type the Item name and write the Item description in the next step. The name holds at most 100 characters, and every type except Questionnaire needs a description. A diagram item asks for its diagram type here too.

- Pick the languages your students may answer in under Select all languages that can be used to solve this item. Choose Applicable to all when the item does not belong to one language. A MySQL item skips this step and is saved against MySQL, and a diagram item is open to every language.

- Fill in the step that says how the answer is checked. That is Add test cases to check the solutions of your students. on a console or MySQL item, Add the questions for this item. on a questionnaire, and Provide a solution diagram for this item. on a diagram. A web item has no such step for teachers, as the note below says.

- Open Add minimum requirements for this item. when the code itself has to do something, such as use a loop or stay away from a built-in function. The step warns that a student who misses a requirement gets 0 however many test cases they passed.

- Open Add initial code for this item. to write the code your students find in the editor when they start. Both this step and the one before it are optional, and both appear only once a language is picked.

- Finally, click Create item at the bottom. Success tells you the item was created, and Finish opens it in your Item Bank.

Note: Closing the modal part way through keeps a draft, so opening Create item again brings back what you typed. GUI application, and Web application for teachers, have no builder in CodeChum: their second step reads Fill out the form to let us create the item for you instead. and Go to form opens it, with the item coming back to you by email.
Choosing a constraint for a minimum requirement
A minimum requirement is built from a constraint, and CodeChum reads the constraints out of the solution you wrote, so the ones that fit your item come first.
- Click the add button under Add minimum requirements for this item., then choose Should use... or Should not use... under Select constraint type:. The add button stays off until the item has a solution.

- Click Select a constraint... on the new card. Select a Constraint... opens on This may take a while... while CodeChum reads your solution.

- Read the two lists. Applicable constraints for this item's current solution holds what your own solution uses, and Other constraints you may consider that aren't applicable to this item's current solution holds the rest of the same kind. With nothing to match, the first one reads No applicable constraints found for this item's current solution.

- Click the arrow on a constraint to read its description and its sample code, and click a constraint's radio button to choose it. The one you chose is marked Selected.

- Click Select this constraint, which stays off until you pick one. The constraint lands on the requirement card, where anything you had typed into it is cleared.

- Finally, fill in the values the requirement asks for, and set its language where it only applies to one. The language list holds what the constraint supports and your item uses, under Available from your solution.

Note: A requirement left without a constraint or without a language is marked in red on the card until you fill it in. A requirement that no longer matches your saved solution reads This requirement does not exist in your solution. and asks you to update the value or remove it.
Reading the item you just made
Finish opens your new item in View Item, the panel that also opens whenever you click an item card in the Item Bank.

Details holds the description and the Item Details cards: Answerable In, Topics Included, Avg. Score Percentage, Avg. Time Spent and Calculated Difficulty. Avg. Score Percentage and Avg. Time Spent read a dash until a student has answered the item. Tests holds the test cases and the minimum requirements, Used In lists the activities you have put the item in, and Solutions holds the solution and the initial code, one language at a time. Which of them you get depends on the type.
The actions menu carries Edit, Delete and Copy as template, and Try answering opens the item as a student sees it. Edit and Delete are off on an item somebody else wrote, and say so when you hover them.
The item types
🧩How to create a Console-based item 🧩How to create a Questionnaire item 🧩How to create a GUI-based item 🧩How to create a Web-based item 🧩How to create a MySQL database item 🧩How to create a Diagram itemAnd that's how you create an item in CodeChum! Next, let's use your item in an activity.
