# Der Portal Builder im Überblick

Source: https://help.epilot.cloud/de/portale/einstieg-in-portale/der-portal-builder-im-uberblick
Last updated: 2026-10-28

Im **Portal Builder** baust du dein Portal auf: Du legst Seiten an, fügst Blöcke hinzu, siehst das Ergebnis direkt in der Vorschau und passt alle Einstellungen an. Du brauchst dafür keine Programmierkenntnisse.

Dieser Artikel zeigt dir, wie der Portal Builder aufgebaut ist, welche Werkzeuge du in der Kopfzeile findest und wo du welche Einstellungen vornimmst.

***

## So funktioniert's [#so-funktionierts]

Du öffnest den Portal Builder, indem du unter **Konfiguration** > **Portale** auf die Karte eines Portals klickst. Der Portal Builder besteht aus drei Bereichen:

* **Seitenstruktur** (links): die aktuell geöffnete Seite mit allen Blöcken, gegliedert in **Kopfbereich**, **Hauptinhalt** und **Fußbereich**. Hier wählst du Blöcke aus, fügst über das Plus-Symbol neue hinzu und ordnest sie per Drag-and-drop neu an.

* **Vorschau** (Mitte): so sieht die Seite für deine Kunden aus. Der ausgewählte Block ist gestrichelt umrandet.

* **Eigenschaften** (rechts): die Einstellungen der Seite oder des ausgewählten Blocks, zum Beispiel Inhalt, Design und Sichtbarkeit. Unter **Verfügbare Daten** siehst du, auf welche Daten du an dieser Stelle zugreifen kannst, etwa **Kontakt** oder **Portal Zugang**.

<Screenshot src="https://help.epilot.cloud/img/confluence/a47aa7366f-portal-builder-01-aufbau.webp" alt="portal-builder-01-aufbau.png" width="1600" height="995" maxWidth="760" />

Ein Beispiel: Du möchtest auf der Startseite deines Portals eine Schnellaktion „Neue Lieferstelle anmelden“ ergänzen. Du öffnest die Seite *Übersicht*, klickst in der Seitenstruktur auf den Block **Schnellaktionen**, fügst eine weitere Schnellaktion hinzu und siehst sofort in der Vorschau, wie sie aussieht. Mit **Speichern** übernimmst du die Änderung.

## Die Kopfzeile [#die-kopfzeile]

In der Kopfzeile findest du links den Namen des Portals und rechts die wichtigsten Werkzeuge:

<Screenshot src="https://help.epilot.cloud/img/confluence/8abf2f9215-portal-builder-02-kopfzeile.webp" alt="portal-builder-02-kopfzeile.png" width="1476" height="112" maxWidth="760" />

* **Sprache** (EN/DE): erscheint, wenn dein Portal mehrere Sprachen anbietet. Damit wechselst du die Sprache, in der du Inhalte bearbeitest und in der Vorschau siehst.

* **Mobil- und Desktopansicht**: schaltet die Vorschau zwischen Smartphone- und Bildschirmbreite um. Prüfe deine Seiten in beiden Ansichten, denn viele Kunden nutzen das Portal auf dem Handy.

* **Als Nutzer anzeigen**: zeigt die Vorschau mit den Daten eines echten Portalnutzers, siehe unten.

* **Portal öffnen**: öffnet dein Portal in einem neuen Browser-Tab.

* **Zahnrad-Symbol**: öffnet die Portaleinstellungen.

* **Speichern**: speichert alle Änderungen. Daneben siehst du, wann zuletzt gespeichert wurde.

<Callout type="warning">
  **Wichtig**

  Änderungen an einem Live-Portal sind nach dem Speichern sofort für deine Kunden sichtbar. Größere Umbauten bereitest du deshalb besser in einer separaten Konfiguration vor, siehe [Portale verwalten](https://help.epilot.cloud/de/portale/einstieg-in-portale/portale-verwalten).
</Callout>

## Konfiguration [#konfiguration]

### Seite wechseln und Seiten finden [#seite-wechseln-und-seiten-finden]

1\. Klicke oben in der Seitenstruktur auf den Namen der aktuellen Seite. Es öffnet sich die Liste aller Seiten.

2\. Filtere die Liste bei Bedarf nach Seitentyp: **Alle**, **Privat**, **Details**, **Öffentlich**, **System** oder **Ausgeblendet**. Mit **Seite suchen** findest du eine Seite über ihren Namen.

3\. Klicke auf die gewünschte Seite, um sie zu öffnen. Über **Seite hinzufügen** legst du eine neue Seite an.

<Screenshot src="https://help.epilot.cloud/img/confluence/ec23616b0c-portal-builder-03-seitenauswahl.webp" alt="portal-builder-03-seitenauswahl.png" width="1600" height="900" maxWidth="760" />

Was die einzelnen Seitentypen bedeuten, liest du in [Seitentypen und Seiteneinstellungen](https://help.epilot.cloud/de/portale/seiten-und-blocke/seitentypen-und-seiteneinstellungen). Welche Blöcke es gibt, findest du in der [Blockübersicht](https://help.epilot.cloud/de/portale/seiten-und-blocke/blockubersicht).

### Portal aus Sicht eines Kunden prüfen [#portal-aus-sicht-eines-kunden-prüfen]

Im Portal Builder zeigt die Vorschau Platzhalter wie &#x2A;\{\{contact.first\_name}}* statt echter Werte. Mit **Als Nutzer anzeigen** siehst du dein Portal so, wie ein bestimmter Kunde es sieht, mit seinen Verträgen, Zählern und Dokumenten.

4\. Klicke in der Kopfzeile auf **Als Nutzer anzeigen**.

5\. Wähle unter **Portalbenutzer** einen Portalnutzer aus, zum Beispiel einen Testzugang.

<Screenshot src="https://help.epilot.cloud/img/confluence/f3c56a8aff-portal-builder-04-als-nutzer-anzeigen.webp" alt="portal-builder-04-als-nutzer-anzeigen.png" width="1120" height="500" maxWidth="760" />

6\. Hat der Nutzer mehrere Verträge oder Zähler, wähle zusätzlich aus, welchen du sehen möchtest. Die Vorschau zeigt jetzt die Daten dieses Nutzers.

7\. Möchtest du das Portal wie dieser Nutzer bedienen, klicke auf **Als dieser Nutzer öffnen**. Das Portal öffnet sich in einem neuen Tab und du bist dort als dieser Nutzer angemeldet. Mehr dazu in [Als Portalnutzer anmelden](https://help.epilot.cloud/de/portale/nutzerverwaltung-und-betrieb/als-portalnutzer-anmelden).

<Callout type="info">
  **Tipp**

  Lege dir einen eigenen Testkontakt mit Testzugang und realistischen Beispieldaten an, etwa einem Stromvertrag und einem Zähler. So prüfst du Änderungen, ohne die Daten echter Kunden zu öffnen.
</Callout>

### Fehler finden und beheben [#fehler-finden-und-beheben]

Ist ein Block unvollständig konfiguriert, zeigt der Portal Builder das an: neben dem Portalnamen mit der Gesamtzahl der Fehler, in der Seitenstruktur mit der Zahl der Fehler auf der aktuellen Seite.

8\. Klicke auf die Fehleranzeige neben dem Portalnamen. Links öffnet sich der **Hinweisbereich*&#x2A;. Er listet pro Seite alle ungültigen Blöcke auf. In Klammern steht die Sprache, in der etwas fehlt, zum Beispiel &#x2A;(en)* für Englisch.

<Screenshot src="https://help.epilot.cloud/img/confluence/69736f4c48-portal-builder-05-hinweisbereich.webp" alt="portal-builder-05-hinweisbereich.png" width="1600" height="995" maxWidth="760" />

9\. Kehre mit dem Pfeil oben im Hinweisbereich zur Seitenstruktur zurück, öffne die betroffene Seite und den genannten Block und ergänze die fehlenden Angaben, zum Beispiel den englischen Text.

### Portaleinstellungen öffnen [#portaleinstellungen-öffnen]

10\. Klicke in der Kopfzeile auf das Zahnrad-Symbol. Die Portaleinstellungen öffnen sich in einem Dialog.

<Screenshot src="https://help.epilot.cloud/img/confluence/196017edaa-portal-builder-06-einstellungen.webp" alt="portal-builder-06-einstellungen.png" width="1600" height="900" maxWidth="760" />

11\. Wähle links den Bereich, den du bearbeiten möchtest, und klicke nach deinen Änderungen auf **Speichern**. Diese Bereiche gibt es:

| Bereich                | Was du dort einstellst                                                                                                                 | Mehr dazu                                                                                                                              |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **Allgemeines**        | Portalname, Portal aktivieren, angebotene Sprachen, Selbstregistrierung, Standardbenutzer für Benachrichtigungen, aktivierte Entitäten | [Selbstregistrierung und Identifikatoren](https://help.epilot.cloud/de/portale/registrierung-login-und-sicherheit/selbstregistrierung-und-identifikatoren)      |
| **Design**             | Portal-Design und Layout                                                                                                               | [Design und Theme-Editor](https://help.epilot.cloud/de/portale/design-und-domain/design-und-theme-editor)                                                       |
| **Benachrichtigungen** | E-Mail-Vorlagen für Aktivierung, Einladung, Passwort und weitere Ereignisse                                                            | [E-Mail-Vorlagen für Portale](https://help.epilot.cloud/de/portale/benachrichtigungen-und-e-mails/e-mail-vorlagen-fur-portale)                                  |
| **Journey Aktionen**   | Journeys, die sich bei bestimmten Ereignissen automatisch öffnen, etwa nach der ersten Anmeldung                                       | [Journeys im Portal](https://help.epilot.cloud/de/portale/seiten-und-blocke/journeys-im-portal)                                                                 |
| **Regel**              | Regeln für Änderungen durch Kunden, etwa wie stark und wie oft sie Abschlag oder Zahlungsart ändern dürfen                             | [Abschläge, Zahlungen und Kontostand](https://help.epilot.cloud/de/portale/self-service-funktionen/abschlage-zahlungen-und-kontostand)                          |
| **Domain**             | epilot-Domain oder eigene Domain                                                                                                       | [Eigene Domain für dein Portal einrichten](https://help.epilot.cloud/de/portale/design-und-domain/eigene-domain-fur-dein-portal-einrichten)                     |
| **Sicherheit**         | Berechtigungen, Anmeldeverfahren, Passwortrichtlinie, Vertragszuordnung und weitere Schutzfunktionen                                   | [Sicherheitseinstellungen im Portal](https://help.epilot.cloud/de/portale/registrierung-login-und-sicherheit/sicherheitseinstellungen-im-portal)                |
| **SSO**                | Anmeldung über externe Anbieter                                                                                                        | [SSO für Portale einrichten](https://help.epilot.cloud/de/portale/registrierung-login-und-sicherheit/sso-fur-portale-einrichten)                                |
| **Erweiterungen**      | installierte Apps aus dem epilot Marketplace und welche App welche Funktion übernimmt                                                  | [Extensions und Custom Blocks](https://help.epilot.cloud/de/portale/erweiterungen/extensions-und-custom-blocks)                                                 |
| **Analyse**            | externe Analyse-Tools                                                                                                                  | [Portal-Analytics, Tracking und Cookie-Consent](https://help.epilot.cloud/de/portale/nutzerverwaltung-und-betrieb/portal-analytics-tracking-und-cookie-consent) |

## Häufige Fragen [#häufige-fragen]

**Warum sehe ich in der Vorschau Platzhalter statt echter Namen?**

Ohne ausgewählten Portalnutzer kennt die Vorschau keine Kundendaten und zeigt deshalb die Variablen, zum Beispiel &#x2A;\{\{contact.first\_name}}*. Wähle über **Als Nutzer anzeigen** einen Portalnutzer aus, um echte Werte zu sehen.

**Warum kann ich manche Blöcke nicht löschen?**

Blöcke mit Schloss-Symbol sind für die Funktion der Seite nötig, zum Beispiel das Anmeldeformular auf der Seite *Anmelden*. Sie sind fest mit der Seite verbunden und lassen sich nicht entfernen. Dasselbe gilt für Pflichtseiten wie *Anmelden* oder *Übersicht*.

**Kann mein Portal mit Fehlern im Hinweisbereich live sein?**

Ja, aber die betroffenen Blöcke werden womöglich nicht wie geplant angezeigt, etwa ohne englischen Text. Behebe die Fehler deshalb, bevor du größere Änderungen veröffentlichst.