Content Editor
What is the Content Editor?
With the Content Editor you design a page from various content elements, arranged according to a layout you choose yourself. The page is optimised for mobile devices. OpenOlat saves your changes automatically.
The Content Editor is used in several places in OpenOlat. Who uses it depends on the place: in the course element "Page" the owners of the course and authorised coaches, in the learning resource "Form" its owners, in the portfolio the owners of the binder.

Note
Besides the Content Editor, OpenOlat also has the HTML editor "TinyMCE", which is used in the course element "HTML page", for example.
Where is the Content Editor used?
The Content Editor is used in the course element Page, in the learning resource "Form" and in the "Portfolio 2.0".
Course element page
In the course element "Page" you open the Content Editor in two ways: in the course editor in the tab "Page content" with "Edit page", or with the course editor closed directly in the course element by switching on the edit mode. You reach the course editor under: Course > Administration > Course editor.
When the course editor is closed:

The switch "Edit mode" turns editing of the page on and off.
In the course editor:

In the tab "Page content" you define under "Rights" whether, in addition to course owners, coaches may also edit the page when the course editor is closed: option "Edit page" for "Coach". With "Show advanced configuration" you additionally grant the right to individual roles, groups or users, optionally with a start and end.

OpenOlat stores the media content of the Course Element "Page" (images, audio, video, diagrams, citations, documents, etc.) in the Media Center, not in the course’s storage folder as with the Course Element "HTML Page".
The media of a portfolio binder are also stored in the Media Center. The learning resource "Form", by contrast, stores images in the learning resource itself.
Learning resource form
The learning resource Form and all elements that use a form also use the Content Editor.
The displayed options for inserting content are adapted to the form, e.g. different question types are available here.

E-portfolio
The Content Editor is also used for entries in binders, which can be used both independently of a course and in conjunction with portfolio templates and portfolio tasks.

Layout in the content editor
Before you can insert content in the Content Editor, you add a layout with "Add a new layout". The layout serves as a grid that determines the arrangement of the content (blocks).
There are various layouts to choose from, which differ in the way the fields are arranged. You can also combine several layouts on one page.
If necessary, the layout can be changed later at any time. To do this, click on the gear icon (Edit settings) of the layout and select a new layout.

If several layouts exist, you can change the order of the layouts. Use the arrows to move an entire layout.

Deleting a layout
Every layout on a page can be deleted via the layout's three-dot menu, including the first one. When deleting, you decide what happens to the content: "Delete everything" removes the layout together with its content, "Only delete the layout and move the content" moves the content to the adjacent layout. When the last layout of a page is deleted, the dialog points out that the layout and all its content will be deleted; the page then automatically receives an empty default layout again. If only a single empty layout is left, the "Delete" action is disabled.
Organizing content in the layout
Content blocks
In each section of a layout you insert content blocks with various content. The number of content blocks depends on the selected layout. For example, a three-column layout has 3 content blocks.
Adding, positioning and configuring content in a block
With "Add content" you insert content and media into a block. The link appears in every section of a layout, so you can insert the content exactly where it belongs.

The "Add content" dialog lists the available content types grouped into the sections "Text", "Media", "Knowledge" and "Other & design". At the bottom, two buttons lead directly to the Media Center and to the import.
When you hover over a block with the mouse in edit mode, that block is highlighted . This helps you tell blocks apart when several similar elements follow one another.
If you click on a piece of content, a pop-up window appears in which you set its properties: the "Inspector".
You can also show or hide the Inspector pop-up using the gear icon next to the content.

Menus
The toolbar of a selected block comprises four icons: the gear for the Inspector, an icon to duplicate, a three-dot menu and an arrow cross ("Drag content"). The three-dot menu lets you add further content elements before or after the element, duplicate the element, and delete it. The arrow cross lets you drag and drop the selected element to a different position, into a different content block, or into a different layout.
A block can be copied with the "Duplicate" action, both as a short action on the block itself and via the three-dot menu .

General formatting for all content blocks - The Inspector
Spacing
Consistent spacing between the fields of a layout (content blocks) makes a page easy to read. Under "Spacing" you can choose:
- No spacing
- S (small)
- M (medium)
- L (large)
- XL (extra large)
- Custom



Background
In the inspector of a layout you define the background of the layout in the tab "Style" under "Background" . Besides "None", a predefined colour list is available, letting you set individual layouts apart visually.
Alert box
Layouts and various content blocks can be displayed as a formatted alert box . When a predefined type is selected, the box highlights information with the matching colour and the matching icon. The types "Note", "Info", "Tip", "Important", "Warning", "Error" and "Success" are available. With the type "Custom" you design the colour and icon of the box yourself. In the field "Title" you give the box a heading, "With icon" shows the icon, and "Collapsible" makes the box collapsible.

Example:

Anchors
Every title element on a page automatically receives an anchor, that is a jump target that leads directly to this section. Other content types do not receive an anchor.
You do not need to configure anything for this. The anchors are not shown on the page and cannot be copied individually either. They are used by the "Table of contents" element, which lists the titles of the page and links them via these anchors as jump marks. The more title elements structure a page, the more useful the table of contents becomes.
To the table of contents >
Content types
Which elements are available depends on where you use the Content Editor.

Title
For the element "Title" you select one of the predefined levels h1 to h6 under "Size" in the inspector.
Every title additionally receives an anchor. It is used exclusively by the "Table of contents" element, which lists the titles and links them via their anchors. Outside the table of contents, the anchors cannot be addressed.

Text
With the element "Text" you insert formatted running text. The formatting bar offers, among other things, font style, alignment, font size, colours, lists, links and formulas. In the inspector you define under "Columns" in how many columns the text appears.

Table
With the element "Table" you present content in rows and columns. In the inspector you define the number of rows and columns under "Row" and "Column" and whether the table has a "Row header" or a "Column header". Under "Row style" you choose how the rows are displayed. Above and below the table you can enter a table title and a table caption.

Math formula
A special small editor is available for mathematical formulas.

This text element does not exist in the form editor.
Code example
The block "Code example" shows text in a font with fixed spacing and numbered lines. This helps with technical learning content such as programming examples. When creating the block, you select the programming language. Participants copy the code directly to the clipboard to reuse it.

This text element does not exist in the form editor.
Citation
A citation automatically receives a predefined formatting. OpenOlat saves citations as reusable objects in the Media Center, just like audio and videos.
This text element does not exist in the form editor.
Section Media
Instead of the "Media" section and its associated content elements, the form editor includes the "Question Types" and "Organizational" sections with their corresponding content elements.
Image
You embed any image from the Media Center or upload a new one. OpenOlat stores new images automatically in the Media Center. The image formats png, jpg, gif and svg are supported .
If the AI feature "Image Description Generator" is switched on in the AI module of the system administration, OpenOlat adds title, description, alternative text and tags of a newly uploaded image in the background with AI, provided the AI image descriptions are switched on for you, see Tab AI settings. The AI feature is located under: Administration > External tools > AI module > Tab "AI features". More about this: Generate metadata with AI
Gallery
The gallery element shows several images as a slideshow to scroll through, in a grid (authors define the columns and rows) or with preview (one image large, the others as reduced preview images). You choose the appearance of the gallery in the inspector. The images come from the Media Center.

Image comparison
The image comparison places two images on top of each other. A slider cross-fades between them.

Audio
You record an audio directly in OpenOlat, upload it or select an existing audio.

Video
In the block "Video" you also embed videos via URL.
OpenOlat supports the video formats MP4 and m3u8 as well as the platforms YouTube, Vimeo, Panopto and nanoo.tv. You record new videos directly in OpenOlat.
Document
You upload documents in various formats, for example PDF or Word files, via drag-and-drop, select them from the Media Center or create them directly in specific formats. OpenOlat stores the media automatically in the Media Center.
You can also access the Media Center via the Inspector menu to add additional information to documents and define further sharing options. This allows a file that was initially intended for a single content block to be used for other purposes or edited by other OpenOlat users.
In addition, the "Share" section allows you to share newly created or uploaded documents directly.

Diagram (draw.io)
You load an existing diagram from the Media Center or create a new one directly with draw.io. If you edit the file as an individual, the editing takes place on the OpenOlat server, in collaboration mode on an external server.

Section Knowledge
This section is available only in the Content Editor of the course element "Page".
Quiz
With the element "Quiz" you embed quiz questions into a page that OpenOlat grades automatically. You can create new questions or add existing ones from the question bank. You can also add feedback to each question, including images and videos.
The quiz questions encourage engagement with the content and do not award points. For graded questions, use the course elements "Test" or "Self-test".
Conversely, the quiz element is the only place where learners receive AI feedback on free-text answers.

Via the three-dot menu of the quiz element you exchange questions with the question bank. "Import questions from pool" adds existing questions to the quiz, "Export all questions to pool" writes all questions of the quiz to the question bank. This lets you reuse questions created directly on the page in other courses and tests.

Separator
A separator is a line (visual design element) used to separate content.
Table of contents
The "Table of contents" element makes long pages easy to navigate: it lists the titles of the page as clickable jump marks and takes you directly to the respective section with one click . It captures the titles that follow the table of contents on the page, up to the next title of the same or a higher level. This allows you to create a table of contents for the whole page or for a single chapter only. In the inspector, "Title sizes" defines which title levels (H1 to H5) appear in the list; H1 to H4 are selected by default. If the table of contents is displayed as an alert box, its title serves as the box title.

You insert the element via "Add content" in the "Other & design" section. When inserted, it carries the title "Contents", which you can overwrite in the Inspector.
If the table of contents stays empty, the hint "No titles found after this position" appears. The element is then placed below the titles it is meant to list, or the selected title sizes do not match the existing titles. Move it before the titles you want, or adjust the title sizes in the Inspector.
This element does not exist in the form editor.
HTML text code
The element "HTML text code" is available only in the Content Editor of the course element Page. It performs similar functions to the element "Text" and offers additional menus and options.
AI feedback on free-text answers
If you ask learners an open question in the quiz, they receive an immediate response from the AI to their answer, without you reading every answer yourself. When learners submit their answer with "Check", formative feedback appears in the "AI feedback" block . The feedback does not award points and serves for self-assessment.
The quiz offers the question type "Essay" if the AI feature "Essay Grading" is configured in the AI module of the system administration: Administration > External tools > AI module > Tab "AI features".
This evaluation exists only in the quiz element of a page. In the course elements "Test" and "Self-test" the grading kit of an essay question is not executed, even if the question comes from the question bank. How you define the grading kit of a question is described in the chapter Edit the AI feedback of an essay question. The whole path from the essay question to the feedback for learners is shown in the instructions How do I give learners AI feedback on free-text answers in a quiz?
The feedback begins with the "Assessment" of the answer in the levels "very good", "good", "mediocre", "insufficient" and "wrong", together with a short overall appraisal. Next to it is the estimated score of the answer in percent. The "Feedback reliability" indicator with the values "high", "medium" and "low" shows how reliable the AI rates its own assessment.
Under "Detailed feedback" further sections can be expanded: "What went well", "What is missing" and "Next step", plus the points the answer covers and those it misses, and under "Language" feedback on "Grammar" and "Spelling". The area only appears when the AI has something to contribute.
Depending on the AI model in use, grading takes a few seconds up to several minutes. Meanwhile the page reports progress in stages: first it waits for the AI correction, after a short while it points out that the page should be kept open, and after that it states that grading with this model can take several minutes. As soon as the result is ready, the page updates itself. If grading exceeds the waiting time configured in the AI module, OpenOlat cancels it and reports this .
The permitted number of words for the AI feedback is set by the system administration in the AI module, 400 words by default. For longer answers, learners receive a message with the configured value instead of the AI feedback. The answer remains saved.

Consent to the AI correction
Before the AI corrects free-text answers of learners, OpenOlat asks them for permission. After a click on "Start quiz", the dialog "AI correction" appears above the first question, provided the quiz contains at least one free-text question with a grading kit and the person has not stored a choice in the tab "AI settings" of their personal settings. The dialog says that the quiz corrects free-text answers with AI and that the AI feedback is a suggestion, not a grade. It also names the default of the institution.

- "Allow once": The AI corrects the answers in this attempt. OpenOlat stores nothing.
- "Always allow": The AI corrects the answers, and OpenOlat stores the choice "On" in the tab "AI settings". The dialog does not appear any more after that.
- "Not now": No AI feedback appears in this attempt. OpenOlat stores nothing. Closing the dialog with the cross at the top right or with the Escape key also selects "Not now".
"Allow once" is highlighted if the default of the administration is "on", otherwise "Not now". As long as nothing is stored, the dialog appears again in every new attempt, also after a click on "New attempt". Without permission, learners answer the free-text questions as usual, only no AI feedback appears.
Learners undo "Always allow" by selecting "Default (on)" or "Default (off)" again in the tab "AI settings". With "Off" they switch the AI feedback off completely there. You find the tab under:
Personal menu > System settings > Tab "AI settings"
More about this: Tab AI settings
Importing Markdown and Word files
Important
Markdown is a widely used text format that many tools and AI applications output. Headings, lists and tables are recorded in it as simple characters, so the structure of a text is preserved during import.
You import Markdown files and Word documents directly into the Content Editor. This way you take over content from external tools, text files or AI applications without reformatting it by hand. OpenOlat automatically converts the content into blocks of the page.
To import, click the button "Import" at the bottom of the Content Editor.

In the import dialogue you choose between two options:

A) Upload file: The following are supported:
- Markdown files (.md, .markdown, .txt)
- ZIP archives up to a maximum of 50 MB (A ZIP archive must contain exactly one markdown file and can additionally include the image files referenced relatively within it.)
- Word documents (.docx) up to a maximum of 200 MB .
B) Paste text: You paste Markdown-formatted text directly into the input field, for example from the clipboard. This mode does not support local image paths.
Below, depending on the configuration of the AI module, the switches "Add AI generated Quiz" and "Generate image metadata with AI" appear. What they do is described in the sections Generate AI questions on import and Images during import.
Importing Word documents
OpenOlat automatically converts Word documents to Markdown during import. After that, they are processed in the same way as Markdown files. Formatting such as superscript, subscript, underlined and highlighted text is preserved, as are tables and embedded images. When uploading a .docx file, OpenOlat displays a notice because not all Word features can be imported. Therefore, please review the imported content carefully.
Conversion of the elements
During import, OpenOlat converts the markdown elements into blocks of the Content Editor as follows:
| Markdown element | Block in the Content Editor |
|---|---|
Heading (level 1 to 6, # to ######) |
Title in the corresponding size (H1 to H6) |
| Paragraph | Text |
Horizontal rule (---) |
Separator |
| Code block | Code example (with detected programming language) |
Blockquote > |
Text with alert box |
GitHub admonition (e.g. > [!WARNING]) |
Text with alert box of the matching type |
| List (bulleted or numbered) | Text with list |
| Table | Table |
| Image | Image (stored in the Media Center) |
Math block ($$...$$) |
Math formula |
Inline formatting <sup>, <sub>, <u>, <mark> or ==text== |
Text with preserved formatting |
Image size {width=300 height=200} directly after the image |
Image in the specified display size |
| Table with bold first row or first column | Table with row or column headers |
MkDocs admonition !!! info "Title" |
Text with alert box of the matching type |
YAML front matter block at the top of the document, enclosed in --- |
Detected and removed, the page starts directly with the content |
The title size also determines which imported titles the "Table of contents" element captures and links as jump marks.
Markdown extensions
In addition, the markdown extensions for strikethrough text, task lists and footnotes are supported. GitHub admonitions of the types NOTE, TIP, IMPORTANT, WARNING, CAUTION, INFO, SUCCESS and ERROR receive an alert box with the matching type and icon; MkDocs admonitions add further types such as ABSTRACT, HINT, QUESTION, ATTENTION, DANGER, BUG or EXAMPLE. An admonition title in quotation marks is applied, an empty title "" hides the title line, and without a title the default label of the type is shown. The import does not take over HTML blocks for security reasons; it finishes with a corresponding warning.
Images during import
During import, OpenOlat stores images directly in the Media Center. A duplicate check prevents the same image from being stored in the Media Center several times, without you as an author having to do anything.
OpenOlat downloads images with absolute URLs during import. If the mode under Administration > Login > Security > Tab "Media server" in the system administration is set to "Configure", this only applies to the domains enabled there. The import does not download an image from another domain and reports it as a warning, see Tab Media server. Base64 images embedded directly in the markdown (data URIs) are also imported.
If the AI feature "Image Description Generator" is switched on in the AI module of the system administration, the import dialog shows the switch "Generate image metadata with AI". If it is switched on, OpenOlat generates title, description, alternative text and tags for the imported images in the background with AI . OpenOlat transmits a reduced version of each image to the AI service. If it is switched off, OpenOlat does not generate metadata with AI. The AI feature is located under: Administration > External tools > AI module > Tab "AI features".
When the dialog opens, the switch is set the way the AI image descriptions are set for you: according to your choice in the Tab AI settings, without a choice of your own according to the default of the administration. You can change it for each import individually. The change only applies to this import, OpenOlat does not store it.
Details on metadata with AI >
Importing at a specific position
The "Import" button is additionally available in the dialog "Add content" . Via this dialog, the import inserts the content exactly where you are working: in the respective content block, or before or after the element from which you opened the dialog. Via the button at the bottom of the Content Editor, the content ends up at the end of the page.

Generate AI questions on import
If the AI feature "Essay Question Generator" is configured in the AI module of the system administration, the import dialog additionally shows the switch "Add AI generated Quiz". It is switched on when the dialog opens. The AI then generates the questions from the imported text, the source text: the text your learners work through. OpenOlat inserts the questions as a quiz element directly after the imported content. If you do not want questions to be generated, switch it off before the import. Via the "MC question" and "Essay question with AI correction" fields you define how many questions of each type are generated (up to five per type). The multiple-choice questions are only created if the AI feature "MC Question Generator" is configured as well. The AI feedback on the essay questions comes from the AI feature "Essay Grading". All three AI features are located under: Administration > External tools > AI module > Tab "AI features".
Three further fields steer which questions are created. Under "Bloom levels" you choose which cognitive levels the questions should cover: "Remember", "Understand", "Apply", "Analyse", "Evaluate" and "Create". The "Target difficulty" ranges from "1 - Very easy (Quiz mode)" to "5 - Very hard"; with "No preference" OpenOlat chooses the difficulty at random per question. In the "Learning objectives (optional)" field you enter one learning objective per line to focus the questions in terms of content.

How long the imported source text for question generation may be is set by the system administration in the AI module, 60000 characters by default. If "MC Question Generator" and "Essay Question Generator" are both active, the smaller of the two values applies. The dialog rejects a longer text.
Generation runs in the background and can take a minute. Until then, a quiz element with the title "Please wait, quiz questions are being generated by AI." stands at this position; after that, the questions appear in it. Check the generated questions for correctness afterwards. AI question generation is not available in the e-portfolio.
Media Center
In the Content Editor of the course element Page and of the portfolio, a separate button "Media Center" in the dialog "Add content" leads to your media. It is an additional way to access your files, regardless of the type of media.
Click the button to open the files in your Media Center. Here, you select files, create new ones or upload them.

Media Center (User tools) >
Detailed information about the Media Center (Basic concept) >
Further information
Mentioned on this page
Course Element "HTML page" >
Course Element "Page" >
Forms - Overview >
The Portfolio Editor >
User tools: Media Center >
My binders >
Portfolio template: Creation >
Course Element "Portfolio Task" >
The form editor >
External tools: AI module >
Personal Configuration: Settings >
Information and settings for items in the Media Center >
Course Element "Test" >
Course Element "Self-test" >
Question Bank: Overview >
Question Bank: Create Questions >
"How do I give learners AI feedback on free-text answers in a quiz?" >
Security >
Media Center Concept >
Further reading
Working with tables >
Math formula >
Accessibility: Basic principles >