Mediathek: Bilder und Dateien
Bilder, PDF, Videos und Audio hochladen, in Ordnern ablegen, mit Alt-Text und Fokuspunkt versehen und auf der Website in passender Grösse ausliefern.
Worum es geht
In der Mediathek liegen alle Bilder und Dateien Ihrer Website. Sie laden sie einmal hoch und verwenden sie danach in beliebig vielen Einträgen und Seiten. Für Bilder erzeugt Scorebase automatisch kleinere Fassungen, damit Ihre Website schnell lädt.
Voraussetzungen
| Recht | Wofür |
|---|---|
| Medien anzeigen | Mediathek öffnen, Medien in Feldern auswählen |
| Medien hochladen | Dateien hochladen, Ordner anlegen, umbenennen, Angaben ändern |
| Medien löschen | Dateien und Ordner löschen, gelöschte Medien wiederherstellen |
Dateien hochladen
- Öffnen Sie Medien. Die Seite heisst Medien-Bibliothek.
- Wechseln Sie bei Bedarf in einen Ordner.
- Ziehen Sie die Dateien in das Upload-Feld oder klicken Sie hinein und wählen Sie sie aus. Mehrere Dateien auf einmal sind möglich.
- Scorebase zeigt den Fortschritt und meldet „… Dateien hochgeladen“. Schlägt eine einzelne Datei fehl, laufen die übrigen weiter.
Erlaubt sind: JPEG, PNG, WebP, AVIF, GIF, SVG, TIFF, PDF, MP4, WebM, MP3, WAV und OGG – höchstens 50 MB pro Datei.
Sie können auch direkt aus einem Feld hochladen: Klicken Sie in einem Eintrag bei einem Bild- oder Dateifeld auf Medien wählen, wechseln Sie auf den Reiter Hochladen und ziehen Sie die Dateien hinein. Verlangt das Feld ein bestimmtes Bildformat, öffnet sich vorher Bildausschnitt wählen, und hochgeladen wird der gewählte Ausschnitt.
Ordner
- Ordner anlegen: Klicken Sie auf Ordner und geben Sie einen Namen ein. Der Ordner entsteht im aktuell geöffneten Ordner.
- Wechseln: Klicken Sie auf einen Ordner. Die Pfadleiste darüber (beginnend mit Bibliothek) führt zurück.
- Umbenennen oder löschen: Fahren Sie mit der Maus über den Ordner und nutzen Sie das Stift- bzw. Papierkorb-Symbol.
Mit „Medien durchsuchen…“ finden Sie Dateien über Dateinamen und weitere Angaben. Daneben steht die Gesamtzahl der Medien.
Angaben zu einem Bild
Klicken Sie auf ein Bild. Im Detailfenster sehen Sie Dateityp, Grösse und Abmessungen und können ergänzen:
| Feld | Wofür |
|---|---|
| Titel | Interner Name, z.B. für die Suche |
| Alt-Text | Beschreibung für Screenreader und Suchmaschinen. Bitte immer ausfüllen. |
| Bildunterschrift | Text, den die Website unter dem Bild zeigen kann |
| Tags | Stichworte zum Ordnen („Tag hinzufügen…“) |
Fokuspunkt: Klicken Sie im Bild auf die wichtigste Stelle, z.B. ein Gesicht. Wird das Bild für die Website zugeschnitten, bleibt diese Stelle im Bild.
Mit Speichern übernehmen Sie die Angaben. Varianten erzeugen legt die verkleinerten Fassungen neu an (sonst geschieht das beim Hochladen automatisch).
Alternativtext und Fokuspunkt gehören zum Bild selbst. Sie gelten überall und sofort, wo das Bild vorkommt, auch auf veröffentlichten Seiten; sie werden nicht mit einer Seite veröffentlicht. Fehlt der Alternativtext, warnt das Detailfenster („Alternativtext fehlt. Ohne ihn können Screenreader das Bild nicht beschreiben.“). Medien, die Sie aus dem Vorschaufenster hochladen, landen im Hauptordner (oberste Ebene) der Medien der Umgebung.
Wo ein Bild verwendet wird
Jede Kachel zeigt, ob das Bild gebraucht wird: Auf n Seiten, Im Layout · alle Seiten oder Nicht verwendet. Steht es nicht nur auf Seiten, sondern auch in Einträgen oder Komponenten, heisst es An n Orten. Mit Nach Verwendung filtern (Alle, Verwendet, Nicht verwendet) finden Sie Bilder, die niemand mehr braucht.
Ein Klick auf ein Bild öffnet rechts (auf schmalen Bildschirmen als Blatt) die Details mit Verwendet auf. Die Liste nennt zu jeder Stelle die Art (Seite, Eintrag, Layout, Seitenvorlage, Komponente, Menü, Block-Vorschaubild oder SEO-Bild), den Ort („Titel › Block“), den Stand (Veröffentlicht oder Entwurf) und einen Link Öffnen. Stellen anderer Umgebungen nennt sie mit dem Namen der Umgebung, ohne Link. Weitere Stellen laden Sie mit Weitere Stellen laden; Stellen, die Sie nicht öffnen dürfen, zählt die Liste mit. Dazu steht, in wie vielen Kampagnen oder Vorlagen die Datei steckt.
Gezählt werden Seiten, Einträge, Layouts und Komponenten in allen Umgebungen, auch Entwürfe. Beim ersten Öffnen zählt Scorebase den Bestand nach („Verwendung wird gezählt …“); bis dahin ist der Filter gesperrt und es können Stellen fehlen.
Datei ersetzen
Datei ersetzen tauscht das Motiv, ohne dass Sie irgendwo etwas neu einsetzen müssen. Alle Stellen bleiben verbunden und zeigen danach die neue Datei. Die neue Datei muss von derselben Art sein (ein Bild lässt sich nur durch ein Bild ersetzen). Vor dem Tausch zeigt eine Bestätigung, an wie vielen Stellen die neue Datei erscheint. Sie brauchen dafür das Recht, Medien hochzuladen.
Löschen mit Warnung
Löschen legt ein Bild in den Papierkorb; die Datei bleibt dabei erhalten. Wird das Bild noch verwendet, warnt ein Dialog („Bild wird noch verwendet“) und nennt unter Betroffene Stellen, wo es fehlen würde, dazu den Hinweis auf Datei ersetzen. Stellen ansehen bringt Sie zur Liste zurück, Abbrechen schliesst den Dialog, Trotzdem in den Papierkorb legt das Bild ab: Die Stellen zeigen danach kein Bild mehr. Wird das Bild nirgends verwendet, genügt eine einfache Bestätigung. Dafür brauchen Sie das Recht, Medien zu löschen.
Medien und Umgebungen
Die Mediathek zeigt die Medien der aktiven Umgebung und dazu Medien, die allen Umgebungen gemeinsam gehören. Neue Uploads gehören zur aktiven Umgebung. Prüfen Sie deshalb oben in der Seitenleiste die Umgebung, bevor Sie hochladen.
Gelöschte Medien
Gelöschte Medien landen im Papierkorb der Umgebung (Menüpunkt in der Seitenleiste; die Verknüpfung Papierkorb steht auch oben in der Mediathek). Wiederherstellen holt das Bild zurück, und es erscheint wieder an allen Stellen, an denen es eingebunden ist. Endgültig löschen entfernt die Datei mit allen Varianten aus dem Speicher; das lässt sich nicht rückgängig machen. Der Dialog nennt vorher, an wie vielen Stellen das Bild danach dauerhaft fehlt und wie viele versendete Kampagnen es zeigen. Medien, die vor dieser Umstellung gelöscht wurden, haben unter Umständen keine Datei mehr; dann müssen Sie das Bild neu hochladen.
Für Entwickler: Bilder in der passenden Grösse ausliefern
Transform-Adresse
Jedes Bild lässt sich über eine Adresse in beliebiger erlaubter Grösse abrufen:
https://<ihre-organisation>.scorebase.ch/headless/api/v1/media/<id>/transform?w=640&fm=webp
| Parameter | Werte |
|---|---|
w |
Breite: 64, 128, 256, 320, 480, 640, 768, 960, 1080, 1200, 1280, 1600, 1920, 2048 |
h |
Höhe: dieselben Werte sowie 360, 427, 540, 675, 720, 853 |
fit |
cover (Standard), contain, inside |
q |
Qualität 40 bis 90 (Standard 80) |
fm |
webp, avif, jpeg, png |
w oder h ist Pflicht. Andere Werte werden mit Fehler 400 abgewiesen – so bleibt die Zahl der erzeugten Fassungen begrenzt. Die Adresse braucht kein Token, antwortet immer mit einer Weiterleitung auf die fertige, dauerhaft zwischengespeicherte Fassung, vergrössert nie über das Original hinaus und berücksichtigt den Fokuspunkt. Je IP sind 60 Abrufe pro Minute erlaubt.
Feste Fassungen
Beim Hochladen legt Scorebase für Bilder feste Fassungen im Format WebP an (ohne Vergrösserung, die kleinste immer):
| Name | Breite |
|---|---|
thumb |
320 px |
md |
768 px |
lg |
1600 px |
webp |
2048 px |
Wird ein Eintrag mit populate geladen, stehen sie unter variants des Medienobjekts.
Helfer in den Vorlagen
Bild- und Dateifelder enthalten ohne populate nur die ID des Mediums, mit populate ein Objekt mit url. Der Helfer cmsMediaUrl aus cms/client.ts der Vorlagen löst beides auf:
import { cmsMediaUrl } from "@/cms/client"
const src = await cmsMediaUrl(entry.data.cover, { w: 960, fm: "webp" })
if (src) return <img src={src} alt={entry.data.coverAlt ?? ""} />- Eingebettetes Medium mit
url→ diese Adresse. - Reine ID → Transform-Adresse; ohne
wundhmit Breite 1600. - Sonst
undefined– die Komponente zeigt dann nichts.
Für responsive Bilder bietet das SDK srcSet und imgProps. Geben Sie die Breiten ausdrücklich aus der erlaubten Liste an, z.B. widths: [320, 640, 960, 1200, 1920].
Hochladen per Kommandozeile
hcms media upload --file ./bilder/hero.jpg --file ./bilder/logo.svg
hcms media upload --dir ./bilder --folder Kampagne2026
hcms media list --search hero --limit 40--dir lädt alle Dateien eines Ordners (ohne Unterordner), --folder legt den Zielordner in der Mediathek bei Bedarf an. Ein Fehler bei einer Datei bricht den Rest nicht ab. Der Befehl braucht ein Token mit der Berechtigung Verwaltung.
Wenn etwas nicht klappt
| Symptom | Ursache | Lösung |
|---|---|---|
| „Dateityp nicht erlaubt“ | Das Format steht nicht in der Liste oben (z.B. HEIC, DOCX) | Datei umwandeln, z.B. in JPEG oder PDF |
| Upload bricht bei grossen Dateien ab | Die Datei ist grösser als 50 MB | Datei verkleinern oder komprimieren |
| Ein Bild fehlt in der Auswahl | Es gehört zu einer anderen Umgebung | Umgebung wechseln oder das Bild in der richtigen Umgebung hochladen |
| Bild wirkt unscharf, Hinweis „empfohlen sind mindestens …“ | Das Original ist kleiner als das Feld verlangt | Grösseres Original hochladen |
| Die Website zeigt ein Bild nicht (Fehler 400) | Die Website verlangt eine Breite, die nicht erlaubt ist | Breite aus der Liste oben verwenden |