Skip to content

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.

A page in edit mode: selected title block with its toolbar, on the right the inspector with the tabs Style and Layout, below further blocks and the link Add content

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 Edit mode switch is set to Off, highlighted in turquoise.

The switch "Edit mode" turns editing of the page on and off.

In the course editor:

Three marked steps: course element Page, tab Page content, button Edit page.

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.

The option Edit page is ticked for coaches.

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.

To the top of the page ^


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.

The Add content dialog in the form editor with the additional area Question types.

To the top of the page ^


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.

Selection of the layout templates with nine grids, opened via Insert new layout.

Portfolio >

To the top of the page ^


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.

The gear icon opens the inspector with the layout templates, the selected one is marked in turquoise.

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

The arrows marked in turquoise on the right edge move the whole 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.

To the top of the page ^


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 link in every area of the layout, the arrow points to the area on the right.

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.

The highlighted gear in the toolbar opens the highlighted inspector of the image block, in which you set the properties of the image via the tabs Style, Title, Display, Media and Layout

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 .

Highlighted toolbar above a selected image block with the four icons gear, Duplicate, three-dot menu and arrow cross, with which you configure, copy, extend or move the block

To the top of the page ^


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

Image, text and form elements sit close together. Example page with the spacing S.

Visible spacing between image, text and form elements. Same example page with the spacing M.

Image, text and form elements are set far apart. Same example page with the spacing XL.

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.

The alert box is switched on, the list of types is open.

Example:

Two finished alert boxes with icon, title and coloured frame in the text of a page.

To the top of the page ^


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 >

To the top of the page ^


Content types

Which elements are available depends on where you use the Content Editor.

The Add content dialogue with the content types by area, at the bottom Media Center and Import.

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.

Highlighted in the inspector of a title block the selection Size with the level h3, with which you set the size of the title

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.

Formatting bar of a selected text block with font style, colours, lists, link and formula.

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.

Fields for row and column, row header and column header as well as the row style.

Math formula

A special small editor is available for mathematical formulas.

Input field in the content block with the formula keyboard and its registers.

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.

Two code blocks in Java and C sharp with line numbers, syntax colours and a copy symbol.

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.

To the top of the page ^


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

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.

The same image series as a slideshow, as a preview with thumbnails and as a grid.

Image comparison

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

Two image comparisons, the slider fades horizontally on the left and vertically on the right.

Audio

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

Buttons Record audio and Add audio above the media selection.

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.

Drop field for the file, below it title, tags, topics, description and licence.

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.

Shape library, drawing area with a flow chart and style templates.

To the top of the page ^


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.

A quiz as a start card, with a correctly graded question and with a wrong answer plus solution.

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.

Open 3-dot menu with Import questions from pool and Export all questions to pool.

To the top of the page ^


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.

The table of contents lists the following titles as jump marks, H1 to H4 are ticked in the inspector.

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.

To the top of the page ^


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.

Assessment wrong with 0 percent, overall appraisal and Feedback reliability high, Detailed feedback collapsed

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.

AI correction dialogue with the note on the default of the institution and the highlighted buttons Allow once, Always allow and Not now

  • "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

To the top of the page ^


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.

The Import button marked in turquoise at the bottom edge of the Content Editor.

In the import dialogue you choose between two options:

The modes Upload file and Paste text, the selected file and, highlighted, the switches Add AI generated Quiz and Generate image metadata with AI

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.

The marked Import button in the Add content dialogue.

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.

The switch Add AI generated Quiz opens the highlighted fields MC question to Learning objectives, in between the switch Generate image metadata with AI

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.

To the top of the page ^


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.

Open Add media file menu with document, diagram, text, video, audio and quote.

Media Center (User tools) >
Detailed information about the Media Center (Basic concept) >

To the top of the page ^


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 >

To the top of the page ^