Makros in Confluence sind mächtige Funktionen, welche Sie verwenden können, um Funktionalität und Optik von Confluence-Inhalten aufs nächste Level zu heben. Die wohl nützlichsten und leider oft unterschätzten Makros sind „Page Properties” und „Page Properties Report”. Mit ihnen verwandeln Sie statische Confluence Seiten in dynamische Übersichtsseiten.
Hier erfahren Sie die Best Practices zur Erstellung!
Aktualisiert im August 2026: Atlassian hat die beiden Makros in Confluence Cloud umbenannt. Sie heißen dort jetzt Content Properties Makro und Content Properties Report Makro. Funktion und Aufbau sind gleich geblieben, in Confluence Data Center heißen sie weiterhin Page Properties. Dieser Artikel deckt beide Namen ab.
Das Page Properties Makro und das Page Properties Report Makro sind das perfekte Team, um statische Confluence Seiten in dynamische Übersichten zu verwandeln. Diese Anleitung zeigt Schritt für Schritt, wie Sie beide einrichten, welche Grenzen sie haben und wann stattdessen eine Confluence Datenbank die bessere Wahl ist.
Das Page Properties Makro in Confluence (zu deutsch: Seiteneigenschaften Makro) ermöglicht es, Metadaten zu einer Confluence Seite in Tabellenformat hinzuzufügen. Diese Metadaten können schließlich in einer übergeordneten Seite mit dem Page Properties Report Makro angezeigt werden. Dadurch transformieren Sie statische Seiten in automatisch aktualisierte Übersichten, welche Ihnen das Projektmanagement immens erleichtern. Diese beiden Makros entfalten also nur gemeinsam ihre volle Stärke.
Wer die Makros in Confluence Cloud über / sucht, findet sie inzwischen unter Content Properties und Content Properties Report. Atlassian hat den Namen angepasst, weil die Makros nicht mehr nur auf klassischen Seiten funktionieren, sondern auch auf Live Docs, Blogbeiträgen und Anhängen.
| Bisheriger Name, weiterhin in Data Center | Name in Confluence Cloud |
|---|---|
| Page Properties Makro (Seiteneigenschaften) | Content Properties Makro |
| Page Properties Report Makro | Content Properties Report Makro |
| Funktioniert auf Seiten | Funktioniert auf Seiten, Live Docs, Blogbeiträgen und Anhängen |
Für Sie ändert sich sonst nichts. Bestehende Makros auf Ihren Seiten laufen unverändert weiter, die Parameter sind dieselben, und in Confluence Data Center heißen beide Makros nach wie vor Page Properties. Suchen Sie im Cloud-Editor also nach dem neuen Namen, wenn Sie den alten nicht finden.
Sobald Sie in Confluence viele gemeinsame Informationen auf einer oder auf mehreren Seiten gespeichert haben und an einem Ort kompakt und dynamisch darstellen wollen, ist das Page Properties Makro das Richtige für Sie.
Das Zusammenspiel beider Makros könnte beispielsweise so aussehen:
Page Properties Makro auf einer untergeordneten Seite:
Page Properties Report Makro auf der Übersichtsseite:
Hier kommt die Best-Practice-Anleitung, wie Sie zu diesem Ergebnis gelangen.
Bedenken Sie, dass Sie zwei Schritte benötigen, um den dynamischen Bericht auf Ihrer Confluence Seite zu integrieren. Erstens müssen Sie das Page Properties Makro auf einer oder mehreren Seiten hinzufügen und zweitens die Informationen mittels Page Properties Report Makro abrufen.
1. Erstellen Sie als Erstes eine Confluence Seite mit einer Tabelle. In der linken Spalte der Tabelle fügen Sie die Überschriften hinzu, welche später auf der Indexseite zu sehen sein werden. Was hier jetzt vertikal gegliedert ist, wird später im Page Properties Report horizontal dargestellt werden. Wir beginnen mit dem Anwendungsfall des Projektmanagements und fügen Status, Stakeholder, Owner, Startdatum und Deadline eines Projektes hinzu.
Stellen Sie sicher, dass die Tabellenoption Header column ausgewählt ist. Sonst gibt es später Probleme bei der Darstellung im Page Properties Report. Wichtig dabei: Die Tabelle darf entweder eine Kopfzeile oder eine Kopfspalte haben, aber nicht beides. Das Report Makro liest pro Makro nur eine der beiden aus.
2. Danach erstellen Sie das Page Properties Makro und fügen Ihre Tabelle hier ein. Geben Sie dazu “/” auf der Confluence Seite ein, beginnen den Namen “Page Property” (in Cloud: “Content Properties”) zu tippen und wählen das entsprechende Makro aus, um die Tabelle einzufügen.
3. Optional können Sie an dieser Stelle diesem Makro eine ID vergeben. Das ist immer dann sinnvoll, wenn Sie mehrere Page Properties auf einer Seite haben. Vergeben Sie die ID konsequent gleich auf allen Seiten, die später im selben Report erscheinen sollen, denn das Report Makro akzeptiert genau eine ID.
4. Um Ihre Seite und Ihre Page Properties im Anschluss einfach zu finden und in die Indexseite zu implementieren, fügen Sie Ihrer Seite ein Label hinzu. Im Bearbeitungsmodus klicken Sie dazu oben rechts auf das Drei-Punkte-Menü … (More actions) und wählen Add labels. Tippen Sie den Labelnamen ein, klicken Sie ihn in der Vorschlagsliste an und veröffentlichen Sie die Seite. Der Screenshot zeigt noch das frühere Menü, das an dieser Stelle Optionen hieß.
Alternativ können Sie auch im Ansichtsmodus ein Label hinzufügen, indem Sie am unteren Ende der Seite auf Add label klicken, oder über das Symbol Details in der Aktionsleiste unten rechts und dort auf + neben Labels.
Da die Vorbereitung geschafft ist, können Sie Ihre Tabelle auf einer neuen Seite einfach mit dem Page Properties Report Makro einbetten.
Prinzipiell können Sie beliebig viele Page Properties Makros auf einer einzelnen Seite darstellen. Anhand vergebener Labels und IDs wählen Sie aus, was genau im Bericht erscheinen soll.
Die resultierende dynamische Tabelle sieht so aus:
3. Als Nächstes können Sie das Makro nach Ihren Anforderungen optimieren. Sie können unter anderem auswählen, welche Spalten in Ihrem Bericht angezeigt werden:
Dieser Screenshot zeigt den älteren Konfigurationsdialog, in dem alle Einstellungen sofort sichtbar waren. In Confluence Cloud liegen dieselben Optionen heute hinter More options, die Bedeutung von Spaltenauswahl und Anzahl hat sich nicht geändert. In Confluence Data Center sieht der Dialog weiterhin so aus.
Auch die Sortierung oder die Anzahl der Kommentare oder Likes einer Tabelle können Sie sich darstellen lassen. Entdecken Sie alle Möglichkeiten in Atlassians Guide.
Der Bericht verfügt automatisch über einen Link zur Confluence Seite, in der wir das Page Properties Makro beigefügt haben. Der große Vorteil ist, dass, sobald sich etwas in der Tabelle auf der Seite “Page Properties” ändert, die Änderungen automatisch im Bericht aktualisiert werden. So werden statische Tabellen zu dynamischen Management-Helfern und Sie verpassen niemals, wenn sich der Status eines Projektes ändert.
Für bessere Visualisierung Ihrer Inhalte können Sie auch Makros wie Status, Datum oder Erwähnungen in Ihre Liste einfügen, doch nur in der rechten Spalte. Schließlich wird die linke Spalte als Spaltenüberschrift im Report benutzt.
Das Ergebnis im Bericht sieht wie folgt aus:
Achten Sie aber darauf, nicht zu viele Makros in Ihre Tabelle zu integrieren. Ansonsten wird der Page Properties Report unübersichtlich.
Im Editor heißt das Makro inzwischen Content properties report (Page properties report), Atlassian führt also beide Namen nebeneinander. Der Konfigurationsdialog ist bewusst schlank: Add label(s) ist das einzige Pflichtfeld, darunter steht Space mit dem voreingestellten Chip Current space. Alles Weitere liegt hinter Add filter(s), die Spalten- und Anzahl-Einstellungen hinter More options.
Der Konfigurationsdialog des Makros in Confluence Cloud. Das Feld Space ist mit Current space vorbelegt, deshalb bleibt der Bericht ohne Zutun auf den aktuellen Bereich beschränkt.
Diese Filter stehen über Add filter(s) zur Verfügung:
| Filter | Was er liefert |
|---|---|
| Label (Pflicht) | Seiten, Live Docs, Blogbeiträge oder Anhänge mit diesen Labels. Mehrere Werte werden mit ODER verknüpft. |
| In space | Nur Inhalte aus den angegebenen Bereichen. |
| With ancestor | Alles, was im Seitenbaum unterhalb eines bestimmten Elements liegt. |
| With parent | Nur die direkten Unterseiten eines Elements. |
| Creator / Contributor | Erstellt beziehungsweise erstellt oder bearbeitet von bestimmten Personen. |
| Mentioning user | Inhalte, in denen bestimmte Personen erwähnt werden. |
| With title / Including text | Treffer im Titel beziehungsweise im Text. |
| Of type | Beschränkung auf Seiten, Live Docs, Blogs oder Anhänge. |
Über With ancestor lässt sich ein Report an den Seitenbaum hängen statt an ein Label. Das spart die Label-Pflege, wenn ohnehin alle Quellseiten unter einer gemeinsamen Elternseite liegen.
Wie bereits erwähnt, können Sie verschiedene Confluence Seiten gleichzeitig in einem Page Properties Report visualisieren. Das ist optimal, wenn Sie als Projektmanager*in mehrere Projekte verwalten und auf eine einfache Art und Weise einen schnellen Überblick erhalten wollen.
Aus dem:
Wird das:
Die meiste Zeit, die Teams mit diesen Makros verlieren, geht für Eigenschaften drauf, die nirgends dokumentiert erscheinen, bis man dagegen läuft. Das sind die wichtigsten.
| Eigenschaft | Was das bedeutet |
|---|---|
| Eine Kopfzeile oder eine Kopfspalte | Nicht beides in derselben Tabelle. Das Report Makro wertet pro Makro nur eine Richtung aus. |
| Genau eine ID pro Report | Mehrere Labels lassen sich per ODER verknüpfen, mehrere IDs nicht. |
| Keine Makros in der Kopfspalte | Die linke Spalte liefert die Spaltenüberschriften und muss reiner Text bleiben. |
| 30 Einträge pro Seite | 30 ist zugleich Standard und Maximum von „Max results per page“, darüber greift Paginierung. In Data Center liegt zusätzlich eine Obergrenze von 3.000 Seiten. |
| Neue Eigenschaft heißt: alle Seiten anfassen | Eine zusätzliche Zeile muss in jeder Quelltabelle ergänzt werden. Bei vielen Seiten wird das zur Fleißarbeit. |
Ein leerer Bericht hat fast immer eine von vier Ursachen. Prüfen Sie in dieser Reihenfolge:
Findet das Makro nichts, zeigt es schlicht No content found an. Erscheinen dagegen Zeilen, aber die Spalten sind leer oder verrutscht, liegt es an der Tabellenstruktur: Kopfzeile und Kopfspalte gleichzeitig aktiv, oder ein Makro in der linken Spalte.
Seit Confluence Cloud Datenbanken anbietet, stellt sich die Frage bei jedem neuen Anwendungsfall. Beide lösen ähnliche Aufgaben, aber nicht dieselbe.
| Page Properties | Datenbanken | |
|---|---|---|
| Wo die Daten liegen | Verteilt auf den einzelnen Seiten | Zentral in einem Objekt |
| Neue Eigenschaft ergänzen | Auf jeder Quellseite einzeln | Einmal als Spalte |
| Feldtypen | Freitext plus Makros | Echte Typen: Text, Zahl, Datum, Tags, Nutzer, Link und ein Jira-Feld, das Vorgänge dynamisch einbindet |
| Stärke | Jede Seite bleibt ein eigenständiges Dokument mit Kontext | Sortieren, filtern und pflegen an einer Stelle |
| Passt für | Meeting-Notizen, Projektsteckbriefe, Entscheidungslogs | Inventare, Asset-Listen, strukturierte Register |
Als Faustregel: Steht die Seite im Mittelpunkt und die Metadaten sind Beiwerk, bleiben Sie bei Page Properties. Stehen die Daten im Mittelpunkt und die Seite ist nur der Ort, an dem sie angezeigt werden, nehmen Sie eine Datenbank. Bestehende Page Properties müssen Sie deshalb nicht umbauen: Atlassian entwickelt das Makro weiter, wie die Umbenennung und die Unterstützung von Live Docs zeigen.
Die Benutzung der beiden Makros Page Properties und Page Properties Report erlaubt es Ihnen, wichtige Informationen übersichtlich und dynamisch darzustellen, was Ressourcen spart und generell Ihr Projektmanagement verbessern kann. Ferner helfen die beiden Makros,
Wenn Sie ohnehin viel mit Tabellen in Confluence arbeiten, lohnt ein Blick auf Confluence Tabellen filtern und Tabellen sortieren. Für wiederkehrende Seitenstrukturen sparen Templates viel Zeit, weil das Page Properties Makro dann schon an der richtigen Stelle sitzt.
Heißt das Makro jetzt Page Properties oder Content Properties? In Confluence Cloud Content Properties, in Confluence Data Center weiterhin Page Properties. Es ist dasselbe Makro, bestehende Seiten brauchen keine Anpassung.
Kann ein Report Seiten aus mehreren Bereichen anzeigen? Ja. Das Feld Space nimmt mehrere Bereiche auf und verknüpft sie mit ODER. Ab Werk steht dort allerdings nur Current space.
Warum fehlt eine Spalte im Bericht? Entweder ist sie unter „Columns to show“ nicht ausgewählt, oder die Zeile fehlt in der Quelltabelle dieser einen Seite. Der Report zeigt nur, was in den Quelltabellen tatsächlich steht.
Funktioniert das Makro auf Blogbeiträgen? Ja, in Confluence Cloud inzwischen auch auf Live Docs und Anhängen, sofern sie das passende Label tragen.
Wie viele Seiten kann ein Report anzeigen? 30 pro Seite, das ist gleichzeitig das Maximum der Einstellung „Max results per page“. Alles darüber landet in der Paginierung. In Data Center greift zusätzlich eine Obergrenze von 3.000 Seiten, die die Systemadministration über pagePropertiesReportContentRetrieverMaxResult ändern kann.
Unsere Best Practices haben Ihnen gezeigt, wie Sie Page Properties Makros in Confluence effizient integrieren, konfigurieren und nutzen. Wenn Sie regelmäßig mit einer großen Menge an strukturierten Daten arbeiten, sind diese Makros optimale Werkzeuge, um Ihre Effizienz zu steigern.
Doch jeder Anwendungsfall ist individuell und erfordert individuelle Unterstützung. Wenn Sie Ihre Confluence Struktur mit uns durchgehen wollen, kontaktieren Sie uns einfach. Das erste Gespräch ist unverbindlich und garantiert kostenfrei, und gemeinsam finden wir den wirtschaftlichsten Weg zu Ihrem Erfolg.
Kontaktieren Sie unsere Experten zur Beantwortung Ihrer individuellen Fragen.
Unverbindlich