Base Href

Was ist Base Href?

Base Href bezeichnet die im HTML-Element <base> festgelegte Basisadresse einer Webseite. Browser lösen relative Links, Bildpfade, Skriptquellen und weitere relative URLs anhand dieser Adresse auf. Das Element steht im <head> des Dokuments. Fehlt es, dient die URL des geladenen Dokuments als Ausgangspunkt.

Base Href legt als Basisadresse fest, auf welche URL sich relative Pfade innerhalb eines HTML-Dokuments beziehen. Die Schreibweise lautet beispielsweise <base href="https://www.example.com/shop/">. Aus dem relativen Link produkte/schuhe erzeugt der Browser dadurch die vollständige Adresse https://www.example.com/shop/produkte/schuhe.

Wie Base Href funktioniert

Das <base>-Element muss innerhalb des <head>-Bereichs stehen. Es enthält keinen sichtbaren Inhalt und benötigt deshalb kein schließendes Tag. Enthält ein Dokument mehrere <base>-Elemente mit einem href-Attribut, verwendet der Browser nur den ersten gültigen Eintrag. Pro HTML-Dokument sollte deshalb genau eine Basisadresse definiert werden.

Base Href wirkt auf URL-Angaben, die keinen vollständigen Ursprung aus Protokoll, Domain und Pfad enthalten. Dazu gehören unter anderem:

relative interne Links in <a href>
Pfade zu Bildern, Skripten und Stylesheets
relative Ziele von Formularen
relative Canonical- und Hreflang-URLs
Sprungmarken wie href="#kontakt"

Absolute URLs bleiben unverändert. Der Link https://www.example.com/kontakt/ wird daher nicht mit der Basisadresse kombiniert. Root-relative Pfade wie /kontakt/ übernehmen dagegen das Protokoll und die Domain der Basisadresse, beginnen aber am Stammverzeichnis dieser Domain.

Beispiel: Bei <base href="https://www.example.com/ratgeber/"> wird seo/ zu https://www.example.com/ratgeber/seo/. Der Pfad /seo/ wird dagegen zu https://www.example.com/seo/. Der führende Schrägstrich entscheidet somit darüber, ob das Unterverzeichnis ratgeber erhalten bleibt.

Base Href und relative URLs

Der häufigste Denkfehler besteht darin, Base Href als einfache Domainvorgabe zu behandeln. Die Basisadresse kann auch einen Pfad enthalten, und der abschließende Schrägstrich verändert das Ergebnis. Bei <base href="https://www.example.com/shop/"> bleibt shop als Verzeichnis erhalten. Bei <base href="https://www.example.com/shop"> interpretiert der Browser shop als letzten Pfadbestandteil und ersetzt ihn beim Auflösen von produkt. Das Ergebnis lautet dann https://www.example.com/produkt.

Basisadresse	Relativer Pfad	Aufgelöste URL
`https://example.com/shop/`	`produkt`	`https://example.com/shop/produkt`
`https://example.com/shop`	`produkt`	`https://example.com/produkt`
`https://example.com/shop/`	`/produkt`	`https://example.com/produkt`
`https://example.com/shop/`	`https://andere-domain.de/produkt`	`https://andere-domain.de/produkt`

SEO-Auswirkungen von Base Href

Base Href ist kein eigenständiger Ranking-Faktor. Eine fehlerhafte Basisadresse kann jedoch technische SEO-Signale verändern, weil Suchmaschinen relative URLs zunächst in vollständige Adressen umwandeln müssen. Zeigt die Basisadresse auf die falsche Domain oder das falsche Verzeichnis, können interne Links, Canonical Tags, Hreflang-Verweise und Ressourcen auf unerwartete Ziele führen.

Besonders kritisch sind relative Canonical-Angaben. Steht im Quellcode beispielsweise <link rel="canonical" href="/kategorie/">, bestimmt die Basisadresse, welche Domain der Browser und ein verarbeitendes System ergänzt. Base Href ersetzt jedoch kein Canonical Tag. Das Canonical Tag benennt die bevorzugte URL einer Seite, während die Basisadresse lediglich relative Pfade technisch auflöst.

Für das Crawling zählt das tatsächlich aufgelöste Linkziel. Eine falsche Basisadresse kann deshalb Links auf eine Testumgebung, eine andere Subdomain oder nicht vorhandene Verzeichnisse lenken. Prüfe nach Änderungen die vollständigen Zieladressen im gerenderten Dokument und führe eine technische SEO-Analyse durch. Bei einem Relaunch gehört die Kontrolle außerdem in die SEO-Checkliste für den Website-Relaunch.

Typische Fehler bei Base Href

Fehler entstehen meist durch einen fehlenden Schrägstrich, eine Basisadresse aus der Entwicklungsumgebung oder mehrere konkurrierende <base>-Elemente. Auch Sprungmarken verdienen Aufmerksamkeit: Bei einer externen Basisadresse kann href="#preise" als URL der Basisadresse mit angehängtem Fragment interpretiert werden, statt nur innerhalb der aktuellen Seite zu springen.

Die Basisadresse zeigt auf eine Staging-Domain oder ein altes Verzeichnis.
Der abschließende Schrägstrich fehlt und verändert die Pfadauflösung.
Canonical- oder Hreflang-Angaben verwenden unbemerkt die falsche Domain.
Relative Pfade für JavaScript, CSS oder Bilder führen zu 404-Fehlern.
Ein nachträglich eingefügtes zweites <base>-Element bleibt wirkungslos.

Ändere Base Href nie isoliert, wenn eine Webseite viele relative Pfade verwendet. Eine einzige Anpassung kann gleichzeitig Navigation, Bilder, Formulare, Skripte und SEO-Auszeichnungen auf neue Ziele lenken. Prüfe nach der Änderung mehrere Seitentypen, den Quellcode und die tatsächlich aufgelösten URLs.

Base Href in Single-Page-Anwendungen

Single-Page-Anwendungen verwenden Base Href häufig für das clientseitige Routing. Bei <base href="/"> beziehen sich Routen auf die Domainwurzel. Läuft eine Anwendung im Unterverzeichnis /app/, wird meist <base href="/app/"> benötigt. Eine Abweichung zwischen Hosting-Pfad und Basisadresse kann dazu führen, dass interne Navigation oder Ressourcen nach einem direkten Seitenaufruf nicht geladen werden.

Bei dynamischen Webseiten sollte Base Href deshalb mit Serverkonfiguration, Routing und der technischen Onpage-Optimierung abgestimmt sein. Für SEO zählt am Ende, ob Suchmaschinen jede relevante URL aufrufen, rendern und eindeutig zuordnen können. Die Basisadresse allein erzeugt weder Weiterleitungen noch Indexierungsregeln.

Base Href richtig prüfen

Eine zuverlässige Prüfung beginnt im <head> des HTML-Quellcodes. Kontrolliere anschließend im Browser, welche vollständigen Adressen aus Navigation, Bildern, Canonical Tags und Hreflang-Verweisen entstehen. Der Netzwerkbereich der Entwicklertools zeigt zusätzlich, ob Ressourcen von der vorgesehenen Domain geladen werden oder mit einem 404-Status antworten.

Für eine systematische Kontrolle solltest du mindestens folgende Seitentypen testen:

Startseite und Seiten in Unterverzeichnissen
Kategorie-, Produkt- oder Leistungsseiten
Seiten mit Canonical- und Hreflang-Angaben
Formulare und interne Sprungmarken
direkt aufgerufene Unterseiten einer Single-Page-Anwendung

Häufige Fragen zu Base Href

Ist Base Href in jeder HTML-Seite erforderlich?

Nein. Ohne ein base-Element verwendet der Browser die URL des aktuellen Dokuments als Ausgangspunkt für relative Pfade. Eine explizite Basisadresse ist nur erforderlich, wenn relative URLs bewusst von einer anderen Adresse aus aufgelöst werden sollen.

Darf eine Seite mehrere base-Elemente enthalten?

Im Dokument sollte nur ein base-Element mit href stehen. Browser berücksichtigen bei mehreren Angaben nur das erste href-Attribut, wodurch spätere Einträge keine verlässliche Wirkung haben.

Warum ist der Schrägstrich am Ende der Basisadresse wichtig?

Der abschließende Schrägstrich kennzeichnet den letzten Pfadbestandteil als Verzeichnis. Fehlt er, kann der Browser diesen Bestandteil beim Ergänzen eines relativen Pfades ersetzen.

Kann Base Href auf eine andere Domain zeigen?

Ja. Relative URLs werden dann anhand der externen Domain aufgelöst. Das kann beabsichtigt sein, sollte aber sorgfältig geprüft werden, weil interne Links, Ressourcen und relative SEO-Auszeichnungen betroffen sein können.

Verändert Base Href die URL in der Adresszeile?

Nein. Die Basisadresse ändert die aufgerufene Dokument-URL nicht automatisch. Sie beeinflusst zunächst nur die Auflösung relativer URL-Angaben innerhalb des Dokuments.

Kann ich trotz Base Href absolute URLs verwenden?

Ja. Vollständige URLs mit Protokoll und Domain werden nicht mit der Basisadresse kombiniert. Relative und absolute URLs können deshalb innerhalb desselben Dokuments verwendet werden.