> For the complete documentation index, see [llms.txt](https://one-loop.gitbook.io/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://one-loop.gitbook.io/help/plattform/one-loop-plattform/kurse-und-community/vorschaubild-fur-eine-kurslektion-festlegen.md).

# Vorschaubild für eine Kurslektion festlegen

Ein Vorschaubild hilft Teilnehmenden, eine Lektion sofort wiederzuerkennen. Es erscheint vor dem Start eines Videos und in der Kursübersicht neben der Lektion. Ein klarer Bildausschnitt macht den Lernbereich übersichtlicher, besonders wenn ein Kurs viele Videoeinheiten enthält.

Du kannst entweder ein passendes Standbild direkt aus einem hochgeladenen Video übernehmen oder ein eigenes Bild verwenden.

## Was du vorab wissen solltest

Ein aus dem Video übernommenes Bild funktioniert nur bei einem Video, das direkt in die Lektion hochgeladen wurde. Bei einem eingebetteten externen Videoplayer kannst du kein Standbild aus dem Player übernehmen. Verwende dort stattdessen ein eigenes Bild für die Lektionskachel.

Für gute Ergebnisse empfiehlt sich ein Bild im Querformat **16:9**, zum Beispiel **1280 × 720 Pixel** oder größer. Wähle einen klaren, kontrastreichen Ausschnitt. Sehr dunkle, unscharfe oder überladene Bilder sind in kleinen Kurskacheln schwer zu erkennen.

## Wo ein Vorschaubild angezeigt wird

Es gibt zwei Stellen, an denen ein Bild sichtbar sein kann:

| Bereich                   | Wirkung                                                         |
| ------------------------- | --------------------------------------------------------------- |
| **Video-Vorschaubild**    | Wird im Videoplayer gezeigt, bevor ein Video startet.           |
| **Lektions-Vorschaubild** | Wird auf der Kachel der Lektion in der Kursübersicht angezeigt. |

Wenn du im Videoplayer **Aktuelles Bild als Vorschaubild verwenden** auswählst und speicherst, wird dieses Bild zunächst für beide Bereiche verwendet: für das Video und für die Lektionskachel.

Möchtest du für die Kachel ein anderes Bild als im Player, wechselst du anschließend zum Bereich **Lektions-Vorschaubild** und legst dort ein separates Bild fest.

## Standbild aus einem hochgeladenen Video übernehmen

1. Öffne den gewünschten Kurs und wähle die Lektion aus.
2. Lade das Video direkt in die Lektion hoch oder prüfe, ob das vorhandene Video vollständig verarbeitet ist.
3. Öffne den Bereich **Video-Vorschaubild**.
4. Spiele das Video bis zu der Stelle ab, die als Bild verwendet werden soll.
5. Halte das Video an der gewünschten Stelle an.
6. Klicke auf **Aktuelles Bild als Vorschaubild verwenden**.
7. Prüfe, ob die Vorschau im Bereich **Video-Vorschaubild** aktualisiert wurde.
8. Klicke oben auf **Speichern**.

Das gewählte Standbild wird nach dem Speichern als Video-Vorschaubild und zunächst auch als Lektions-Vorschaubild verwendet.

## Eigenes Bild für die Lektionskachel verwenden

Ein separates Lektionsbild ist sinnvoll, wenn das Videostandbild im Player gut aussieht, die Kachel in der Kursübersicht aber ein klareres Motiv braucht.

1. Öffne die Lektion und wechsle rechts zum Bereich **Lektions-Vorschaubild**.
2. Klicke auf **Bild hochladen** oder auf **Ersetzen**, wenn bereits ein Bild vorhanden ist.
3. Wähle ein eigenes Bild im Querformat aus.
4. Prüfe die Vorschau der Kachel.
5. Speichere die Lektion.

Das separate Lektionsbild ersetzt nur die Darstellung auf der Kurs- oder Lektionskachel. Das Video kann weiterhin sein eigenes Vorschaubild behalten.

## Vorhandenes Bild ändern oder entfernen

Im Bereich des jeweiligen Vorschaubilds kannst du eine bestehende Auswahl jederzeit anpassen:

* Mit **Ersetzen** wählst du ein neues Bild.
* Mit **Entfernen** löschst du das aktuelle Bild.
* Bei einem direkt hochgeladenen Video kannst du erneut zu einer passenden Stelle springen und **Aktuelles Bild als Vorschaubild verwenden** wählen.

Speichere nach jeder Änderung. Erst danach sehen neue und zurückkehrende Teilnehmende die aktualisierte Darstellung.

## Vorschaubilder bewusst auswählen

Ein gutes Vorschaubild beantwortet auf den ersten Blick: „Worum geht es in dieser Lektion?“

Bevorzugte Motive sind:

* ein klar erkennbarer Ausschnitt aus der Übung oder dem gezeigten Ergebnis;
* ein Gesicht oder eine Grafik, wenn es für den Inhalt der Lektion wichtig ist;
* wenige gut lesbare Wörter, falls Text wirklich nötig ist;
* ein wiedererkennbarer Stil für alle Lektionen eines Kurses.

Vermeide lange Textblöcke, zu kleine Details und Screenshots mit vielen unlesbaren Bedienelementen. Das Bild soll Orientierung geben, nicht die gesamte Lektion erklären.

## Ergebnis sicher prüfen

Prüfe die Änderung nach dem Speichern an beiden sichtbaren Stellen:

1. Öffne die Lektion in der Kursbearbeitung und kontrolliere das Bild im Bereich **Video-Vorschaubild**.
2. Wechsle zu **Lektions-Vorschaubild** und prüfe, ob die Kachel das gewünschte Bild zeigt.
3. Öffne die Kursvorschau oder einen Testzugang.
4. Kontrolliere das Bild vor dem Start des Videos.
5. Kontrolliere die Lektionskachel in der Kursübersicht.
6. Prüfe bei einem separaten Lektionsbild, dass Player und Kachel tatsächlich die gewünschten unterschiedlichen Bilder verwenden.

Bei eingebetteten Videos prüfst du besonders die Lektionskachel, weil du dafür ein eigenes Bild verwendest.

## Praxisbeispiel

Eine Kursleitung zeigt in einer Videoeinheit eine konkrete Übung. Sie pausiert das direkt hochgeladene Video an der Stelle, an der die Übung gut zu erkennen ist, und klickt auf **Aktuelles Bild als Vorschaubild verwenden**. Nach dem Speichern erscheint dieses Bild sowohl vor dem Video als auch auf der Kachel der Lektion.

Für die Kursübersicht wählt sie anschließend ein eigenes, ruhigeres Bild mit dem Titel der Übung und hinterlegt es unter **Lektions-Vorschaubild**. Mit einem Testzugang prüft sie: Im Player erscheint das Standbild aus dem Video, in der Übersicht die klare Kachelgrafik.

## Typische Fehler und Lösungen

### Die Schaltfläche für das aktuelle Videobild fehlt

Prüfe, ob das Video direkt in die Lektion hochgeladen wurde. Bei eingebetteten externen Playern verwendest du stattdessen ein eigenes Bild für die Lektionskachel.

### Das Bild im Player und auf der Kachel soll unterschiedlich sein

Lege zuerst das Bild für den Player fest. Wechsle danach zu **Lektions-Vorschaubild** und lade dort ein separates Bild hoch.

### Das neue Bild erscheint nicht

Kontrolliere, ob du die Lektion nach der Auswahl gespeichert hast. Öffne danach die Kursvorschau erneut oder aktualisiere den Testzugang.

### Das Bild wirkt in der Übersicht unklar

Wähle ein kontrastreicheres Motiv im Verhältnis 16:9. Teste die Darstellung in der Kursübersicht, nicht nur in der großen Bearbeitungsansicht.

## Wichtige Grenzen

* Ein Standbild aus dem Video kannst du nur bei direkt hochgeladenen Videos auswählen.
* Bei eingebetteten externen Videoplayern steuerst du die Lektionskachel mit einem eigenen Bild.
* Das Speichern ist erforderlich, damit die Änderung für Teilnehmende sichtbar wird.
* Das aktuelle Videostandbild setzt zunächst sowohl das Video- als auch das Lektions-Vorschaubild.
* Ein separates Lektionsbild kann die Kachel ändern, ohne das Bild vor dem Video zu ersetzen.

## Zusammenhang mit Kurs-E-Mails

Ein verständliches Vorschaubild und klare Kurs-E-Mails erleichtern Teilnehmenden gemeinsam die Orientierung. Wenn du neue Lektionen oder Kursabschnitte ankündigst, prüfe deshalb auch die passenden E-Mail-Benachrichtigungen für Kurse.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://one-loop.gitbook.io/help/plattform/one-loop-plattform/kurse-und-community/vorschaubild-fur-eine-kurslektion-festlegen.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
