{"canonical_url":"https://engineer.company/de/glossary/webmanifest/","content_markdown":"# Web-App-Manifest\n\n## Was es ist\n\nEin Web-App-Manifest ist ein JSON-Dokument, das eine Website als Anwendung\nbeschreibt: ihren Namen, ihre Startadresse, die zugehörigen Adressen, das Aussehen\nihres Fensters und die Bilder, die sie repräsentieren. Eine Seite verweist mit\neinem `link`-Element und `rel` gleich `manifest` auf die Datei. Ein Browser, der\neine Installation anbietet, liest daraus, welche Eigenschaften die installierte\nFassung haben soll. Die W3C-Spezifikation nennt es schlicht Manifest, ebenso wie der übliche\nSprachgebrauch.\n\nDie Datei ist gewöhnliches JSON. Ihr registrierter Medientyp ist\n`application/manifest+json`, ihre registrierte Endung `.webmanifest`. Die\nSpezifikation akzeptiert jedoch jeden JSON-Medientyp, und viele Websites liefern\neine `manifest.json` aus. Alle Einträge sind optional. Ein kleines Manifest für\neine erfundene Website mit Gezeitentabellen sieht so aus:\n\n```json\n{\n    \"name\": \"Harbour Tide Tables\",\n    \"short_name\": \"Tides\",\n    \"start_url\": \"/tides/\",\n    \"display\": \"standalone\",\n    \"background_color\": \"#ffffff\",\n    \"icons\": [\n        {\n            \"src\": \"/icons/tides-512.png\",\n            \"sizes\": \"512x512\",\n            \"type\": \"image/png\"\n        }\n    ]\n}\n```\n\nDrei Einträge bestimmen, was die App ist, im Unterschied zu ihrem Aussehen.\n`start_url` schlägt die Seite vor, mit der die installierte App startet. Der Browser\nkann sie ignorieren oder dem Nutzer erlauben, sie zu ändern. `scope` ist die Menge\nder Adressen innerhalb der App. Fehlt dieser Eintrag, verwendet die Spezifikation\ndie Start-URL ohne Dateinamen, Abfrage und Fragment. Im Beispiel gehört damit alles\nunter `/tides/` zur App. `id` ist ihre Identität und fällt, wenn es fehlt, auf die\nStart-URL zurück. Relative Iconadressen und die Start-URL werden relativ zur URL\ndes Manifests aufgelöst, nicht zu der Seite, die es verlinkt. Eine relative `id`\nbezieht sich dagegen auf die Origin der Start-URL.\n\nDie übrigen Einträge betreffen die Darstellung. `display` fordert `fullscreen`,\n`standalone`, `minimal-ui` oder `browser` an. Kann ein Browser die gewünschte\nDarstellung nicht umsetzen, geht er diese Liste in der angegebenen Reihenfolge\nweiter. Jedes Icon kann einen `purpose` haben: standardmäßig `any`, `maskable` für\nein Bild, das einen Beschnitt verträgt, oder `monochrome` für eines, dessen Farbe\nverworfen und nur dessen Alphakanal verwendet wird. `theme_color` färbt den\nFensterrahmen der App. Eine ergänzende W3C-Note beschreibt `description`,\n`categories` und `screenshots`, die Installationsdialoge und App-Stores anzeigen\nkönnen.\n\n## Warum es wichtig ist\n\nDas Manifest liefert Installationsmetadaten unter der Kontrolle der Website.\nDie Spezifikation überlässt die Installationsentscheidung dem Browser: Er kann\neinen Installationsweg anbieten und legt seine Bedingungen selbst fest. Einige\ndavon verlangen bestimmte Einträge. Das Team liefert die Eingabe, der Browser\nentscheidet über ihre Verwendung. Die nützliche Frage ist daher weniger, ob ein\nManifest nötig ist, sondern was es verspricht.\n\nDie Identität ist das Versprechen, das die Datei überdauert. Ruft ein Browser\ndas Manifest erneut ab, soll er laut Spezifikation eine übereinstimmende `id` als\nHinweis verstehen, dass die neue Datei das Manifest einer bereits installierten\nApp ersetzt. Ohne `id` ist die Start-URL die Identität. Wird die Startseite\nverschoben, ändert sich diese stillschweigend, und der Browser soll die neue Datei\nals andere Anwendung behandeln als die auf dem Gerät des Lesers. Eine feste `id`\nab der ersten Veröffentlichung kostet eine Zeile und beseitigt dieses Risiko.\n\nDer Geltungsbereich bestimmt, wo das App-Fenster endet. Navigation innerhalb\ndieses Bereichs bleibt im installierten Fenster. Ein Link nach außerhalb öffnet\nsich weiterhin, doch die Spezifikation erwartet, dass der Browser den Wechsel aus\nder App kenntlich macht. Ein engerer Bereich als die Website lässt damit normale\nLinks zwischen ihren Abschnitten wie Ausgänge wirken.\n\nBei Icons entstehen die meisten sichtbaren Schäden. Startoberflächen schneiden\nsie zu Kreisen, abgerundeten Quadraten und anderen Formen zu. Ein Logo, das sein\nganzes Quadrat ausfüllt, verliert dabei die Ränder. Für ein maskierbares Icon\ndefiniert die Spezifikation die sichere Zone als mittigen Kreis mit einem Radius\nvon zwei Fünfteln der kürzeren Iconseite. Alles außerhalb darf abgeschnitten\nwerden. Ein monochromes Icon behält nur seinen Alphakanal. Ein Icon auf einem\nundurchsichtigen Hintergrund wird dadurch zu einem ausgefüllten Quadrat.\n\nDie Farbeinträge haben einen engeren Zweck, als es scheint. `background_color`\nist nur für den Moment gedacht, bevor das Stylesheet eintrifft. Die Spezifikation\nverbietet dem Browser, den Wert zu verwenden, sobald das Stylesheet verfügbar ist.\nDer Eintrag bestimmt nur die Hintergrundfarbe der ersten Darstellung.\n\n## Wie es in der Praxis aussieht\n\nDiese Website erzeugt ihr Manifest aus einer Vorlage, statt eine Datei von Hand\nzu pflegen. Die Hugo-Konfiguration registriert `application/manifest+json` mit der\nEndung `webmanifest` und legt das Manifest als Ausgabe der Startseite jeder\nSprache fest. So bekommt jede Sprache eine eigene Datei, und der Kopf jeder Seite\nverlinkt die Datei ihrer Sprache. Die Konfiguration hält den Grund fest: Eine\nglobale Fassung kann nur eine Start-URL nennen. Ein Besucher, der die dänische Fassung der\nWebsite installierte, bekam deshalb eine App mit der englischen Startseite.\n\nDie Vorlage baut das Manifest als Zuordnung auf und übergibt sie Hugos\nJSON-Kodierer. Escapezeichen und Kommas sind damit dessen Aufgabe; ein fehlendes\nKomma kann nicht veröffentlicht werden. Jede Iconadresse beginnt an der Wurzel\ndes Hosts. Der Kommentar begründet das ausdrücklich: Eine relative Adresse in\n`/da/manifest.webmanifest` würde unter `/da/` aufgelöst, und jedes Icon der dänischen\nFassung würde einen 404-Fehler liefern. Die Icons selbst werden aus drei Ordnern\nim Dateisystem gelesen, einem pro Verwendungszweck, mit je zehn Größen von 36\nbis 512 Pixeln. Die Größe stammt aus dem Dateinamen. Eine vom Generator ergänzte\nGröße erscheint daher ohne weitere Änderung im Manifest.\n\n`id` ist auf die Startadresse der jeweiligen Sprache festgelegt, `scope` umfasst\ndie gesamte Origin. Ein Link in eine andere Sprache bleibt somit im installierten\nFenster. Screenshots heißen `\u003clang\u003e-\u003cform_factor\u003e-\u003cWxH\u003e.webp`. Die Vorlage liest\nalle drei Angaben aus dem Dateinamen: Englisch und Dänisch haben jeweils eine\nbreite Aufnahme mit 1.280 mal 800 und eine schmale mit 780 mal 1.688 Pixeln. Bei einer\nSprache ohne Screenshots fehlt der Eintrag `screenshots` vollständig, statt eine\nleere Liste zu enthalten.\n\nDie [Credits-Seite](/de/credits/) führt die W3C-Spezifikation unter den Standards\nder Website auf und PWABuilder unter den externen Prüfungen, die jeder ausführen\nkann. Der Dienst liest von Microsofts Rechnern aus das Manifest und die übrigen\nBestandteile, die die Website installierbar machen.\n\nDie [Installationsseite](/de/install/) erklärt dieselbe Datei aus Lesersicht.\nSie zeigt, wo die einzelnen Browser den Installationsbefehl anbieten, und weist\ndarauf hin, dass Apples Browser nie von sich aus dazu auffordern. Firefox bietet\nein separates Fenster für Web-Apps, unter Windows standardmäßig ab Version 143\nbeziehungsweise bei Installationen aus dem Microsoft Store ab Version 150.\nMozillas Implementierungsdokumentation nennt Linux-Unterstützung als standardmäßig\ndeaktiviert und macOS-Unterstützung als nicht verfügbar. Die Seite klärt auch,\nwas bei dieser Website zu erwarten ist: Die installierte App ist ein Icon und\nein eigenes Fenster. Die Website veröffentlicht weder einen Service Worker noch\neine verwaltete Offlinekopie. Für die normale Nutzung braucht sie daher eine\nVerbindung.\n\n## Wo es schiefgeht\n\n**Alle Icons liefern unter übersetzten Pfaden 404.** Ein relatives `src` wird\nrelativ zur URL des Manifests aufgelöst. Ein Manifest unter einem Sprachpräfix\nfordert Icons deshalb unter diesem Präfix an. Schreiben Sie Iconadressen von der\nWurzel des Hosts aus oder als vollständige URLs.\n\n**Die installierte App startet in der falschen Sprache.** Ein Manifest kann\neine Start-URL angeben, also installieren alle Leser dieselbe Startseite. Liefern\nSie für jede Sprache ein eigenes Manifest mit eigener `start_url` und `id` aus\nund verlinken Sie auf jeder Seite die passende Fassung.\n\n**Installierte Fassungen ignorieren das neue Manifest.** Ohne `id` bestimmt die\nStart-URL die Identität. Das Verschieben der Startseite gibt der Datei daher eine\nneue Identität, und der Browser soll sie als andere App behandeln als die bereits\ninstallierte. Legen Sie `id` vor der ersten Veröffentlichung fest und lassen Sie\nden Wert danach unverändert.\n\n**Die Startoberfläche beschneidet das Logo.** Ein Icon mit dem Zweck `any` wird\nnach Ermessen der Plattform platziert oder zugeschnitten. Ergänzen Sie ein\n`maskable`-Icon, bei dem alles Wichtige innerhalb des mittigen Kreises liegt,\ndessen Radius 40 % der kürzeren Iconseite beträgt.\n\n**Änderungen am Manifest bleiben ohne Wirkung.** Der HTML-Standard verwendet\nnur das erste `link`-Element, dessen `rel` den Wert `manifest` enthält. Hat ein Theme\noder Plugin vorher einen eigenen Link eingefügt, wird die bearbeitete Datei gar\nnicht gelesen. Belassen Sie auf jeder Seite genau einen Manifest-Link.\n\n## Weiterführende Lektüre\n\n- [Web Application Manifest](https://www.w3.org/TR/appmanifest/) — alle Einträge,\n  ihre Verarbeitung durch den Browser und die Regeln für `id`, `scope` und\n  Iconzwecke.\n- [Web App Manifest - Application Information](https://www.w3.org/TR/manifest-app-info/)\n  — `description`, `categories` und `screenshots` mit Formfaktoren und Beschriftungen.\n- [IANA: application/manifest+json](https://www.iana.org/assignments/media-types/application/manifest+json)\n  — Registrierung des Medientyps und der Endung `.webmanifest`.\n- [HTML Standard: link type manifest](https://html.spec.whatwg.org/multipage/links.html#link-type-manifest)\n  — Abruf des Manifest-Links und der Grund, warum nur der erste zählt.\n- [Use web apps in Firefox for Windows](https://support.mozilla.org/en-US/kb/web-apps-firefox-windows)\n  — die Windows-Funktion ab Version 143 beziehungsweise im Microsoft Store ab 150.\n- [Firefox Source Docs: Web Apps in Firefox](https://firefox-source-docs.mozilla.org/browser/components/taskbartabs/docs/index.html)\n  — die aktuelle Implementierung: unter Windows standardmäßig aktiviert, unter\n  Linux standardmäßig deaktiviert, unter macOS nicht unterstützt.\n\n\u003chttps://engineer.company/de/glossary/webmanifest/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Was ein Web-App-Manifest für eine installierte Website festlegt, warum seine ID gleich bleiben muss und wie Startoberflächen mit den Icons umgehen.","formats":{"gemtext":"https://engineer.company/de/glossary/webmanifest/index.gmi","gopher":"https://engineer.company/de/glossary/webmanifest/gophermap","html":"https://engineer.company/de/glossary/webmanifest/","json":"https://engineer.company/de/glossary/webmanifest/index.json","markdown":"https://engineer.company/de/glossary/webmanifest/index.md","pdf":"https://engineer.company/de/glossary/webmanifest/index.pdf"},"kind":"page","language":"de","title":"Was ist ein Web-App-Manifest?","url":"https://engineer.company/de/glossary/webmanifest/","version":1}