Tokens

Tokens sind Platzhalter, die in der Page Editor HTML + CSS Komponente, im Alert Editor und im Overlay Editor für Text, HTML und Widgets genutzt werden können.

Syntax

Tokens werden mit doppelten geschweiften Klammern geschrieben:

{{creator.name}}

Beispiele:

• {{creator.name}}
• {{support.amount}}
• {{goal.main.title}}
• {{goal.by_name.new-microphone.progress_percent}}
• {{stream.latest_tipper}}
• {{stream.latest_tippers.items}}
• {{checkout.url}}
• {{checkout.button:Jetzt unterstützen}}

Creator

Creator Link Tokens

Creator-Link-Tokens greifen auf aktive Creator Links aus den Creator Links zu. Der Teil nach creator.link. ist kein fester einzelner Token, sondern ein Schlüssel.

Format:

{{creator.link.<linkname>}}

<linkname> kann der platformKey oder der Label-Slug des Links sein. KALYIX normalisiert den Wert als Slug, also klein geschrieben und mit - statt Leerzeichen.

Beispiele:

Wenn mehrere aktive Links denselben Key oder Label-Slug erzeugen, wird der erste passende aktive Link genutzt.

Für Details hängst du ein Feld an den Link-Key an:

{{creator.link.<linkname>.<field>}}

Verfügbare Felder:

{{creator.link_json}} enthält alle aktiven Links als JSON-Array:

[{ "name", "icon", "iconSource", "url" }]

{{creator.links.full}} gibt alle aktiven Links als Liste aus. In HTML wird daraus eine renderbare Link-Liste, in Text ein kompakter Text-Fallback.

Support

Goals

Main Goal

Goal by Name

Format:

{{goal.by_name.<slug>.<field>}}

Beispiel:

• Goal Titel: New Microphone
• Slug: new-microphone
• Token: {{goal.by_name.new-microphone.progress_percent}}

Felder wie bei goal.main.*:

• title
• name
• current_amount
• target_amount
• progress_percent

Public Overlay Tokens

Overlay Tokens sind für Public Overlays gedacht. KALYIX speichert die öffentliche Overlay-URL und bereitet die fertige OBS-Anzeige vor.

Aktueller Stand:

Stream Und Tip Listen

stream.latest_tippers.items ist für Listen-Komponenten gedacht:

[
  { "name": "Herbert", "amount": "5,00 €", "message": "GG", "interval": "one_time", "createdAt": "2026-06-01T16:00:00.000Z" },
  { "name": "Lisa", "amount": "10,00 €", "message": "", "interval": "one_time", "createdAt": "2026-06-01T16:05:00.000Z" }
]

Die Anzahl gehört zur Komponente, nicht in den Token-Namen. Nutze also keine dynamischen Tokens wie latest_tipper.amount.{count}. Im Overlay Editor setzt du stattdessen bei der Latest-Tippers-Komponente den Wert Anzahl.

Latest-Tippers-Listen nutzen bezahlte Tipps und werden neu berechnet, wenn du das Overlay speicherst.

Overlay Goal Tokens

Die Goal-Komponente nutzt dieselben Goal-Tokens wie Page und Alert:

Der Fortschrittsbalken im Overlay Editor berechnet daraus die Balkenbreite. In der Komponente kannst du außerdem steuern, ob Betrag von/bis oder Prozent angezeigt wird.

Public Overlay Regeln

Für Public Overlays gilt:

• Vorschauwerte aus dem Editor sind nur Beispiele.
• Unbekannte oder leere Werte sollen leer oder mit sicherem Fallback gerendert werden.
• Keine geheimen Zugangsdaten, privaten E-Mails oder rohen Stripe-/Twitch-/Discord-Daten in Public Tokens verwenden.

Checkout

Checkout Form Logic

Für formularartige Checkout-Flows gilt:

• {{checkout.value:3}}, {{checkout.value:5}}, …
• {{checkout.value.custom}}
• {{checkout.username}}
• {{checkout.message}}

Diese Tokens setzen nur den Checkout-Entwurf, öffnen aber nicht selbst den Checkout.

Der eigentliche Trigger ist:

• {{checkout.button}}

Das heißt:

• Value/User/Message-Tokens setzen Werte.
• checkout.button startet die Aktion.

Damit braucht es keinen separaten Submit-Token.

Hinweise:

• In HTML wird checkout.button als sicheres <a> gerendert.
• In Text wird ein Text-Fallback ausgegeben.

Sicherheit

• HTML wird sanitized.
• CSS wird gefiltert.
• Unbekannte Tokens bleiben unverändert stehen.