To create your first Bloom, sign in at app.bloom.study, open the Manage Blooms dashboard, and click Create Bloom on the teaching space you want it in. You will be taken to a configuration page where you give the Bloom a title, choose an education level, and write a welcome message. Setup takes under two minutes, and your Bloom is live the moment you save.
A Bloom is a single AI agent, typically scoped to one subject, course, or unit (for example, Year 11 Biology or MATH1120). You will create knowledge bases, conversations, and quizzes inside it.
Before you start
You need:
- A Bloom account, sign up at app.bloom.study if you do not have one.
- A Teaching Space to put the Bloom in. Every Bloom belongs to one. If you signed up as an educator, a Teaching Space was created for you automatically.
- The Space Owner role on that teaching space, or another role with the Create Bloom permission. If your Create Bloom button is disabled with the tooltip “You’ve reached the maximum number of Blooms,” you have hit your plan’s limit.
Step 1: Open the Blooms dashboard
After signing in, click Manage Blooms in the left sidebar. You will see your teaching spaces listed, with any existing Blooms grouped under each one.
Step 2: Click Create Bloom
In the header row of the teaching space you want, click the Create Bloom button on the right.
If the button is greyed out, hover over it. The tooltip will tell you why, most often: plan limit reached, or you do not have permission on this space.
Step 3: Fill in the four core fields
You will land on the configuration page, defaulted to the Initial Setup tab. Fill in:
Title
The Bloom’s name as it appears to students. Required. 1 to 80 characters. Letters, numbers, spaces, and basic punctuation (- _ ‘ . ? ! & ( ) +) are allowed.
Education Level
Pick from the dropdown:
- General
- Primary Education
- Middle Education
- Secondary Education
- Higher Education
- Postgraduate Education
This shapes how the AI calibrates explanations. Higher Education assumes more prior knowledge than Primary Education.
Welcome Message
The first message students see when they open a chat with this Bloom. Required. 1 to 2,000 characters. You can use template variables: {firstName}, {botName}, and {title}. For example:
Context and Instructions (optional)
Use this field to give the AI agent background information specific to your course, syllabus framing, assessment policies, the textbook you are using, or anything else it should always know. This text is included in the system prompt for every conversation, so keep it focused. Up to 100,000 characters are allowed, but most Blooms work best with 200 to 800 words. You can leave this blank for now and add it later from the same tab.
Example Questions (optional)
Up to 10 questions, each up to 120 characters. These appear as starter chips in the chat UI. Students who do not know what to ask will click these.
Good example questions are concrete and tied to assessable content:
- “Explain mitosis like I’m 14.”
- “Quiz me on the structure of a plant cell.”
- “Give me feedback on this paragraph.”
Language
Pick the language this Bloom responds in and reads aloud in. The dropdown lists dozens of options, grouped by language and region, including English (Australia), English (United Kingdom), English (United States), English (India), German (Germany), French (France), Spanish (Spain), Mandarin Chinese, Japanese, Korean, Arabic variants, and many more. Choose the variant your students are most comfortable hearing, regional pronunciation matters for comprehension and engagement.
Voice
Pick the voice the Bloom uses for read-aloud. The voice list updates based on the language you chose, so a Bloom set to English (Australia) will offer Australian voices like Natasha, William, Carly, and Duncan. A Bloom set to English (United States) offers Ava, Andrew, Emma, and others. Each voice is a high-quality neural voice; pick one that matches the persona you want students to hear.
Step 4: Save
Click Save at the bottom of the page. The Bloom is created immediately. You will be redirected to the Manage Blooms dashboard with a success toast, and your new Bloom will appear under the teaching space.
Step 5: Add knowledge base documents
A new Bloom can answer general questions straight away, but it becomes much more useful when you ground it in your actual course materials. Add your syllabus, weekly slides, readings, rubrics, worked examples, or policy documents to the Knowledge Base so Bloom can retrieve the right context before it answers.
The short version:
- From Manage Blooms, open the Bloom you just created.
- Click the Knowledge Base tab.
- Upload supported files such as PDFs, Word documents, slides, text, Markdown, or JSON, or add a URL.
- Click Ingest so Bloom extracts the text, creates embeddings, and indexes the material for retrieval.
- Set each file’s access level, especially if a source should ground answers without being directly visible to students.
For file limits, supported formats, ingestion progress, and access-level details, see How to upload course materials to your Bloom.
Common issues
“Content moderation” error on save
Bloom runs Title, Welcome Message, and Context through a content filter on creation. If something is flagged, the save fails with an error toast naming the field. Edit that field and save again.
Create Bloom button is disabled
You have either hit your plan’s Bloom limit or you are a space member without create permission. Ask your Space Owner to either upgrade the plan or grant you the role.
Title shows a red validation error
Most often it is the regex, emojis and characters like / \ : ; are not allowed. Stick to letters, numbers, and the punctuation listed above.
What’s next
- Add course materials so the AI can ground answers in your real content → Upload course materials
- Browse all setup guides → Getting Started
- Open Bloom and create one now → Manage Blooms