Assets Bilder

Flyo bietet die Möglichkeit, Bilder ohne zusätzliche Software an den aktuellen Verwendungszweck anzupassen. Dazu gehören unter anderem das Beschneiden von Bildern, das Zuschneiden nach Fokuspunkt oder das Formatieren von Dateien in ein anderes Dateiformat.

Erlaubte Formate: gif, jpg, jpeg, pjpeg, png, webp

Maximale Dateigrösse pro Format:

gif: 4 MB
png: 6 MB
jpg / jpeg / pjpeg / webp: 8 MB

Maximalabmessungen (alle Bilder): bis 9000 × 9000 px

Maximale Anzahl Pixel (Breite × Höhe):

gif: 4’194’304 Pixel (z.B. 2048 × 2048 oder 4096 × 1024)
png: 8’294’400 Pixel (z.B. 3840 × 2160 / 4K)
jpg / jpeg / pjpeg / webp: 81’000’000 Pixel (9000 × 9000)

Die Dateigrösse und die Pixel-Limiten gelten unabhängig davon, ob das Bild über die Flyo-Oberfläche oder über die API hochgeladen wird. Die grösseren Limiten für Dateien und Videos gelten für Bilder ausdrücklich nicht, da Bilder von Flyo weiterverarbeitet werden.

Bilder werden beim Hochladen verkleinert

Flyo speichert kein Bild, dessen längere Seite grösser als 2560 px ist. Ein Bild wird direkt nach dem Hochladen proportional verkleinert, bis Breite und Höhe innerhalb von 2560 px liegen — ein 8K-Bild (7680 × 4320) wird also als 2560 × 1440 gespeichert. Die hochgeladene Originalauflösung bleibt nicht erhalten.

Zusätzlich werden dabei die EXIF-Daten entfernt (die darin hinterlegte Bildausrichtung wird vorher angewendet) und das Bild neu komprimiert: jpg mit Qualität 90, webp mit Qualität 80, png mit Kompressionsstufe 6. Die oben genannten Dateigrössen gelten für die hochgeladene Datei, die gespeicherte Datei ist in der Regel deutlich kleiner.

Bilder unter 2560 px werden nicht vergrössert.

TIP

Die Prüfung der Limiten erfolgt vor dem Verkleinern. Da png und gif deutlich kleinere Pixel-Limiten haben als jpg und webp, wird ein sehr grosses png abgelehnt, obwohl es beim Speichern ohnehin auf 2560 px verkleinert würde. In diesem Fall das Bild vor dem Hochladen verkleinern oder als jpg bzw. webp hochladen.

Zuschneiden

Via https://storage.flyo.cloud/{DATEINAME} sind alle Bilder, die in Flyo hochgeladen wurden, aufrufbar. Um via URL eine kleinere Version eines Bildes aufzurufen, kann die gewünschte Auflösung mit den Parametern w (Breite) und h (Höhe) an die URL angehängt werden:

Aufbau	Beispiel
`{DATEINAME}?w={BREITE}&h={HÖHE}`	`example.jpg?w=300&h=300`

Anstelle von DATEINAME den Dateinamen eingeben und anstelle von BREITE und HÖHE die gewünschte Grösse in Pixel. Um Bildbreite oder Bildhöhe dynamisch anhand des Seitenverhältnisses berechnen zu lassen, lässt du den entsprechenden Parameter weg — das ist die einzige Schreibweise dafür. Werden beide weggelassen, erhältst du das Originalbild.

Schauen wir uns die Funktion zuschneiden in einem Beispiel an:

Grösse	Beispiel
Original https://storage.flyo.cloud/integrationsgruppe-flyowebseite_7a158241.jpg
`?w=250&h=250`: Gleiche Höhe und Breite definiert: https://storage.flyo.cloud/integrationsgruppe-flyowebseite_7a158241.jpg?w=250&h=250
`?w=250`: Höhe dynamisch berechnet anhand der Breite mit dem originalen Seitenverhältnis: https://storage.flyo.cloud/integrationsgruppe-flyowebseite_7a158241.jpg?w=250
`?h=250`: Breite dynamisch berechnet anhand der Höhe mit dem originalen Seitenverhältnis: https://storage.flyo.cloud/integrationsgruppe-flyowebseite_7a158241.jpg?h=250

INFO

Da Bilder in Flyo beim Hochladen auf eine maximale Breite und Höhe von 2560 Pixel verkleinert werden (siehe oben), gilt dies auch als Limit für Breiten- und/oder Höhendefinitionen. Grössere Werte werden automatisch auf 2560 begrenzt.

Ältere Schreibweise

Die bisherige Schreibweise {DATEINAME}/thumb/{BREITE}x{HÖHE} (z.B. example.jpg/thumb/300x300) funktioniert unverändert weiter — bestehende Links müssen also nicht angepasst werden. Für neue Integrationen empfehlen wir die Parameter-Schreibweise, da die URL damit auf die Dateiendung endet (.jpg), was für CDNs, Proxies und Download-Funktionen relevant ist.

Der Wert null für eine dynamische Seite gehört ausschliesslich zur alten Schreibweise: example.jpg/thumb/250xnull ist gültig, example.jpg?w=250&h=null hingegen nicht — dort lässt du den Parameter stattdessen weg.

Die vollständige Gegenüberstellung — was weiterhin funktioniert, was neu ist und was nicht (mehr) unterstützt wird — steht unter Migration auf die Query-Parameter.

Zuschneiden beim Mapping

Wird ein Bild via Mapping zur Verfügung gestellt, kann die Bildgrösse ebenfalls bestimmt werden. Dies geschieht indem ein Filter aktiviert wird auf dem verknüpften Bild und die gewünschte Bildgrösse hinterlegt wird. Es kann auch jeweils anstelle einer Pixelangabe "null" verwendet werden, was immer der Originalhöhe resp. -breite entspricht.

Zuschneiden und Grösse verändern im UI

Im Dateimanager kann mit wenigen Klicks:

die Grösse des Bilds verändert

oder

das Bild zugschnitten werden

und als neues Bild gespeichert werden.

Fokuspunkt

Manchmal kommt es vor (gewollt oder ungewollt), dass das wichtigste Element in einem Bild nicht genau in der Mitte liegt. Aus diesem Grund kannst du in Flyo bei jedem Bild einen Fokuspunkt definieren. Sobald du bei einem Bild einen Fokuspunkt setzt, wird das Bild auf diesen Punkt zentriert. Du kannst den Fokuspunkt setzen oder verschieben, in dem du mit der Maus an die entsprechende Stelle im Bild klickst. Der Fokuspunkt wird angewendet, sobald das entsprechende Bild mit einem URL-Filter aus Flyo abgerufen wird. Achtung: eine bestimmte Bildstelle zu zentrieren, bedeutet immer, dass das Bild zugeschnitten werden muss - darum wirst nur dort einen Effekt sehen, wo das Bild zugeschnitten wird. Wenn der Fokuspunkt zu nahe am Rand liegt im Verhältnis zum gesamten Bildausschnitt, wird er nicht zentriert werden können. Dennoch hilft er dabei, den idealen Bereich auszuschneiden.

TIP

Der Fokus kommt nur bei Zuschneidungen ohne dynamische Seitenverhältnisse zur Anwendung. Konkret heisst dies, dass ?w=250&h=250 den Fokus verwenden würde, aber ?w=250 nicht.

Löschschutz

Mit dem Toggle Löschschutz (über den Dateimanager in der Flyo-Oberfläche) kann verhindert werden, dass ein Bild versehentlich gelöscht wird, obwohl es unabhängig von einem Inhalt z.B. im Footer einer Website verwendet wird.

Format konvertieren

In gewissen Szenarien kann ein bestimmtes Dateiformat Vorteile bieten, z.B. JPG für eine bessere Bildqualität und PNG als Ersatz für GIF mit der Möglichkeit transparenter Hintergründe. Webp als Beispiel, erzeugt sehr effiziente Bilder und sollte für Webseiten verwendet werden. Um diesen Anforderungen gerecht zu werden, kann das Format bei der Erstellung eines Filters mit dem Parameter format query ausgewählt werden. Es ist also nur möglich, das Zielformat der Datei beim Beschneiden zu wählen, nicht für die Originaldatei. Ein Beispiel würde folgendermassen aussehen: image_7a158241.jpg?w=250&h=250&format=webp. Die folgenden Formate werden unterstützt:

webp
jpg
jpeg
png
gif

WARNING

format wirkt nur zusammen mit einer Grössenangabe. image_7a158241.jpg?format=webp ohne w oder h gibt die unveränderte Originaldatei im Originalformat zurück.

Download erzwingen

Alle oben beschriebenen Parameter lassen sich mit download=1 kombinieren, damit die Datei heruntergeladen statt im Browser angezeigt wird — zum Beispiel image_7a158241.jpg?w=250&h=250&download=1. Siehe auch Assets Dateien.

Migration auf die Query-Parameter

Seit dem 06.08.2026 wird die Bildgrösse als Query-Parameter an die Datei-URL gehängt (example.jpg?w=300&h=300) statt als Pfad-Segment (example.jpg/thumb/300x300). Der Grund: mit der alten Schreibweise endet die URL auf 300x300 statt auf .jpg, und jede Schicht, die auf die Dateiendung schaut — CDN-Regeln, Proxies, Download-Handler, Content-Sniffing, Link-Scraper — behandelt sie deshalb falsch.

Du musst nichts sofort ändern. Bestehende Links funktionieren weiter. Dieser Abschnitt ist die vollständige Referenz für den Umstieg.

Auf einen Blick

Alt (weiterhin gültig)	Neu (empfohlen)
`example.jpg/thumb/300x300`	`example.jpg?w=300&h=300`
`example.jpg/thumb/300xnull`	`example.jpg?w=300`
`example.jpg/thumb/nullx300`	`example.jpg?h=300`
`example.jpg/thumb/300x300?format=webp`	`example.jpg?w=300&h=300&format=webp`
`example.jpg/thumb/300x300?download=1`	`example.jpg?w=300&h=300&download=1`
`example.jpg/thumb/nullxnull`	`example.jpg` (das Original)

Faustregel: x wird zu &, null wird weggelassen.

Was weiterhin funktioniert (deprecated)

{DATEINAME}/thumb/{BREITE}x{HÖHE} bleibt vollständig unterstützt, inklusive aller bisherigen Schreibweisen für eine dynamische Seite (250xnull, 250x0, nullxnull). Es gibt keinen Stichtag, an dem bestehende Links brechen:

Die Schreibweise ist seit dem 06.08.2026 als veraltet markiert und wird frühestens nach dem 06.08.2028 entfernt.
Vor einer Entfernung messen wir die tatsächliche Nutzung und kündigen sie an.
Für neue Integrationen verwendest du die Parameter-Schreibweise.

Was neu unterstützt wird

?w= und ?h= direkt an der Datei-URL — die URL endet damit auf die Dateiendung.
Eine Seite weglassen für eine dynamische Berechnung anhand des Seitenverhältnisses (?w=250, ?h=250).
Beliebig kombinierbar mit format und download (?w=250&h=250&format=webp&download=1).
Werte über 2560 werden automatisch auf 2560 begrenzt — ?w=5000 und ?w=2560 liefern dasselbe Bild.

Was nicht (mehr) unterstützt wird

URL	Antwort	Stattdessen
`example.jpg?w=250&h=null`	400	`example.jpg?w=250`
`example.jpg?w=250&h=` (leer)	400	`example.jpg?w=250`
`example.jpg?w=250&h=0`	400	`example.jpg?w=250`
`example.jpg?w=0250`, `?w=00`	400	`example.jpg?w=250`
`example.jpg?w=-5`, `?w=abc`, `?w=1.5`	400	eine positive Ganzzahl
`example.jpg?format=webp` (ohne Grösse)	Originaldatei, unverändert	`example.jpg?w=250&format=webp`
`example.jpg/filter/300x300`	404, entfernt am 06.08.2026	`example.jpg?w=300&h=300`
`example.jpg/{BELIEBIGES WORT}/300x300`	404, entfernt am 06.08.2026	`example.jpg?w=300&h=300`
`/filter/thumb/300x300/example.jpg`	404, entfernt am 06.08.2026	`example.jpg?w=300&h=300`

Nur eine Schreibweise pro Grösse

null, 0 und ein leerer Wert sind in der neuen Schreibweise bewusst alle ungültig, obwohl die alte sie akzeptiert. Jede zusätzlich erlaubte Schreibweise wäre für CDNs eine eigene URL und damit ein eigenes Cache-Objekt für dasselbe Bild — mit dem Ergebnis, dass ein Bild nach einer Änderung an einer Stelle noch veraltet ausgeliefert wird. Eine dynamische Seite wird deshalb ausschliesslich durch Weglassen des Parameters ausgedrückt.

Werte für `w` und `h`

Wert	Bedeutung
`250` (positive Ganzzahl)	250 Pixel
Parameter weggelassen	dynamisch anhand des Seitenverhältnisses
beide Parameter weggelassen	das Originalbild (`example.jpg`)
`> 2560`	wird auf 2560 begrenzt
`0`, leer, `null`, führende Nullen, alles andere	400 Bad Request

Was sich nicht ändert

Dasselbe Bild. example.jpg?w=300&h=300 und example.jpg/thumb/300x300 liefern byte-identische Dateien — es ist dieselbe Variante, sie wird nicht doppelt erzeugt und belegt keinen zusätzlichen Speicher.
Fokuspunkt. Gilt weiterhin nur bei Zuschneidungen ohne dynamische Seite: ?w=250&h=250 verwendet ihn, ?w=250 nicht.
Formate und Limiten. Unverändert, siehe oben.

Nach der Umstellung

Für ein CDN ist die neue URL eine andere URL als die alte. Nach der Umstellung wird jedes Bild einmalig neu ausgeliefert und danach wieder aus dem Cache. Das ist einmaliger Traffic, kein dauerhafter Mehraufwand.

Vorgehen

Im Projekt nach /thumb/ und /filter/ suchen.
x durch & ersetzen: /thumb/300x300 → ?w=300&h=300.
Jedes null durch Weglassen des Parameters ersetzen: /thumb/300xnull → ?w=300.
Prüfen, ob die URL bereits ein ? enthält (z.B. ?download=1) — dann mit & anhängen statt mit ?.
Aufrufen und prüfen: Ein 400 bedeutet eine ungültige Grössenangabe, ein 404 eine der entfernten Pfad-Schreibweisen.

Regelwerk zum Kopieren

Der folgende Block enthält alle Regeln kompakt — zum Weitergeben an Entwickler:innen oder als Kontext für KI-Agenten:

text

Flyo Bild-URLs (storage.flyo.cloud), Stand 06.08.2026

EMPFOHLEN
  {datei}                          Originalbild
  {datei}?w=300&h=300              feste Grösse
  {datei}?w=300                    Höhe dynamisch (Seitenverhältnis)
  {datei}?h=300                    Breite dynamisch
  {datei}?w=300&h=300&format=webp  Format konvertieren (webp|jpg|jpeg|png|gif)
  {datei}?w=300&h=300&download=1   als Download ausliefern

REGELN
  - w/h sind positive Ganzzahlen ohne führende Nullen.
  - Eine dynamische Seite wird durch WEGLASSEN des Parameters ausgedrückt.
  - 0, leerer Wert und der Text "null" sind ungültig -> HTTP 400.
  - Werte > 2560 werden auf 2560 begrenzt.
  - format ohne w/h wird ignoriert; es kommt die unveränderte Originaldatei.
  - Der Fokuspunkt wirkt nur, wenn w UND h gesetzt sind.

VERALTET, FUNKTIONIERT ABER WEITER (Entfernung frühestens nach dem 06.08.2028)
  {datei}/thumb/300x300
  {datei}/thumb/300xnull           dynamische Seite, hier ist "null" gueltig

ENTFERNT AM 06.08.2026 -> HTTP 404
  {datei}/filter/300x300
  {datei}/{beliebiges-wort}/300x300
  /filter/thumb/300x300/{datei}

MIGRATION
  /thumb/{B}x{H}    ->  ?w={B}&h={H}
  /thumb/{B}xnull   ->  ?w={B}
  /thumb/nullx{H}   ->  ?h={H}

Felder

Nitro CMS

Venue

Signage OS

Berechtigungslogik

Nitro CMS Editor

Einstellungen