Contexts
What are Sections?
Section titled “What are Sections?”Each Context is made of sections — independent content blocks that describe one aspect of the workspace. Sections can be:
- Created manually by the user.
- Imported from Markdown files (
.md,.mdx). - Generated by AI, either in bulk or one at a time.
All changes (create, edit, import, generate, delete, reorder) are local until you click Publish. If you reload the page without publishing, pending changes are discarded.
Section Types
Section titled “Section Types”| Type | Description |
|---|---|
| Plain text | Free-form basic text |
| Text area | Longer multi-line text |
| Rich text | Markdown content |
| Link | Single URL |
| Link list | Multiple URLs |
| List | Items in list format |
| Checklist | List with checkboxes |
| Code | Formatted code block |
| Quote | Quote-style text |
| Callout | Highlighted colored boxes |
| Group | Structured profiles with name, description, goals, pains and traits (e.g. user personas) |
Header Actions
Section titled “Header Actions”At the top of the Contexts tab you’ll find, from left to right:
| Element | Description |
|---|---|
| Search field | Filters sections by title or content text |
| Filter by type | Funnel button with popover to pick which section types to display |
| ”Unpublished changes” badge | Appears when there are pending local changes |
| Undo | Discards all pending changes and reloads from the last published state |
| Publish | Persists changes to the database and syncs Knowledge Base embeddings |
| Magic button (✨) | Opens the bulk AI generation dialog, letting you review the prompt before confirming |
| Gear (⚙) | Opens the Security settings (clear all Contexts) |
Ways to Create Sections
Section titled “Ways to Create Sections”1. Add manually
Section titled “1. Add manually”Click Add Section (the + button in the tree on the left, or in the empty state). A new section is created at the end of the tree in edit mode, where you define title, type and content.
2. Import from Markdown
Section titled “2. Import from Markdown”Click Upload (the upload button in the tree, or in the empty state). Select one or more .md / .mdx files — Prodgy converts each top-level heading into a section and preserves body formatting. Ideal for bringing in existing documentation.
3. Bulk generate with AI
Section titled “3. Bulk generate with AI”Click the magic button (✨) in the header. A dialog opens showing the prompt that will be sent to the AI. You can:
- Review and edit the prompt (controls which sections are generated).
- Adjust Max Tokens (maximum response size, default 8000).
- Adjust Temperature (creativity, default 0.7 — lower = more focused).
- Click Generate to confirm.
Generated sections appear as drafts and are only persisted when you click Publish.
4. Generate a single section with AI
Section titled “4. Generate a single section with AI”Inside the section tree, each item has a Generate with AI option in the context menu. This opens a dialog with a prompt focused on that section only, without affecting the others.
Section Operations
Section titled “Section Operations”| Action | Description |
|---|---|
| Edit | Modify title, description and content of a section in the editor on the right |
| Delete | Remove a section (via tree menu or editor) |
| Reorder | Drag and drop items in the tree to rearrange |
| Generate with AI | Available in the context menu of each section |
| Download as Markdown | Download icon in the editor header — exports the selected section as a .md file (filename derived from the section title) |
Workflow (Draft → Publish)
Section titled “Workflow (Draft → Publish)”The Contexts tab uses a local draft model:
- Edit freely — create, change, import, generate or delete sections. Nothing is saved to the database yet.
- Visual indicators — modified sections show a yellow dot in the tree, and an “Unpublished changes” badge appears in the header.
- Publish — when you click Publish, all changes are persisted to the database and embeddings are synced with the Knowledge Base.
- Undo — discards all pending changes and returns to the last published state.
Settings
Section titled “Settings”Access through the gear button (⚙) in the header.
Security Tab
Section titled “Security Tab”- Clear Contexts — permanently removes all sections from the database and cleans up embeddings from the Knowledge Base. This action cannot be undone.
Publishing and the Knowledge Base
Section titled “Publishing and the Knowledge Base”When you publish, Prodgy:
- Persists all pending changes to the database (creates new sections, updates existing ones, deletes removed ones).
- Syncs the content with the Knowledge Base, generating embeddings so AI agents can consult this information during conversations and workflow executions.